---
title: "Balance"
method: GET
path: "/v1/spl/balance"
---

# Balance

`GET /v1/spl/balance`

Reads the owner's associated token account on the base RPC.

## Query parameters

- `address` string, required
- `mint` string, required
- `cluster` union
  - 'mainnet' | 'devnet'
  - string

## Response `200`

Base-chain token balance

- object
  - `address` string, required
  - `mint` string, required
  - `ata` string, required
  - `location` 'base' | 'ephemeral', required
  - `balance` string, required — Base-unit balance as a string.

## Other responses

- `400` — Query error
- `422` — Validation error

---

[API](https://skmtc.dev/magicblock/apis/magicblock-router-api.md) · [All operations](https://skmtc.dev/magicblock/apis/magicblock-router-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/magicblock/magicblock-router-api/revisions/f024efa907c6/schema)