Chains API

Block transactions brief: a block's largest transactions and counts

One EVM block's 30 largest transactions by value, with how many it holds, reverted, created contracts or moved tokens.

GET/api/external/chain-analysis/block-transactions-brief/{chain}

Get a free API key Try it in the API reference

What it returns

The brief of block-transactions; prefer it unless you need every transaction or the token transfers themselves. The same chain and blockNumber. It lists the 30 transactions that sent the most native coin, in block order, each as block-transactions lists it but with its token transfers counted rather than listed, plus how many transactions the block holds, how many reverted, how many created a contract and how many token transfers it carries. A block that has not been produced yet answers block: null and every count and the list null.

Chains

BNB Chain BNB
Ethereum ETH
Stable STABLE
Base BASE
Robinhood Chain RHC
Arc ARC

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/block-transactions-brief/BNB?blockNumber=<blockNumber>"

Parameters
Parameter	Description
`blockNumber` query · integer · required	The block number to read, on the chain named in the path.
`chain` path · string · required	Ethereum, BNB, Base, Stable, Arc or RHC. SOL returns 400: no wired source answers a Solana block's transactions. CELO, ARB, OP and SCROLL return 400 here.

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of Block transactions brief: a block's largest transactions and counts
Field	Type	Description
`blockNumber`	integer	The block number asked about.
`block`	object \| null	The block, or `null` when it has not been produced yet.
`block.number`	integer	The block height.
`block.hash`	string	The block hash.
`block.timestamp`	integer	Unix seconds the block was produced at.
`transactionCount`	integer \| null	Transactions in the block. `null` exactly when `block` is.
`failedCount`	integer \| null	Of them, reverted. `null` exactly when `block` is.
`contractCreationCount`	integer \| null	Of them, contract creations. `null` exactly when `block` is.
`tokenTransferCount`	integer \| null	ERC-20 and ERC-721 Transfer events across the block. `null` exactly when `block` is.
`transactions`	object[] \| null	The 30 transactions that sent the most native coin, ties kept in block order, listed in block order. `null` exactly when `block` is.
`transactions[].hash`	string	The transaction hash.
`transactions[].index`	integer	Position of the transaction in the block, from 0.
`transactions[].from`	string	The sender.
`transactions[].to`	string \| null	The recipient. `null` when the transaction created a contract.
`transactions[].valueWei`	string	Native coin sent, in wei, as a decimal string.
`transactions[].status`	string \| null	Whether it executed or reverted. `null` only on blocks from before the chain recorded it.
`transactions[].gasUsed`	integer	Gas the transaction used.
`transactions[].effectiveGasPriceWei`	string \| null	What one unit of gas cost it, wei, decimal string. `0` is real on chains and system transactions that pay no gas.
`transactions[].contractCreated`	string \| null	The contract it created, or `null`.
`transactions[].methodId`	string \| null	The first four bytes of the call data (the function called), or `null` when there is no call data.
`transactions[].tokenTransferCount`	integer	The ERC-20 and ERC-721 Transfer events it emitted.

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