API Pool Solo Mining — endpoints REST

Endpoints por coin

A SoloFury oferece APIs idênticas em 6 coins SHA-256. O base path varia conforme a coin — BCH usa /api por razões históricas; as demais usam /api-{coin}.

Coin	Base path	Portas 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	—

Estatísticas do pool

GET /api/pool

Estatísticas de todo o pool: hashrate total (médias móveis 1m/1h/1d/7d), miners conectados, blocos encontrados, altura de bloco atual, difficulty/hashrate da rede, fee.

Resposta de exemplo

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

Info do pool

GET /api/info

Info de runtime do pool: melhor share até agora, shares aceitas/rejeitadas/stale/inválidas, eficiência, uptime, porta stratum, identificador do pool.

Resposta de exemplo

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

Gráfico do pool

GET /api/info/chart

Série temporal de hashrate do pool, contadores de aceitas/rejeitadas/stale/inválidas, difficulty da rede. Usada pelo gráfico do painel. Padrão 24h, máx. ~7 dias.

Query	Tipo	Padrão	Descrição
`hours`	integer	24	Tamanho da janela em horas (granularidade 5 min)

Resposta de exemplo (truncada)

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

Estatísticas de shares

GET /api/shares

Estatísticas detalhadas de shares: contadores, melhor share, shares por segundo em várias janelas.

Resposta de exemplo

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

Info de rede

GET /api/network

Dados de rede blockchain ao vivo obtidos diretamente do nó subjacente — altura de bloco, difficulty, hashrate, tamanho do mempool, identificador da chain.

Resposta de exemplo

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

Histórico de rede

GET /api/network/history

Série temporal de difficulty e hashrate da rede. Padrão 24h, máximo 168h (7 dias).

Query	Tipo	Padrão	Descrição
`hours`	integer	168	Tamanho da janela em horas (máx. 168)

Info de client / miner

GET /api/client/{wallet_address}

Dados do miner por endereço: workers conectados, hashrate por worker, contagens de shares, melhor difficulty alcançada, timestamp do último acesso.

Path	Tipo	Descrição
`address`	string	Endereço de wallet do miner (formato nativo BTC/BCH/BC2/BCH2/XEC/DGB)

Resposta de exemplo

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

Gráfico de client

GET /api/client/{wallet_address}/chart

Série temporal por miner: hashrate, shares aceitas/rejeitadas/stale/inválidas, difficulty. Mesma estrutura de /api/info/chart, mas limitada a um único endereço.

Path / Query	Tipo	Padrão	Descrição
`address`	string	—	Endereço de wallet do miner
`hours`	integer	24	Tamanho da janela em horas

O histórico por miner é registrado a partir da primeira conexão do endereço, então janelas de tempo mais longas vão sendo preenchidas gradualmente conforme os dados se acumulam.

Conexão Stratum

Conecte seu ASIC à SoloFury via Stratum V1 ou V2, com TLS em cada porta V1. 9 regiões no mundo para roteamento global de baixa latência.

🇺🇸

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

URLs Stratum · todas as 6 coins · todas as 9 regiões

// 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 limits e notas

Não requer autenticação

Todas as respostas em JSON

CORS habilitado — utilizável de qualquer origem

Somente HTTPS

Seja razoável — recomendado 1 requisição/segundo/IP

Fee do pool: 1% em todas as coins

Algoritmo: SHA-256

AsicBoost (version-rolling): Suportado

Stratum: V1 (sem criptografia e TLS, todas as coins) · V2 (BTC e BCH)

Sem KYC, sem cadastro, sem e-mail para minerar

A moeda é escolhida pelo prefixo do caminho, não por um parâmetro de consulta. Use /api-btc/, /api-bc2/, /api-bch2/, /api-xec/ ou /api-dgb/ — o caminho /api/ puro serve BCH. Consultar /api/client/:address com um endereço BTC devolve uma lista de workers vazia, não um erro.

Cada worker traz um campo protocol: "SV1" ou "SV2". Workers Stratum V2 também expõem channelCount e availableIn: "sv2".

A API de blocos retorna apenas blocos confirmados. Candidatos ficam pendentes até a verificação RPC e órfãos são excluídos — então um bloco pode aparecer alguns minutos depois de encontrado.

luck é pessoal, não de rodada do pool: zera apenas nos seus próprios blocos. Valores acima de 100% são variância legítima da mineração solo, não um erro.

As respostas passam por um cache stale-while-revalidate com fallback last-good por região. Os valores podem atrasar alguns segundos durante falhas das fontes — é intencional, para manter os números estáveis.

Exemplos

Estatísticas do pool · todas as 6 coins

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

Buscar estatísticas do pool de todas as coins em paralelo

// 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`);
}

Monitor do 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"]}%')

Integrações

A API da SoloFury segue as convenções do setor e é compatível com as ferramentas de mining padrão.

MiningPoolStats

Agregador de listagem de pools e estatísticas ao vivo

minerstat

Monitoramento de ASIC e profit-switching

WhatToMine

Cálculos de rentabilidade

Grafana

Painéis personalizados via exporter do Prometheus

Telegram / Discord bots

Monitoramento personalizado + notificações de bloco encontrado

SoloFury Telegram Bot

@SoloFuryBot — alertas oficiais de blocos ao vivo

SOLOFURY API

Endpoints por coin

Estatísticas do pool

Info do pool

Gráfico do pool

Estatísticas de shares

Info de rede

Histórico de rede

Info de client / miner

Gráfico de client

Conexão Stratum

Rate limits e notas

Exemplos

Integrações