Documentación de la API de SoloFury — endpoints REST para estadísticas del pool de solo mining

Endpoints por coin

SoloFury ofrece APIs idénticas en 5 coins SHA-256. El base path varía según la coin — BCH usa /api por razones históricas; las demás usan /api-{coin}.

Coin	Base path	Puertos 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

Estadísticas del pool

GET /api/pool

Estadísticas de todo el pool: hashrate total (medias móviles 1m/1h/1d/7d), miners conectados, bloques encontrados, altura de bloque actual, difficulty/hashrate de red, fee.

Respuesta de ejemplo

{
  "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 del pool

GET /api/info

Info de runtime del pool: mejor share hasta ahora, shares aceptadas/rechazadas/stale/inválidas, eficiencia, uptime, puerto stratum, identificador del pool.

Respuesta de ejemplo

{
  "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 del pool

GET /api/info/chart

Serie temporal de hashrate del pool, contadores de aceptadas/rechazadas/stale/inválidas, difficulty de red. Usada por el gráfico del panel. Por defecto 24h, máx. ~7 días.

Query	Tipo	Por defecto	Descripción
`hours`	integer	24	Tamaño de ventana en horas (granularidad 5 min)

Respuesta de ejemplo (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
]

Estadísticas de shares

GET /api/shares

Estadísticas detalladas de shares: contadores, mejor share, shares por segundo en varias ventanas.

Respuesta de ejemplo

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

GET /api/network

Datos de red blockchain en vivo obtenidos directamente del nodo subyacente — altura de bloque, difficulty, hashrate, tamaño del mempool, identificador de la chain.

Respuesta de ejemplo

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

Historial de red

GET /api/network/history

Serie temporal de difficulty y hashrate de red. Por defecto 24h, máximo 168h (7 días).

Query	Tipo	Por defecto	Descripción
`hours`	integer	168	Tamaño de ventana en horas (máx. 168)

Info de client / miner

GET /api/client/{wallet_address}

Datos del miner por dirección: workers conectados, hashrate por worker, recuentos de shares, mejor difficulty alcanzada, marca de tiempo de última conexión.

Path	Tipo	Descripción
`address`	string	Dirección de wallet del miner (formato nativo BTC/BCH/BC2/BCH2/XEC)

Respuesta de ejemplo

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

Gráfico de client

GET /api/client/{wallet_address}/chart

Serie temporal por miner: hashrate, shares aceptadas/rechazadas/stale/inválidas, difficulty. Misma estructura que /api/info/chart pero limitada a una sola dirección.

Path / Query	Tipo	Por defecto	Descripción
`address`	string	—	Dirección de wallet del miner
`hours`	integer	24	Tamaño de ventana en horas

El historial por miner se registra desde la primera conexión de la dirección, por lo que las ventanas de tiempo más largas se van rellenando gradualmente a medida que se acumulan datos.

Conexión Stratum

Conecta tu ASIC a SoloFury vía Stratum V1. 9 regiones en el mundo para un enrutamiento global de baja latencia.

🇺🇸

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 · las 5 coins · las 9 regiones

// 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 y notas

No requiere autenticación

Todas las respuestas en JSON

CORS habilitado — usable desde cualquier origen

Solo HTTPS

Sé razonable — recomendado 1 petición/segundo/IP

Fee del pool: 1% en todas las coins

Algoritmo: SHA-256

AsicBoost (version-rolling): Compatible

Protocolo Stratum: V1

Sin KYC, sin registro, sin email para minar

Ejemplos

Estadísticas del pool · las 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"

Obtener estadísticas del pool de todas las coins en paralelo

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

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

Integraciones

La API de SoloFury sigue las convenciones del sector y es compatible con las herramientas de mining estándar.

MiningPoolStats

Agregador de listados de pools y estadísticas en vivo

minerstat

Monitorización de ASIC y profit-switching

WhatToMine

Cálculos de rentabilidad

Grafana

Paneles personalizados vía exporter de Prometheus

Telegram / Discord bots

Monitorización personalizada + notificaciones de bloque encontrado

SoloFury Telegram Bot

@SoloFuryBot — alertas oficiales de bloques en vivo

SOLOFURY API

Endpoints por coin

Estadísticas del pool

Info del pool

Gráfico del pool

Estadísticas de shares

Info de red

Historial de red

Info de client / miner

Gráfico de client

Conexión Stratum

Rate limits y notas

Ejemplos

Integraciones