Pool
공개 REST API

SOLOFURY API

무료 · 인증 불필요 · CORS 활성화 · rate-limit 친화적

BASE URL https://solofury.com

코인별 엔드포인트

SoloFury는 5개 SHA-256 코인에서 동일한 API를 제공합니다. base path는 코인마다 다릅니다 — BCH는 역사적 이유로 /api를 사용하고, 나머지는 /api-{coin}을 사용합니다.

코인Base pathStratum 포트
BTC/api-btc6060, 6061, 6062
BCH/api7070, 7071, 7072
BC2/api-bc28080, 8081, 8082
BCH2/api-bch28585, 8586, 8587
XEC/api-xec9090, 9091, 9092

Pool 통계

GET /api/pool

Pool 전체 통계: 총 hashrate(1m/1h/1d/7d 이동 평균), 연결된 miners, 발견한 블록, 현재 블록 높이, 네트워크 difficulty/hashrate, fee.

응답 예시
{
  "totalHashRate": 2780000000000000,         // H/s · current
  "totalHashRate1m": 2810000000000000,
  "totalHashRate1hr": 2750000000000000,
  "totalHashRate1d": 2640000000000000,
  "totalHashRate7d": 2420000000000000,
  "blockHeight": 948592,
  "networkDifficulty": 763004012345.6,
  "networkHashRate": 5060000000000000000,
  "totalMiners": 10,
  "blocksFound": […],                          // array of past block events
  "fee": 1                                       // percent
}

Pool 정보

GET /api/info

Pool 런타임 정보: 현재까지 best share, 수락/거부/stale/무효 shares, 효율, 가동 시간, stratum 포트, pool 식별자.

응답 예시
{
  "poolIdentifier": "BCH-Solo",
  "fee": 1,
  "stratumPort": 7070,
  "uptime": 8643215,                          // seconds
  "accepted": 142357821,
  "rejected": 12483,
  "stale": 8421,
  "invalid": 3,
  "efficiency": "99.99",
  "highScores": [{ "bestDifficulty": 2613000000000, "bestDifficultyUserAgent": "Antminer" }]
}

Pool 차트

GET /api/info/chart

Pool hashrate, 수락/거부/stale/무효 카운터, 네트워크 difficulty의 시계열. 대시보드 차트에서 사용. 기본값 24h, 최대 약 7일.

Query유형기본값설명
hoursinteger24윈도우 크기(시간, 5분 단위)
응답 예시(일부 생략)
[
  {
    "label": "01:25",
    "data": 2540000000000000,                  // hashrate · H/s
    "difficulty": 763004012345.6,
    "accepted": 142357821,
    "rejected": 12483,
    "stale": 8421,
    "invalid": 3
  },
  …                                                // 288 points for 24h window
]

Shares 통계

GET /api/shares

상세 shares 통계: 카운터, best share, 여러 구간의 초당 shares.

응답 예시
{
  "accepted": 142357821,
  "rejected": 12483,
  "stale": 8421,
  "invalid": 3,
  "duplicate": 0,
  "bestshare": 2613000000000,
  "efficiency": "99.99",
  "sharesPerSecond1m": 187.4,
  "sharesPerSecond5m": 182.1,
  "sharesPerSecond15m": 179.8,
  "sharesPerSecond1h": 175.2
}

네트워크 정보

GET /api/network

기반 노드에서 직접 가져온 실시간 블록체인 네트워크 데이터 — 블록 높이, difficulty, hashrate, mempool 크기, chain 식별자.

응답 예시
{
  "blocks": 948592,
  "difficulty": 763004012345.6,
  "networkhashps": 5060000000000000000,    // H/s
  "currentblockweight": 3998000,
  "currentblocktx": 2841,
  "pooledtx": 3142,
  "chain": "main",
  "warnings": ""
}

네트워크 기록

GET /api/network/history

네트워크 difficulty와 hashrate의 시계열. 기본값 24h, 최대 168h(7일).

Query유형기본값설명
hoursinteger168윈도우 크기(시간, 최대 168)

Client / Miner 정보

GET /api/client/{wallet_address}

주소별 miner 데이터: 연결된 workers, worker별 hashrate, shares 수, 달성한 best difficulty, 마지막 접속 타임스탬프.

