---
title: "Get token balances for multiple addresses"
method: POST
path: "/api/v1/batch/token-balances"
tags: ["Token Balances"]
---

# Get token balances for multiple addresses

`POST /api/v1/batch/token-balances`

## Request

- Base URL: `https://wdk-api.tether.io` (the document declares no server; this is the origin it was published from)
- URL: `https://wdk-api.tether.io/api/v1/batch/token-balances`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/tether/apis/wdk-indexer-api/docs/api/v1/batch/token-balances/post.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the current token balance for multiple addresses in a single request. Each item in the batch is processed independently - if one item fails (e.g. invalid address), the others still return results. The response array maintains the same order as the request. Maximum 10 items per batch.

## Request body

- object[]: Array of balance query objects. Maximum 10 items.
  - `blockchain` 'ethereum' | 'arbitrum' | 'avalanche' | 'polygon' | 'plasma' | 'sepolia' | 'tron' | 'ton' | 'bitcoin' | 'spark', required: Blockchain network identifier.
  - `token` 'usdt' | 'xaut' | 'usat' | 'btc', required: Token identifier.
  - `address` string, required: Wallet address to query.

## Response `200`

Array of results in the same order as the request. Each element is either a balance result or an error object.

- union[]: Array of results in the same order as the request. Each element is either a balance result or an error object.
  - union
    - object: Current token balance for the queried address
      - `tokenBalance` object: Balance information.
        - `blockchain` string: Blockchain queried.
        - `token` string: Token queried.
        - `amount` string: Current balance as a decimal string.
    - object
      - `error` string
      - `message` string
      - `status` number

## Other responses

- `400`: Bad Request - invalid parameters, address format, blockchain, or token
- `401`: Unauthorized - expired API key
- `403`: Forbidden - missing or invalid API key
- `429`: Too Many Requests - rate limit exceeded
- `500`: Internal Server Error - indexer service unavailable or unexpected failure

---

[API](https://skmtc.dev/tether/apis/wdk-indexer-api.md) - [All operations](https://skmtc.dev/tether/apis/wdk-indexer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tether/apis/wdk-indexer-api/revisions/fb8b84e0bb98?raw)