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
Request
- Base URLhttps://api.tatum.io
- URLhttps://api.tatum.io/v3/multitoken/address/balance/{chain}/{address}
- AuthAPI key in header x-api-key
Path parameters
Blockchain to work with
Blockchain address
Headers
Type of testnet. Defaults to Sepolia. Valid only for ETH invocations.
Response
OK
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.