Path유형설명
addressstringMiner 지갑 주소(BTC/BCH/BC2/BCH2/XEC 네이티브 형식)
응답 예시
{
  "bestDifficulty": 2613000000000,
  "sessionId": "a1b2c3d4...",
  "workers": [
    {
      "name": "S21Plus01",
      "hashRate": 276000000000000,           // H/s
      "bestDifficulty": 59870000000,
      "sessionId": "abc...",
      "lastSeen": "2026-05-08T00:42:00.000Z",
      "startTime": "2026-04-28T13:55:00.000Z"
    },
    …
  ]
}

Client 차트

GET /api/client/{wallet_address}/chart

Miner 단위 시계열: hashrate, 수락/거부/stale/무효 shares, difficulty. /api/info/chart와 동일한 구조이지만 단일 주소로 한정됩니다.

Path / Query유형기본값설명
addressstring—Miner 지갑 주소
hoursinteger24윈도우 크기(시간)

Miner별 기록은 해당 주소의 첫 연결부터 수집되므로, 더 긴 시간 구간은 데이터가 쌓이면서 점차 채워집니다.

Stratum 연결

Stratum V1로 ASIC를 SoloFury에 연결하세요. 전 세계 9개 지역으로 저지연 글로벌 라우팅.

🇺🇸
Atlanta
{coin}.solofury.com
🇩🇪
Frankfurt
eu-{coin}.solofury.com
🇯🇵
Tokyo
jp-{coin}.solofury.com
🇸🇬
Singapore
asia-{coin}.solofury.com
🇧🇷
São Paulo
lat-{coin}.solofury.com
🇺🇸
Seattle
pnw-{coin}.solofury.com
🇮🇱
Tel Aviv
me-{coin}.solofury.com
🇿🇦
Johannesburg
afr-{coin}.solofury.com
🇬🇧
London
uk-{coin}.solofury.com
Stratum URL · 5개 coin 전체 · 9개 지역 전체
// Host = [region]-[coin].solofury.com  (Atlanta has no region prefix)
// Regions: (none)=Atlanta · eu-=Frankfurt · jp-=Tokyo · asia-=Singapore
//          lat-=Sao Paulo · pnw-=Seattle · me-=Tel Aviv · afr-=Johannesburg · uk-=London
// Coins: bch · btc · bc2 · bch2 · xec
// Ports: BTC 6060-6062 · BCH 7070-7072 · BC2 8080-8082 · BCH2 8585-8587 · XEC 9090-9092

// Examples (3 ports per coin = failover)
stratum+tcp://btc.solofury.com:6060        // BTC · Atlanta
stratum+tcp://eu-bch.solofury.com:7070     // BCH · Frankfurt
stratum+tcp://jp-xec.solofury.com:9090     // XEC · Tokyo
stratum+tcp://asia-btc.solofury.com:6060   // BTC · Singapore
stratum+tcp://uk-bc2.solofury.com:8080     // BC2 · London

// Worker format
Username: YOUR_WALLET_ADDRESS.WORKER_NAME
Password: x

Rate 제한 및 참고

인증 불필요
모든 응답은 JSON
CORS 활성화 — 모든 origin에서 사용 가능
HTTPS 전용
합리적으로 사용하세요 — IP당 초당 1회 요청 권장
Pool fee: 모든 코인 1%
알고리즘: SHA-256
AsicBoost(version-rolling): 지원
Stratum 프로토콜: V1
KYC 없음, 가입 없음, 마이닝에 이메일 불필요

예제

Pool 통계 · 5개 코인 전체
# All 5 coin pools
curl -s https://solofury.com/api-btc/pool | jq .
curl -s https://solofury.com/api/pool      | jq .   # BCH (no suffix)
curl -s https://solofury.com/api-bc2/pool  | jq .
curl -s https://solofury.com/api-bch2/pool | jq .
curl -s https://solofury.com/api-xec/pool  | jq .

# Network info
curl -s https://solofury.com/api/network

# Per-miner stats
curl -s https://solofury.com/api/client/YOUR_WALLET_ADDRESS

# Time-series chart (24h, 5-min granularity)
curl -s "https://solofury.com/api/info/chart?hours=24"

통합

SoloFury의 API는 업계 관례를 따르며 표준 마이닝 도구와 호환됩니다.

MiningPoolStats
풀 목록 및 실시간 통계 애그리게이터
minerstat
ASIC 모니터링 및 profit-switching
WhatToMine
수익성 계산
Grafana
Prometheus exporter를 통한 맞춤 대시보드
Telegram / Discord bots
맞춤 모니터링 + 블록 발견 알림
SoloFury Telegram Bot
@SoloFuryBot — 공식 실시간 블록 알림