---
title: "Get token balance for an address"
method: GET
path: "/api/v1/{blockchain}/{token}/{address}/token-balances"
tags: ["Token Balances"]
---

# Get token balance for an address

`GET /api/v1/{blockchain}/{token}/{address}/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/{blockchain}/{token}/{address}/token-balances`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/tether/apis/wdk-indexer-api/docs/api/v1/:blockchain/:token/:address/token-balances/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the current token balance for a specific wallet address on a given blockchain. Returns a single balance amount representing how much of the specified token the address currently holds.

## Path parameters

- `blockchain` 'ethereum' | 'arbitrum' | 'avalanche' | 'polygon' | 'plasma' | 'sepolia' | 'tron' | 'ton' | 'bitcoin' | 'spark', required
- `token` 'usdt' | 'xaut' | 'usat' | 'btc', required
- `address` string, required

## Response `200`

Current token balance for the queried address

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

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