Pool API Reference
Free, read-only JSON API for everything this pool does — per-coin stats, blocks, payments, and per-wallet miner data. No API key, no signup. Build dashboards, bots, and monitors on it.
Endpoints
/api/v1/pools
Every coin on the pool — config (stratum URL, fee, payout scheme, min payout) plus live stats (pool/network hashrate, miners, difficulty, height, reward, block time, totals, blocks in 24h).
/api/v1/pools/{coin}
One coin, same object as the list. {coin} accepts the coin slug or ticker (ergo, vertcoin, grs, c64chain, raptoreum, pearl).
/api/v1/pools/{coin}/blocks?limit=25
Blocks the pool found, newest first — height, hash, finder address, reward, effort, status (pending/confirmed/orphaned), confirmation progress, explorer link. limit 1–100.
/api/v1/pools/{coin}/payments?limit=25
Payouts the pool sent, newest first — address, amount, transaction id, explorer link, time. limit 1–100.
/api/v1/pools/{coin}/miners/{address}
Per-wallet stats — online flag, current hashrate, per-worker breakdown, pending balance, total paid, blocks found. 404 JSON for unknown addresses.
Quick start
The coin object
| Field | Type | Description |
|---|---|---|
| coin / coinName / slug | string | ticker, display name, URL slug |
| algorithm | string | mining algorithm (e.g. RandomWOW) |
| synced | boolean | false while the coin's node/mirror is catching up — live fields are null then |
| stratumUrl | string | stratum+tcp:// connection URL |
| fee | number | pool fee in percent (0.0 = 0%) |
| feeType | string | payout scheme (PPLNS) |
| minPayout | number | minimum payout in coin units |
| hashrate / miners | number | current pool hashrate (H/s) and connected miners |
| networkHashrate / networkDifficulty | number | chain-wide values (H/s / difficulty units) |
| blockHeight / blockReward / blockTime | number | chain tip, reward (coin units), target seconds |
| totalBlocks / totalPaid | number | lifetime pool totals |
| blocks24h / lastBlockAt | number/ISO8601 | trailing-24h block count, last block time |
| updatedAt | ISO8601 | when this data was last mirrored |
▸ Units: hashrates in H/s, balances and rewards in coin units (not atomic), timestamps ISO 8601 UTC.
Rate limits, caching & errors
- 120 requests per minute per IP. Exceeding it returns HTTP 429 — back off and retry after a minute. A full catalog refresh is one call; per-coin pollers comfortably fit a 10–30 s interval.
- Responses carry Cache-Control: public, max-age=30 — data refreshes from the mining engines roughly every minute, so polling faster than 30 s only re-reads the cache.
- Errors are JSON: 404 {"error":"not found"} for unknown coins or wallet addresses with no shares. A coin mid-sync returns synced:false with null live fields instead of an error.
- The shape is versioned (/api/v1) and engine-independent — fields are additive within v1; nothing existing will be renamed or removed.
Point your rig at the pool first — your wallet address is your API key to the miner endpoints.