Live stats
Heads of all six chains in one call: tip, mempool and standard fee, refreshed about every 2 seconds.
# Live stats
`GET https://api.rarebl.com/open/stats/live` or `POST https://api.rarebl.com/open/stats/live`
One cheap call with the head of every chain: tip, mempool size and the current fee. Refreshed about every 2 seconds, so it is the one to poll.
**Rate class:** read (5 requests per second, burst 20, per IP). **Available since:** Open API v1.
## Request
Send the parameters as query parameters (GET) or as a JSON object (POST with `Content-Type: application/json`). They are identical either way. No API key is needed: `X-API-KEY` is reserved and ignored.
Example: `curl "https://api.rarebl.com/open/stats/live"`
## Parameters
This endpoint takes no parameters.
## Responses
### API200 (HTTP 200): OK
Heads of all six chains in the same order as Chains.
```json
{
"status": 1,
"code": "API200",
"message": "success",
"data": {
"serverTime": "2026-11-14T22:39:43Z",
"chains": [
{
"id": "btc",
"status": "ok",
"tip": {
"height": 975854,
"hash": "00000000000000000000ac4918a89711fb90ab487b7e21d02995f39d88a83b9c",
"time": "2026-11-14T22:25:13Z"
},
"mempool": {
"count": 70161,
"bytes": 25261120
},
"fee": {
"unit": "sat/vB",
"standard": "0.13"
},
"checkedAt": "2026-11-14T22:39:43Z"
},
{
"id": "ltc",
"status": "ok",
"tip": {
"height": 3213201,
"hash": "e7b72ef9f34b8f61b2b5dabec238088bf1198fe9779df88f5b1a87c8e3f276e7",
"time": "2026-11-14T22:38:19Z"
},
"mempool": {
"count": 172,
"bytes": 50642
},
"fee": {
"unit": "sat/vB",
"standard": "1"
},
"checkedAt": "2026-11-14T22:39:43Z"
},
{
"id": "bch",
"status": "ok",
"tip": {
"height": 977391,
"hash": "00000000000000000130fbfa0ec402f4fca4b414cdff8d264e4caa225c9ea81e",
"time": "2026-11-14T22:39:19Z"
},
"mempool": {
"count": 2,
"bytes": 1163
},
"fee": {
"unit": "sat/vB",
"standard": "1"
},
"checkedAt": "2026-11-14T22:39:43Z"
},
{
"id": "dash",
"status": "ok",
"tip": {
"height": 2572373,
"hash": "0000000000000008ef6f834cf172cb739f5542f0ad1f7103c9a22d65be56f064",
"time": "2026-11-14T22:37:02Z"
},
"mempool": {
"count": 26,
"bytes": 18576
},
"fee": {
"unit": "sat/vB",
"standard": "1"
},
"checkedAt": "2026-11-14T22:39:43Z"
},
{
"id": "eth",
"status": "lagging",
"tip": null,
"mempool": null,
"fee": null,
"checkedAt": "2026-11-14T22:39:43Z"
},
{
"id": "tron",
"status": "lagging",
"tip": {
"height": 88007289,
"hash": "00000000053ee279103116c09576a469acc68fe6ab27ffa89d3358ca59a3fc78",
"time": "2026-11-14T22:36:06Z"
},
"mempool": {
"count": 0,
"bytes": null
},
"fee": {
"unit": "sun",
"standard": "100"
},
"checkedAt": "2026-11-14T22:39:43Z"
}
]
},
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
| Field | Type | Description |
| --- | --- | --- |
| `data.serverTime` | string | When the reply was built (ISO 8601 UTC). |
| `data.chains[].id` | string | Chain id. |
| `data.chains[].status` | string | `ok`, `lagging` or `down`. Height 0 (syncing) shows as lagging with a null tip. |
| `data.chains[].tip` | object \| null | Latest block `{height, hash, time}`. |
| `data.chains[].mempool` | object \| null | `{count, bytes}`; null where the chain has no mempool view (ETH today). |
| `data.chains[].fee` | object \| null | `{unit, standard}` in the same unit as Gas oracle. |
| `data.chains[].checkedAt` | string | When the backend last asked this node (ISO 8601 UTC). |
### API429 (HTTP 429): Too Many Requests
Rate limited (5 requests per second per IP, burst 20). A `Retry-After` header says how long to wait, in seconds.
```json
{
"status": 0,
"code": "API429",
"message": "Too many requests. Please retry shortly.",
"data": null,
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
## Notes
- Each chain head is cached for at most about 2 seconds. A slow or down node never delays the others: that chain is reported `down` for a few seconds.
- Poll no faster than once per 2 seconds. Compare `tip.hash` between polls to detect a new block, then fetch only what you need.
- See [Data freshness](https://docs.rarebl.com/data-freshness) and the guide [Market data and fees](https://docs.rarebl.com/guides/market-data).