Documentation de l'API SoloFury — endpoints REST pour les statistiques du pool de solo mining

Endpoints par coin

SoloFury propose des API identiques sur 5 coins SHA-256. Le base path varie selon la coin — BCH utilise /api pour des raisons historiques ; les autres utilisent /api-{coin}.

Coin	Base path	Ports stratum
BTC	`/api-btc`	6060, 6061, 6062
BCH	`/api`	7070, 7071, 7072
BC2	`/api-bc2`	8080, 8081, 8082
BCH2	`/api-bch2`	8585, 8586, 8587
XEC	`/api-xec`	9090, 9091, 9092

Statistiques du pool

GET /api/pool

Statistiques de l'ensemble du pool : hashrate total (moyennes glissantes 1m/1h/1d/7d), miners connectés, blocs trouvés, hauteur de bloc actuelle, difficulty/hashrate du réseau, fee.

Réponse d'exemple

{
  "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
}

Infos du pool

GET /api/info

Infos d'exécution du pool : meilleure share à ce jour, shares acceptées/rejetées/stale/invalides, efficacité, uptime, port stratum, identifiant du pool.

Réponse d'exemple

{
  "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" }]
}

Graphique du pool

GET /api/info/chart

Série temporelle du hashrate du pool, des compteurs acceptées/rejetées/stale/invalides et de la difficulty réseau. Utilisée par le graphique du tableau de bord. Par défaut 24h, max ~7 jours.

Query	Type	Défaut	Description
`hours`	integer	24	Taille de fenêtre en heures (granularité 5 min)

Réponse d'exemple (tronquée)

[
  {
    "label": "01:25",
    "data": 2540000000000000,                  // hashrate · H/s
    "difficulty": 763004012345.6,
    "accepted": 142357821,
    "rejected": 12483,
    "stale": 8421,
    "invalid": 3
  },
  …                                                // 288 points for 24h window
]

Statistiques des shares

GET /api/shares

Statistiques détaillées des shares : compteurs, meilleure share, shares par seconde sur plusieurs fenêtres.

Réponse d'exemple

{
  "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
}

Infos réseau

GET /api/network

Données réseau blockchain en direct récupérées directement depuis le nœud sous-jacent — hauteur de bloc, difficulty, hashrate, taille du mempool, identifiant de la chain.

Réponse d'exemple

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

Historique réseau

GET /api/network/history

Série temporelle de la difficulty et du hashrate réseau. Par défaut 24h, maximum 168h (7 jours).

Query	Type	Défaut	Description
`hours`	integer	168	Taille de fenêtre en heures (max 168)

Infos client / miner

GET /api/client/{wallet_address}

Données du miner par adresse : workers connectés, hashrate par worker, comptes de shares, meilleure difficulty atteinte, horodatage de dernière activité.

Path	Type	Description
`address`	string	Adresse de wallet du miner (format natif BTC/BCH/BC2/BCH2/XEC)

Réponse d'exemple

{
  "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"
    },
    …
  ]
}

Graphique client

GET /api/client/{wallet_address}/chart

Série temporelle par miner : hashrate, shares acceptées/rejetées/stale/invalides, difficulty. Même structure que /api/info/chart mais limitée à une seule adresse.

Path / Query	Type	Défaut	Description
`address`	string	—	Adresse de wallet du miner
`hours`	integer	24	Taille de fenêtre en heures

L'historique par miner est enregistré dès la première connexion de l'adresse ; les fenêtres de temps plus longues se remplissent donc progressivement à mesure que les données s'accumulent.

Connexion Stratum

Connectez votre ASIC à SoloFury via Stratum V1. 9 régions dans le monde pour un routage global à faible latence.

🇺🇸

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

URLs Stratum · les 5 coins · les 9 régions

// 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 limits et notes

Aucune authentification requise

Toutes les réponses en JSON

CORS activé — utilisable depuis n'importe quelle origine

HTTPS uniquement

Soyez raisonnable — 1 requête/seconde/IP recommandé

Fee du pool : 1% sur toutes les coins

Algorithme : SHA-256

AsicBoost (version-rolling) : Pris en charge

Protocole Stratum : V1

Pas de KYC, pas d'inscription, pas d'e-mail pour miner

Exemples

Statistiques du pool · les 5 coins

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

Récupérer les statistiques du pool de toutes les coins en parallèle

// Browser or Node.js (with fetch polyfill)
const coins = ['-btc', '', '-bc2', '-bch2', '-xec'];
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'][i];
  console.log(`${coin}: ${(p.totalHashRate/1e12).toFixed(1)} TH/s · ${p.totalMiners} miners · ${p.fee}% fee`);
}

Moniteur du 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']:
    s = pool_stats(coin)
    th = s['totalHashRate'] / 1e12
    print(f'{coin.upper():<5} {th:.1f} TH/s · {s["totalMiners"]} miners · fee {s["fee"]}%')

Intégrations

L'API de SoloFury suit les conventions du secteur et est compatible avec les outils de mining standard.

MiningPoolStats

Agrégateur de listings de pools et de statistiques en direct

minerstat

Surveillance ASIC et profit-switching

WhatToMine

Calculs de rentabilité

Grafana

Tableaux de bord personnalisés via l'exporter Prometheus

Telegram / Discord bots

Surveillance personnalisée + notifications de bloc trouvé

SoloFury Telegram Bot

@SoloFuryBot — alertes officielles de blocs en direct

SOLOFURY API

Endpoints par coin

Statistiques du pool

Infos du pool

Graphique du pool

Statistiques des shares

Infos réseau

Historique réseau

Infos client / miner

Graphique client

Connexion Stratum

Rate limits et notes

Exemples

Intégrations