API
Public API
SoloLuck exposes its pool data over two unauthenticated, read-only endpoints — no key, no rate limit at current scale. Pool-stats trackers and block explorers are welcome to poll them directly. Everything below is what the website itself renders; nothing private is exposed.
GET /api/public
The full JSON the site renders. Try it: curl https://sololuck.io/api/public
| Field | Type | Description |
|---|---|---|
pool_name | string | Pool display name. |
fee_pct | int | Fee percent taken from a solved block (0 — SoloLuck is a true 0% pool). |
online | bool | Whether the pool and its Bitcoin node are up. |
hashrate | object | Pool hashrate over 1m, 5m, 1h, 1d as suffixed strings (K/M/G/T/P = ×10³…10¹⁵ H/s), e.g. 27.8T. |
miners | int | Distinct payout addresses currently mining. |
workers | int | Connected workers right now. |
bestshare | int | Best share difficulty the pool has ever seen. |
network | object | Bitcoin network difficulty, hashrate, subsidy. |
netinfo | object | Chain context: height, blocks to_halving / to_retarget, next subsidy. |
template | object | Current block template: height, next_height, tip_hash, tip_time, synced. |
payout | object | Current block reward breakdown: coinbasevalue, subsidy_sats, fees_sats, fee_pct. |
blocks | array | Blocks SoloLuck has solved (empty until the first block). |
stratum | object | Connection info: host, port_general. |
history | array | Rolling 24h samples: t (time), hr (hashrate), w (workers). |
generated_at | string | RFC 3339 UTC timestamp the snapshot was built, e.g. 2026-07-02T09:03:01Z. |
generated_at_unix | int | Same instant as Unix epoch seconds — use for staleness checks. |
schema_version | int | Public API schema version; bumped on breaking changes. |
split | object | Operator/community honesty split: workers_operator, workers_community, miners_operator, miners_community, hashrate_operator_ths. |
GET /pool/pool.status
The ckpool-native status feed (newline-delimited JSON), the format miningpoolstats and similar pool trackers recognise out of the box. curl https://sololuck.io/pool/pool.status
Per-address lookup
Any miner's live stats are at /users/<btc-address> (HTML) or /users/<btc-address>.json (JSON).
Block attribution
Blocks SoloLuck solves carry the coinbase tag /sololuck.io/. The pool is listed in the public bitcoin-data/mining-pools and mempool/mining-pools registries that explorers use to label blocks. See /verify and /proof to check our claims.