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 运行信息：迄今最佳 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 统计：计数、最佳 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 计数、达到的最佳 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——可从任意来源使用
仅限 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 — 官方实时区块提醒