Public API

Free JSON API over the monitoring network. No key required at current rate limits; keyed tiers with higher limits are planned.

Endpoints

GET  /api/pools          all pools with status + reported stats
GET  /api/pools/{id}     one pool, including 48h history snapshots
GET  /api/chains         chains aggregated across Blockle pools
GET  /api/chains/{id}    one chain
GET  /api/stats          network summary
GET  /api/health         service health
GET  /api/chain          BLOCK chain snapshot (height, lanes, recent blocks)
GET  /api/mps/{solo|pplns}   live pool stats (MiningPoolStats-compatible)
GET  /api/explorer       emission totals by coin and algorithm
GET  /api/explorer/mints         recent mint events (full provenance)
GET  /api/explorer/mint/{hash}   one mint event

POST /api/register       register a pool  {name, chain, algorithm, stratum, pool_fee, website?}
                         → {pool_id, token}
POST /api/heartbeat      {pool_id, token, timestamp, pool_hashrate, miners, workers,
                          blocks_found, block_height, network_hashrate,
                          network_difficulty, shares_submitted, blocks:[{chain,height,hash}]}

Data honesty

Responses separate verified (heartbeat recency, stratum reachability probes) from operator_reported (hashrates, miner counts). Heartbeats are token-authenticated, schema- and range-validated, freshness-checked, and rate limited.