Multi Tokens (ERC-1155 or compatible)

Get all Multi Tokens that a blockchain address holds

/v3/multitoken/address/balance/{chain}/{address}

50 credit per API call

This endpoint is deprecated.

> 📘 **Note:** > > We've introduced a new, faster, and more reliable endpoint: GET /v4/data/multitokens/balances. As a result, the older endpoint - GET /v3/multitoken/address/balance/{chain}/{address} - 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 all Multi Tokens that a blockchain address holds. The Multi Tokens are returned grouped by the smart contracts they were minted on.

This API is supported for the following blockchains:

  • Celo
  • Ethereum
  • Polygon
get/v3/multitoken/address/balance/{chain}/{address}

Request

  • Base URL
    https://api.tatum.io
  • URL
    https://api.tatum.io/v3/multitoken/address/balance/{chain}/{address}
  • Auth
    API key in header x-api-key

Path parameters

chain'ETH' | 'MATIC' | 'CELO' required
Example:ETH

Blockchain to work with

addressstring required
Example:0x3223AEB8404C7525FcAA6C512f91e287AE9FfE7B

Blockchain address

Headers

x-testnet-type'ethereum-sepolia'

Type of testnet. Defaults to Sepolia. Valid only for ETH invocations.

Response

OK

contractAddressstring

Contract address of the Multi Token

Example response

[
  {
    "contractAddress": "0x771987a5add0ef1ce303aa069df82dd7f8fbb33b",
    "balances": [
      {
        "tokenId": "10",
        "amount": "17",
        "blockNumber": 1087623
      }
    ],
    "metadata": [
      {
        "tokenId": "1",
        "url": "ipfs://QmXFpaS3S7CkLZvihLFA9JbawKdqhjg8dJeDkPntmkD2Pc",
        "metadata": {
          "name": "Example NFT name",
          "description": "Example NFT description",
          "image": "ipfs://QmP4R7ACZ7JRQ6sLdmnPHqjWEXxzdnPvhAV2f6RnQ8uxJ6"
        }
      }
    ]
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.