ソロマイニングプール API

コイン別エンドポイント

SoloFury は 6 つの SHA-256 コインで同一の API を提供します。base path はコインごとに異なります — BCH は歴史的な理由で /api を使用し、その他は /api-{coin} を使用します。

コイン	Base path	Stratum ポート	TLS	Stratum V2
BTC	`/api-btc`	6060, 6061, 6062	16060, 16061, 16062	3333, 3343
BCH	`/api`	7070, 7071, 7072	17070, 17071, 17072	7333, 7343
BC2	`/api-bc2`	8080, 8081, 8082	18080, 18081, 18082	—
BCH2	`/api-bch2`	8585, 8586, 8587	18585, 18586, 18587	—
XEC	`/api-xec`	9090, 9091, 9092	19090, 19091, 19092	—
DGB	`/api-dgb`	5050, 5051, 5052	15050, 15051, 15052	—

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	型	デフォルト	説明
`hours`	integer	24	ウィンドウ幅（時間、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	型	デフォルト	説明
`hours`	integer	168	ウィンドウ幅（時間、最大 168）

Client / Miner 情報

GET /api/client/{wallet_address}

アドレス単位の miner データ：接続中の workers、worker ごとの hashrate、shares 数、達成したベスト difficulty、最終接続のタイムスタンプ。

Path	型	説明
`address`	string	Miner ウォレットアドレス（BTC/BCH/BC2/BCH2/XEC/DGB ネイティブ形式）

レスポンス例

