get_wallet_balance_by_time_v4

Retrieve native wallet balances for up to 10 addresses at a specific block number, time, or Unix timestamp on supported blockchains using Tatum MCP Server’s API.

Instructions

[blockchain_data] /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 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).

Input Schema

Name	Required	Description
`addresses`	Yes	The blockchain public wallet addresses. It is possible to enter list of up to 10 addresses as a comma separated string.
`blockNumber`	No	Block number.
`chain`	Yes	The blockchain to work with.
`time`	No	Time when block is processed.
`unix`	No	Unix timestamp when block is processed.

Input Schema (JSON Schema)

{
  "properties": {
    "addresses": {
      "description": "The blockchain public wallet addresses.\nIt is possible to enter list of up to 10 addresses as a comma separated string.\n",
      "type": "string"
    },
    "blockNumber": {
      "description": "Block number.",
      "type": "string"
    },
    "chain": {
      "description": "The blockchain to work with.",
      "example": "ethereum-mainnet",
      "type": "string"
    },
    "time": {
      "description": "Time when block is processed.",
      "type": "string"
    },
    "unix": {
      "description": "Unix timestamp when block is processed.",
      "type": "number"
    }
  },
  "required": [
    "chain",
    "addresses"
  ],
  "type": "object"
}

Tatum MCP Server