Chains API

How far away a future block is

Remaining blocks and an estimated wait, in seconds, until a caller-supplied future block number is mined.

GET/api/external/chain-analysis/block-countdown/{chain}

Get a free API key Try it in the API reference

What it returns

Remaining blocks and an estimated wait, in seconds, until targetBlock is mined. alreadyMined is true when the target has already been produced — the source's own named answer for that case, distinct from every other field being null for a genuinely unavailable reading. Every other field is null when nothing could be established, never 0. Where no countdown service answers — always on ARC and RHC — the chain's own block headers do: currentBlock is the latest header, and estimatedSeconds is the remaining blocks times the mean block time over the last 10,000 blocks. On SOL the block is the slot: currentBlock is the newest confirmed slot, and estimatedSeconds uses the mean slot time over the last hour.

Chains

Solana SOL
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-countdown/SOL?targetBlock=<targetBlock>"

Parameters
Parameter	Description
`targetBlock` query · integer · required	The future block number to count down to — on SOL, the slot.
`chain` path · string · required	ETH, BNB, BASE, STABLE, ARC, RHC, SOL; 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 How far away a future block is
Field	Type	Description
`targetBlock`	integer	Echoes the request.
`currentBlock`	integer \| null	The chain's tip at the moment this was measured.
`remainingBlocks`	integer \| null
`estimatedSeconds`	number \| null
`alreadyMined`	boolean	True only for the source's own "this block already exists" answer, in which case every other field is `null` — see the endpoint description.

Price per call

Solana: 5 credits
BNB Chain, Ethereum, Stable, Base: 14 credits
Robinhood Chain, Arc: 1 credit

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

Current gas prices and confirmation time
Another chain-only timing question: gas cost right now vs. blocks until a future block.
Which contracts emitted this event in a block range?
Undecoded event logs from any contract on a chain in a block range, found by indexed topic: an event signature, or a wallet in an indexed argument.
Event log search brief: which contracts emitted an event, counted
How many logs match a topic in a block range, which contracts and events emitted them, and the newest five in full, undecoded. A few KB.
The newest blocks on a chain
The newest blocks one EVM chain has produced, head first, with hash, time, transaction count, gas, base fee and miner.
The block at a given time
Which block one chain was on at a Unix timestamp: the last block at or before it and the first after it, with number (the slot on SOL), hash and time.
A block's transactions
Every transaction in one EVM block, in order, with sender, recipient, value, success or failure, gas, the function called and the ERC-20 / ERC-721 token transfers each 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