---
title: "Get Wallet Balance"
method: GET
path: "/2025-06-09/wallets/{walletLocator}/balances"
---

# Get Wallet Balance

`GET /2025-06-09/wallets/{walletLocator}/balances`

## Request

- Base URL: `https://staging.crossmint.com/api`
- URL: `https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/balances`
- Auth: none required
- TypeScript: <https://skmtc.dev/crossmint/apis/onramp/docs/2025-06-09/wallets/:walletLocator/balances/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the balance of a wallet for a given chain and currency

**API scope required**: `wallets:balance.read`

## Path parameters

- `walletLocator` string, required

## Query parameters

- `chains` string
- `tokens` string, required

## Headers

- `X-API-KEY` string, required

## Response `200`

Returns the balance of the wallet for the given chain and currency

- object[]: Array of wallet balances per token
  - `symbol` string
  - `name` string: The name of the token
  - `decimals` number, required: The number of decimals of the token
  - `amount` string, required: The amount of the token after placing the decimal point
  - `rawAmount` string, required: The raw amount of the token
  - `chains` object, required: Balance information per chain

## Other responses

- `400`: Returns an error (400) if the wallet locator is invalid or if the address type is not supported

---

[API](https://skmtc.dev/crossmint/apis/onramp.md) - [All operations](https://skmtc.dev/crossmint/apis/onramp/llms.txt) - [OpenAPI document](https://skmtc.dev/crossmint/apis/onramp/revisions/e2143d192130?raw)