get_wallet_balances_v4

Retrieve wallet balances for native tokens, ERC-20, ERC-721, and ERC-1155 assets across Ethereum, BSC, Polygon, Celo, Chiliz, and Tezos blockchains. Specify addresses and token types to filter results and exclude metadata if needed.

Instructions

[blockchain_data] /v4/data/wallet/balances 50 credits per API call This endpoint is deprecated. > 📘 Note: > > We've introduced a new, faster, and more reliable endpoint: GET /v4/data/wallet/portfolio. As a result, the older endpoint - GET /v4/data/wallet/balances - has been deprecated. These endpoints will reach End of Life on June 30, 2025, as announced in our changelog. We recommend migrating to the new endpoint as soon as possible. Get balances of native, fungible tokens (ERC-20), NFTs (ERC-721 and ERC-1155) or multitokens (ERC-1155 only) for a specific wallet address on the following blockchains: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet Tezos - tezos-mainnet To get started: Provide a chain name and comma-separated list of addresses. Our API will return balances of each token along with further information such as its type, id, and more. Aside from relevant information about each token and its balance, the response also contains metadata (they can, however, be excluded by setting excludeMetadata to true). If not specified, the API returns balances for all supported types of tokens (native, fungible tokens, nft, multitokens), but you can also choose to filter specific tokenTypes. For Tezos blockchain, the API returns balance of any tokens including native token (XTZ) for specified wallet addresses. Following query parameters won't have any effect on filtering data excludeMetadata.

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.
`chain`	Yes	The blockchain to work with.
`excludeMetadata`	No	The option to exclude metadata from the response.
`offset`	No	The offset to obtain next page of the data.
`pageSize`	No	The number of items per page (default is 50).
`tokenTypes`	No	The option to select only specific token types. It is possible to enter list of multiple types as a comma separated string. Use native, fungible (ERC-20), nft (includes ERC-721 and ERC-1155) or multitoken (ERC-1155 only).

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"
    },
    "chain": {
      "description": "The blockchain to work with.",
      "example": "ethereum-mainnet",
      "type": "string"
    },
    "excludeMetadata": {
      "description": "The option to exclude metadata from the response.",
      "type": "string"
    },
    "offset": {
      "description": "The offset to obtain next page of the data.",
      "example": "0",
      "type": "string"
    },
    "pageSize": {
      "description": "The number of items per page (default is 50).",
      "example": "10",
      "type": "string"
    },
    "tokenTypes": {
      "description": "The option to select only specific token types.\nIt is possible to enter list of multiple types as a comma separated string.\nUse native, fungible (ERC-20), nft (includes ERC-721 and ERC-1155) or multitoken (ERC-1155 only).\n",
      "enum": [
        "native",
        "nft",
        "multitoken",
        "fungible"
      ],
      "type": "string"
    }
  },
  "required": [
    "chain",
    "addresses"
  ],
  "type": "object"
}

Tatum MCP Server