---
title: "Get all Multi Tokens that a blockchain address holds"
method: GET
path: "/v3/multitoken/address/balance/{chain}/{address}"
tags: ["Multi Tokens (ERC-1155 or compatible)"]
deprecated: true
---

# Get all Multi Tokens that a blockchain address holds

`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`

> **Deprecated.**

/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](https://docs.tatum.io/changelog/blockchain-data-api-faster-endpoints-update). 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

## Path parameters

- `chain` 'ETH' | 'MATIC' | 'CELO', required
- `address` string, required

## Headers

- `x-testnet-type` 'ethereum-sepolia'

## Response `200`

OK

- object[]
  - `contractAddress` string: Contract address of the Multi Token
  - `balances` object[]
    - `tokenId` string: Token ID.
    - `amount` string: Number of tokens held by the address.
    - `blockNumber` number: Block number when the token was received by the address.
  - `metadata` object[]
    - `tokenId` string: The ID of the Multi Token owned by this address
    - `url` string: The URL pointing to the Multi Token metadata; the URL may not be present, and if it is not returned, you can get it by calling the Multi Token Contract.uri() method
    - `metadata` object: The metadata scheme obtained from the metadata URL; the scheme may not be present, and if it is not returned, you can get it using the <a href="#operation/MultiTokenGetMetadata">Multi Token metadata API</a>

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403`: Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/smart-contracts.md) - [All operations](https://skmtc.dev/tatum/apis/smart-contracts/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/smart-contracts/revisions/c0146043bb37?raw)