Blocks
Block detail lookups, paginated latest blocks, and raw block data.
Block Details
GET
/v1/blocks?request=detailsRetrieve detailed information about a specific block by height or hash.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| request | string | REQUIRED | — | Must be `details` |
| blockHeight | int | optional | — | Block height (required if blockHash not given) |
| blockHash | string | optional | — | Block hash (required if blockHeight not given) |
🪙 Usage & Credits
This endpoint consumes 10 credits per request against your active API tier.
Response
json
{
"status": "string",
"hash": "string",
"previousHash": "string",
"height": "integer",
"timestamp": "integer",
"txns": "integer",
"proposer": "string",
"size": "integer",
"curType": "string",
"fees": {
"base": {
"total": "float",
"validator": "float",
"burn": "float",
"treasury": "float"
},
"contract *": {
"total": "float",
"validator": "float",
"burn": "float",
"project": "float"
}
},
"feeDistributions": [
{
"token": "string",
"recipient": "string",
"amount": "string",
"type": "string"
}
]
}Errors
| Status | Condition |
|---|---|
| 400 | Neither blockHeight nor blockHash provided |
| 400 | Invalid (non-numeric) blockHeight |
Latest Blocks
GET
/v1/blocks?request=latestRetrieve a paginated list of the most recent blocks.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| request | string | REQUIRED | — | Must be `latest` |
| limit | int | optional | 10 | Number of blocks to return |
| offset | int | optional | 0 | Pagination offset |
🪙 Usage & Credits
This endpoint consumes 10 credits per request against your active API tier.
Response
json
[
{
"height": "integer",
"txns": "integer",
"timestamp": "integer",
"proposer": "string"
}
]Raw Block Data
GET
/v1/blocks?request=rawRetrieve the full, un-normalized block payload as received from the ZERA network node.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| request | string | REQUIRED | — | Must be `raw` |
| blockHeight | int | optional | — | Block height (required if blockHash not given) |
| blockHash | string | optional | — | Block hash (required if blockHeight not given) |
🪙 Usage & Credits
This endpoint consumes 5 credits per request against your active API tier.