Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Wallet API

Get balances by time of addresses

/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

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

get/v4/data/wallet/balance/time

Query parameters

chain'ethereum-mainnet' | 'bitcoin-mainnet' | 'base-mainnet' | 'arb-one-mainnet' | 'bsc-mainnet' | 'polygon-mainnet' | 'optimism-mainnet' | 'berachain-mainnet' | 'unichain-mainnet' | 'celo-mainnet' | 'avax-mainnet' | 'gno-mainnet' | 'zksync-mainnet' | 'rsk-mainnet' | 'ethereum-classic-mainnet' | 'lisk-mainnet' | 'xdc-mainnet' | 'sonic-mainnet' required
Example:ethereum-mainnet

The blockchain to work with.

addressesstring required

Wallet address

Example:0x80d8bac9a6901698b3749fe336bbd1385c1f98f2,0xAe680Ed83baF08a8028118Bd19859F8a0E744cc6

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

blockNumbernumber
Example:16499510

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

timestring
Example:2022-12-24T00:20

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

unixnumber
Example:1587390414

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

Response

OK

prevPagestring

Cursor pagination, used to get previous page of results (work in progress, not used right now).

nextPagestring

Cursor pagination, used to get next page of results (work in progress, not used right now).

Example response

{
  "result": [
    {
      "chain": "ethereum-mainnet",
      "address": "0xae680ed83baf08a8028118bd19859f8a0e744cc6",
      "balance": "2.881012674896012762",
      "denominatedBalance": "2881012674896012762",
      "decimals": 18,
      "type": "native"
    }
  ]
}