---
title: "Get the amount of one or multiple Multi Tokens for multiple blockchain addresses"
method: GET
path: "/v3/multitoken/balance/batch/{chain}/{contractAddress}"
tags: ["Multi Tokens (ERC-1155 or compatible)"]
---

# Get the amount of one or multiple Multi Tokens for multiple blockchain addresses

`GET /v3/multitoken/balance/batch/{chain}/{contractAddress}`

## Request

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

/v3/multitoken/balance/batch/{chain}/{contractAddress}

**1 credit per API call**

For multiple blockchain addresses, get the amount of one or multiple Multi Tokens (minted on the smart contract specified by the `contractAddress` path parameter in the request endpoint URL) that those addresses hold.

This API is supported for the following blockchains:

*   BNB Smart Chain
*   Celo
*   Ethereum
*   Harmony
*   Klaytn
*   KuCoin Community Chain
*   Polygon
*   Flare
*   Cronos
*   Base
*   Avalanche
*   Fantom
*   Optimism

## Path parameters

- `chain` 'ETH' | 'MATIC' | 'KCS' | 'KLAY' | 'ONE' | 'CELO' | 'BSC' | 'FLARE' | 'CRO' | 'BASE' | 'AVAX' | 'FTM' | 'OPTIMISM', required
- `contractAddress` string, required

## Query parameters

- `tokenId` string, required
- `address` string, required
- `testnetType` 'ethereum-sepolia' | 'flare-coston' | 'flare-coston2' | 'flare-songbird': Specifies the testnet type. The default is ethereum-sepolia for Ethereum (ETH) currency and flare-coston for Flare (FLR) currency. Valid testnet types depend on the specified currency.

## Headers

- `x-testnet-type` Schema (unresolved $ref)

## Response `200`

OK

- string[]

## 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)