API Reference
SupportStatusSign UpLogin

Get balances by time of addresses

get
https://api.tatum.io/v4/data/wallet/balance/time

/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

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).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum
required

The blockchain to work with.

string
required

The blockchain public wallet addresses. It is possible to enter list of up to 10 addresses as a comma separated string.

number
≥ 0

Block number. You must either use "blockNumber" or "time" or "unix" params in your requests.

string

Time when block is processed. You must either use "blockNumber" or "time" or "unix" params in your requests.

number

Unix timestamp when block is processed. You must either use "blockNumber" or "time" or "unix" params in your requests.

Responses

Updated 5 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 months ago