Latest blocks
List the newest blocks of a chain with a before-cursor for older blocks.
# Latest blocks
`GET https://api.rarebl.com/open/block/latest` or `POST https://api.rarebl.com/open/block/latest`
The newest blocks of a chain, newest first, with a cursor to page back in time.
**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/block/latest?chain=btc&limit=2"`
## Parameters
| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `chain` | string | Yes | The chain to query. One of: btc, ltc, bch, dash, eth, tron. |
| `before` | integer | No | Return blocks below this height (exclusive). Pass the previous reply's `next`. Block height, 0 or higher. |
| `limit` | integer | No | Number of blocks to return. 1 to 25 (larger values are capped at 25) Default 10. |
## Responses
### API200 (HTTP 200): OK
A page of block summaries.
```json
{
"status": 1,
"code": "API200",
"message": "success",
"data": {
"items": [
{
"height": 975852,
"hash": "0000000000000000000106d2c49ad20a447077c0ee2a8000a0bf7dca0df81fc5",
"time": "2026-11-14T22:21:59Z",
"txCount": 2749,
"size": 1630627,
"miner": "32i1m6gNcSHwiPX9nfTNXVjme9j5DU8y5g",
"reward": "3.14466985",
"fees": "0.01966985"
},
{
"height": 975851,
"hash": "0000000000000000000019616694441cd8af0ea40612fea00423994106ff3339",
"time": "2026-11-14T22:18:52Z",
"txCount": 3914,
"size": 1553016,
"miner": "1K6KoYC69NnafWJ7YgtrpwJxBLiijWqwa6",
"reward": "3.17394194",
"fees": "0.04894194"
}
],
"next": 975851
},
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
| Field | Type | Description |
| --- | --- | --- |
| `data.items[]` | BlockSummary | `height`, `hash`, `time`, `txCount`, `size`, `miner`, `reward`, `fees` (see Data types). |
| `data.next` | integer \| null | The lowest height of this page. Pass it back as `before` for the next page; null at the first block available. |
### API400 (HTTP 400): Bad Request
A parameter is missing or malformed. `data.param` names it (here `chain`).
```json
{
"status": 0,
"code": "API400",
"message": "Unknown or missing chain.",
"data": {
"param": "chain"
},
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
### 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": []
}
}
```
### API502 (HTTP 502): Bad Gateway
The node is unavailable, still syncing or timed out. Retry later with a short back-off.
```json
{
"status": 0,
"code": "API502",
"message": "The node is unavailable or timed out. Please try again.",
"data": null,
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
## Notes
- Amounts in `reward` and `fees` are exact decimal strings in the chain's native unit.
- On ETH, `reward` and `fees` are null in this list for blocks nobody has opened yet: [Block](https://docs.rarebl.com/api/block/get) fills them. On TRON, `reward` is null and `size` is null.
- For TRON, `next` is null at the first block the node holds (history starts 2026-09-08).