Chains API

Which accounts did a block touch, and what did it change?

Every account one ETH or BASE block touched: balance and nonce changes, code changes and storage slots written and read, with totals for the block.

GET/api/external/chain-analysis/block-access-list/{chain}

Get a free API key Try it in the API reference

What it returns

The access list of one block named by height or hash: every account its transactions touched, and for each how many times its balance and nonce changed and where they ended, whether its code changed, and how many storage slots it wrote and only read. totals cover the whole block; accounts lists the most active first, up to limit, or only address when given. Every null field means the chain has no such block. Ethereum answers for about the last 10,000 blocks (roughly a day and a half) and Base from block 50,000,000; an older block is a 400.

Chains

Ethereum ETH
Base BASE

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-access-list/ETH"

Parameters
Parameter	Description
`blockNumber` query · integer · optional	The block height. Give this or `blockHash`, not both.
`blockHash` query · string · optional	The block hash, 0x followed by 64 hexadecimal characters. Give this or `blockNumber`, not both.
`address` query · string · optional	Only this account: 0x followed by 40 hexadecimal characters. Omit it for every account.
`limit` query · integer · optional	How many accounts to list, most active first: 1 to 200. Defaults to 25.
`chain` path · string · required	ETH or BASE, the chains that publish block access lists; every other chain returns 400.

Response fields

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

Response fields of Which accounts did a block touch, and what did it change?
Field	Type	Description
`block`	object \| null	The block, or null when the chain has no block with this number or hash.
`block.number`	integer	The block height.
`block.hash`	string	The block hash, lowercase.
`block.timestamp`	integer \| null	Unix seconds the block was produced at.
`totals`	object \| null	Counts over every account the block touched, whatever `address` and `limit` say.
`totals.accounts`	integer	Accounts the block touched.
`totals.balanceChanged`	integer	Accounts whose balance the block changed.
`totals.nonceChanged`	integer	Accounts whose nonce the block changed: the senders, and contracts that created others.
`totals.codeChanged`	integer	Accounts whose code the block deployed or replaced, a delegation included.
`totals.unchanged`	integer	Accounts the block named but neither changed nor read storage of.
`totals.slotsWritten`	integer	Storage slots written, summed over accounts.
`totals.slotsRead`	integer	Storage slots read and not written, summed over accounts.
`accounts`	object[] \| null	The accounts asked for, most active first (changes and slots summed), then by address.
`accounts[].address`	string	The account, lowercase.
`accounts[].balanceChanges`	integer	How many times the block changed its balance.
`accounts[].finalBalanceWei`	string \| null	Its balance after the block, in wei, as a decimal string; null when the block did not change it.
`accounts[].nonceChanges`	integer	How many times the block changed its nonce.
`accounts[].finalNonce`	integer \| null	Its nonce after the block; null when the block did not change it.
`accounts[].codeChanged`	boolean	Whether the block deployed or replaced its code.
`accounts[].slotsWritten`	integer	Distinct storage slots of this account the block wrote.
`accounts[].slotsRead`	integer	Distinct storage slots of this account the block read and did not write.
`accountsNotListed`	integer \| null	Matching accounts left out by `limit`; 0 when all are listed.

Price per call

Ethereum, Base: 1 credit

Charged only when the call succeeds. Prices as of 2026-10-30; the current ones are always in the API reference.

Look up one block by its number or hash
The block's header: time, gas, base fee and miner.
A block's transactions
The transactions that made these changes.
How much stablecoin value sits on this chain, and which stablecoin dominates it?
One chain's total stablecoin supply today in USD, split by peg currency, with the largest stablecoin on the chain and its share.
How have DEX volume, fees and revenue on this chain moved?
One chain's daily DEX trading volume, fees paid or protocol revenue in USD, over 7 to 365 days or its whole history.
Which protocols lead this chain by DEX volume, fees or revenue?
One chain's protocols ranked by DEX trading volume, fees paid or protocol revenue in USD over the last 24 hours, 7 days or 30 days.
The recent ERC-4337 user operations on a chain
The chain's account-abstraction user operations, newest first, 50 per page, optionally only one smart account's or one bundler's: hash, smart account, entry point, bundle transaction, fee and success.

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