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.

GET/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>"
Parameters
ParameterDescription
page

query · integer · optional

Page number, from 1 (the newest blocks) to 200.
chain

path · string · required

Ethereum or BNB; every other chain returns 400.
address

path · 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.

Response fields of Blocks a validator or builder produced
FieldTypeDescription
addressstringThe producer, lowercase.
pageintegerThe page this is.
blocksobject[]Newest first. [] when the address produced no block.
blocks[].blockNumberintegerThe block number.
blocks[].timestampintegerUnix seconds of the block.
blocks[].rewardWeistringWhat 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.
nextPageinteger | nullThe 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