Chains API
Blocks a validator or builder produced
Lists the blocks one Ethereum or BNB validator or block builder produced, newest first, with the reward it earned on each.
/api/external/chain-analysis/producer-blocks/{chain}/{address}What it returns
The blocks one address produced — as a validator, or as the block builder named as fee recipient — newest first, 50 a page, each with its time and what the producer earned for it. An address that never produced a block answers an empty list. nextPage is null on the last page; pages go no deeper than 200 (the newest 10000 blocks).
Chains
- BNB Chain BNB
- Ethereum ETH
Request
Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.
curl -H "x-dex-data-key: $DEXDATA_API_KEY" \ "https://api.dexdata.io/api/external/chain-analysis/producer-blocks/BNB/<address>"
| Parameter | Description |
|---|---|
pagequery · integer · optional | Page number, from 1 (the newest blocks) to 200. |
chainpath · string · required | Ethereum or BNB; every other chain returns 400. |
addresspath · string · required | The validator or block builder: the address blocks name as their fee recipient, 0x followed by 40 hexadecimal characters. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
address | string | The producer, lowercase. |
page | integer | The page this is. |
blocks | object[] | Newest first. [] when the address produced no block. |
blocks[].blockNumber | integer | The block number. |
blocks[].timestamp | integer | Unix seconds of the block. |
blocks[].rewardWei | string | What the block paid its producer in transaction fees, in wei, as a decimal string, net of any burnt base fee. Payments made to a builder inside transactions are not counted. |
nextPage | integer | null | The page to ask for next, or null when this is the last one. |
Start building with DexData today
Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.
Get a free API key