{
  "bestDifficulty": 2613000000000,
  "sessionId": "a1b2c3d4...",
  "workers": [
    {
      "name": "S21Plus01",
      "hashRate": 276000000000000,           // H/s
      "protocol": "SV2",                      // "SV1" | "SV2"
      "availableIn": "sv2",                   // "sv2" | "ckpool"
      "channelCount": 1,                      // SV2 only
      "currentDiff": 2048,
      "region": "eu",
      "regionSourceName": "Frankfurt SV2",
      "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	型	デフォルト	説明
`address`	string	—	Miner ウォレットアドレス
`hours`	integer	24	ウィンドウ幅（時間）

Miner ごとの履歴はアドレスの初回接続時から記録されるため、長い時間枠はデータの蓄積に応じて徐々に埋まっていきます。

Stratum 接続

Stratum V1 または V2 で ASIC を SoloFury に接続します。すべての V1 ポートで TLS に対応。世界9リージョンによる低遅延のグローバルルーティング。

🇺🇸

Atlanta

{coin} · us-{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 · 全 6 coin · 全 9 リージョン

// Host = [region]-[coin].solofury.com
// Regions: us- or none=Atlanta · eu-=Frankfurt · jp-=Tokyo · asia-=Singapore
//          lat-=Sao Paulo · pnw-=Seattle · me-=Tel Aviv · afr-=Johannesburg · uk-=London
// Coins: btc · bch · bc2 · bch2 · xec · dgb   (dgb = DigiByte, SHA-256 algorithm)
// Ports: BTC 6060-6062 · BCH 7070-7072 · BC2 8080-8082 · BCH2 8585-8587 · XEC 9090-9092 · DGB 5050-5052
// TLS:   same host, port + 10000 (e.g. BCH 7070 → 17070), with stratum+tls://

// Examples (3 ports per coin = failover)
stratum+tcp://btc.solofury.com:6060        // BTC · Atlanta (us-btc.solofury.com also works)
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
stratum+tcp://lat-bch2.solofury.com:8585   // BCH2 · Sao Paulo
stratum+tcp://pnw-dgb.solofury.com:5050    // DGB · Seattle
stratum+tls://eu-bch.solofury.com:17070    // BCH · Frankfurt · TLS

// Worker format
Username: YOUR_WALLET_ADDRESS.WORKER_NAME  // an address of the coin you mine
Password: x

// ── Stratum V2 (BTC and BCH) ──────────────────────────────────────
// Same hosts as V1, dedicated ports, all 9 regions.
// BTC: 3333 (standard) · 3343 (high-difficulty, S21/S23 class)
// BCH: 7333 (standard) · 7343 (high-difficulty) · extended channel

// AxeOS 2.14+ / NerdQAxe 1.0.37+: select Stratum V2 in the pool settings,
// then enter host and port only, without a URL prefix
Host: eu-btc.solofury.com   Port: 3333
Host: eu-bch.solofury.com   Port: 7333

// Braiins OS / Braiins OS+: full URL, authority key in the path
stratum2+tcp://eu-btc.solofury.com:3333/9cLif4sCxvAz7FBP7GPvYG8Mv586ZhdgNbn3f4PsrM56gboSZEp
stratum2+tcp://eu-bch.solofury.com:7333/9c5s3n4RzRrDhzMBr3iSJsUfreSLPGiHkQyyzJjYAVWK9YWaZf7

// Authority public keys (verify you are talking to SoloFury)
BTC  9cLif4sCxvAz7FBP7GPvYG8Mv586ZhdgNbn3f4PsrM56gboSZEp
BCH  9c5s3n4RzRrDhzMBr3iSJsUfreSLPGiHkQyyzJjYAVWK9YWaZf7

Rate 制限と注意事項

認証不要

すべてのレスポンスは JSON

CORS 有効 — 任意のオリジンから利用可能

HTTPS のみ

節度ある利用を — 1 IP あたり毎秒 1 リクエスト推奨

Pool fee：全コイン 1%

アルゴリズム：SHA-256

AsicBoost（version-rolling）：対応

Stratum：V1（平文と TLS、全コイン）· V2（BTC と BCH）

KYC 不要、登録不要、マイニングにメール不要

通貨はパスの接頭辞で選びます。クエリパラメータではありません。/api-btc/、/api-bc2/、/api-bch2/、/api-xec/、/api-dgb/ を使ってください。接頭辞なしの /api/ は BCH を返します。BTC アドレスで /api/client/:address を叩くと、エラーではなく空のワーカー一覧が返ります。

各ワーカーには protocol フィールドがあります："SV1" または "SV2"。Stratum V2 のワーカーは channelCount と availableIn: "sv2" も返します。

ブロック API は確定済みブロックのみを返します。候補は RPC 検証まで pending のまま保持され、孤立ブロックは除外されます。そのため発見から数分後に現れることがあります。

luck は個人のものであり、プールのラウンド単位ではありません。自分のブロックでのみリセットされます。100% を超える値はソロマイニングの正当なばらつきであり、不具合ではありません。

応答は stale-while-revalidate キャッシュを経由し、リージョンごとの last-good フォールバックを備えます。ソースの乱れがあると値が数秒遅れることがありますが、数値を安定させるための設計です。

例

Pool 統計 · 全 6 コイン

# All 6 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 .
curl -s https://solofury.com/api-dgb/pool  | jq .   # DigiByte (SHA-256)

# 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"

全コインの pool 統計を並列取得

// Browser or Node.js (with fetch polyfill)
const coins = ['-btc', '', '-bc2', '-bch2', '-xec', '-dgb'];
const stats = await Promise.all(
  coins.map(c => fetch(`https://solofury.com/api${c}/pool`).then(r => r.json()))
);

for (const [i, p] of stats.entries()) {
  const coin = ['BTC', 'BCH', 'BC2', 'BCH2', 'XEC', 'DGB'][i];
  console.log(`${coin}: ${(p.totalHashRate/1e12).toFixed(1)} TH/s · ${p.totalMiners} miners · ${p.fee}% fee`);
}

Pool モニター

import requests

def pool_stats(coin=''):
    suffix = '' if coin == 'bch' else f'-{coin}'
    r = requests.get(f'https://solofury.com/api{suffix}/pool', timeout=5)
    return r.json()

for coin in ['btc', 'bch', 'bc2', 'bch2', 'xec', 'dgb']:
    s = pool_stats(coin)
    th = s['totalHashRate'] / 1e12
    print(f'{coin.upper():<5} {th:.1f} TH/s · {s["totalMiners"]} miners · fee {s["fee"]}%')

連携

SoloFury の API は業界の慣例に従っており、標準的なマイニングツールと互換性があります。

MiningPoolStats

プール一覧とライブ統計のアグリゲーター

minerstat

ASIC モニタリングと profit-switching

WhatToMine

収益性の計算

Grafana

Prometheus exporter によるカスタムダッシュボード

Telegram / Discord bots

カスタム監視 + ブロック発見通知

SoloFury Telegram Bot

@SoloFuryBot — 公式のライブブロックアラート

SOLOFURY API

コイン別エンドポイント

Pool 統計

Pool 情報

Pool チャート

Shares 統計

ネットワーク情報

ネットワーク履歴

Client / Miner 情報

Client チャート

Stratum 接続

Rate 制限と注意事項

例

連携