/v4/data/wallet/balance/time

100 credits per API call

Get native balances for a specific wallet addresses by time on the following blockchains:

• Ethereum - ethereum-mainnet
• Bitcoin - bitcoin-mainnet
• Base - base-mainnet
• Arbitrum - arb-one-mainnet
• BSC - bsc-mainnet
• Polygon - polygon-mainnet
• Optimism - optimism-mainnet
• Berachain - berachain-mainnet
• Unichain - unichain-mainnet
• Celo - celo-mainnet
• Avalanche - avax-mainnet
• Gnosis - gno-mainnet
• zkSync - zksync-mainnet
• Rootstock - rsk-mainnet
• Ethereum Classic - ethereum-classic-mainnet
• Lisk - lisk-mainnet
• XDC - xdc-mainnet
• Sonic - sonic-mainnet
• Robinhood - robinhood-mainnet
• Solana - solana-mainnet

To get started, provide a chain name, comma-separated list of addresses and specify one of the filters listed below (combination of the filters is not allowed):

• block number
• time
• unix

If you pass a block number that is in the future (beyond the current latest block), the system will return the balance for the latest block.

If you pass a time or Unix timestamp that is in the future, the system will also return the balance for the latest block.

If you pass a time or Unix timestamp in the past (dating back to or earlier than the blockchain's genesis block), the system will return the balance for the first block (genesis block), unless the chain notes below say otherwise.

Each result carries lastUpdatedBlockNumber, the block the balance was read at.

Solana

• blockNumber is a slot. A slot in which no block was produced (a skipped slot) returns the balance as of that slot, which is the balance after the last produced slot before it.
• time and unix resolve to the last slot that produced a block at or before that second.
• Native SOL history starts at a fixed slot in July 2025 and is not available before it. A request that resolves to an earlier slot, including a time before genesis, returns a 400 error whose message names the earliest available slot.
• Pass tokenAddress (an SPL Token or Token-2022 mint) to get that token's balance instead of SOL. Token results have type fungible and carry the tokenAddress. Token history starts at genesis, so a time before genesis returns the genesis balance. A token address that is not an indexed mint returns a 404 error.