API of the pool
Public pool statistics. Read only: there are no write routes.
| Method | Endpoint |
|---|---|
| GET | /api/v1/pool |
| GET | /api/v1/blocks?page=0 |
| GET | /api/v1/payments?page=0 |
| GET | /api/v1/performance?range=day |
| GET | /api/v1/miners/{address} |
| GET | /api/v1/miners/{address}/payments?page=0 |
| GET | /api/v1/miners/{address}/performance?range=week |
| GET | /api/v1/miners/{address}/balancechanges?page=0 |
| GET | /api/v1/miners/{address}/earnings?page=0 |
| GET | /api/v1/status |
Two pools: add ?pool=eu or ?pool=us. Without it the first pool answers (EU), and the "pool" field of the response names the pool.
Request example
curl -s /api/v1/poolCopy the curl command into a terminal or use the full address in an HTTP client. The response is JSON; replace {address} with your miner's address.
{"data": [], "source": "pool", "pool": "eu", "cache_seconds": 20}The empty list illustrates the response format; it is not current pool data.
Limits
- 60 requests per minute per visitor behind a trusted proxy. Without configured proxy trust, the limit is shared.
- In-memory cache by route: pool summary, status and miner 20 s, balance changes 30 s, blocks, payments and charts 60 s, orphan count 10 minutes (the cache_seconds field names it). Identical concurrent requests share one upstream request; at most 2 requests go to each pool at once.
- Pages contain 20 records. page: 0–9999. range: day or week. Weekly charts use daily samples.
- null means no measurement, not zero. Money amounts are exact XMOR decimal strings (up to 8 places).
Errors
400 — invalid path, address or parameters; 405 — write methods are not supported; 429 — rate limit reached; wait for Retry-After; 502 / 503 — pool data unavailable.
This API cannot change payout thresholds. Use pl=N in the stratum password. Miner network addresses, node configuration and administrative routes are not published.