---
title: "GET /v2/balances/token-balance"
method: GET
path: "/v2/balances/token-balance"
tags: ["Balances"]
---

# GET /v2/balances/token-balance

`GET /v2/balances/token-balance`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/swaprhq/apis/movr-aggregator-api/docs/v2/balances/token-balance/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `tokenAddress` string, required
- `chainId` string, required
- `userAddress` string, required

## Response `200`

Returns the balance of the token on any given chain

- TokenBalanceReponseDTO
  - `success` boolean, required
  - `result` object, required
    - `chainId` number, required
    - `tokenAddress` string, required
    - `userAddress` string, required
    - `balance` string, required
    - `decimals` number, required
    - `icon` string, required
    - `symbol` string, required
    - `name` string, required

---

[API](https://skmtc.dev/swaprhq/apis/movr-aggregator-api.md) - [All operations](https://skmtc.dev/swaprhq/apis/movr-aggregator-api/llms.txt) - [OpenAPI document](https://skmtc.dev/swaprhq/apis/movr-aggregator-api/revisions/8b1957cc0e8f?raw)