// developer reference

Pool API

Every TRACE mining pool exposes a public, read-only JSON API. Query live hashrate, network share, block height, payouts and sync state — no key, no auth. Build monitors, bots and dashboards straight on top of the network.

GET · JSON read-only no auth times in UTC (unix seconds) updated

One call, all pools[ aggregate ]

Network aggregate

hub Live
GET https://www.tracethesignal.com/api/pools

Single same-origin endpoint returning the online state and headline metrics of every pool at once. This is what powers the front-page tiles. Best starting point.

Response fields
fielddescription
total_poolsNumber of pools tracked.
<pool>.onlineBoolean — is the pool reachable & synced.
<pool>.pool_hashrate / hashratePool hashrate in H/s.
<pool>.network_hashrate / nethashEstimated network hashrate in H/s.
<pool>.blocks_found / blocksBlocks the pool has found.
<pool>.active_miners / workersCurrently connected miners.

Per-pool endpoints[ pools ]

Midstate

BLAKE3 sequential-VDF · PPLNS
GET https://midstate.tracethesignal.com/api/stats

Full pool + node state: hashrate, network share, blocks, payout schedule and sync status.

Response fields
fielddescription
pool_hashratePool hashrate (H/s).
network_hashrateNetwork hashrate estimate (H/s).
network_share_pctPool's share of the network (%).
miners / active_minersKnown / currently active miners.
blocks_foundBlocks found by the pool.
node_height · tip_hash · syncedNode chain tip height, hash and sync flag.
pool_fee_pct · dev_fee_pctFee split applied to rewards.
payout_every_secs · payout_thresholdPayout cadence and minimum.
total_paid · total_owedLifetime paid and currently owed (atomic units).
model · tsReward model, and UTC unix timestamp of the snapshot.

Zoka

ZKA · stratum 151.240.19.40:3344
GET https://zoka.tracethesignal.com/api/state

Node & pool sync state: chain height, public-node cross-check, peer count and stratum endpoint.

Response fields
fielddescription
node_height · public_heightLocal vs public-node chain height.
public_hash · public_okPublic tip hash and cross-check flag.
sync_lag · sync_statusBlocks behind and human-readable sync state.
connected_peers · network_modeP2P peers and networking mode.
public_stratum · public_rpcPublic stratum / RPC endpoints.
pool_addressPool coinbase address.

BTX

Matmul PoW · stratum :3333
GET https://btx.tracethesignal.com/api/stats

Chain, pool, wallet balance, payout, workers and blocks. Endpoint returns data only while the BTX pool service is running — check the status badge above.

Response fields
fielddescription
chain · poolChain tip and pool summary.
wallet.balancePool wallet balance.
payout · workers · blocksPayout state, connected workers, blocks found.

Usage[ notes ]

Quick start — everything is a plain GET returning JSON:

Conventions — read-only, no key required. Hashrates are in H/s, amounts in each coin's atomic units, and all timestamps are UTC unix seconds. Please poll no faster than once every 10 seconds; snapshots refresh on that order. Fields may be added over time — treat unknown keys as forward-compatible and don't hard-fail on them.