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

# Private Balance

`GET /v1/spl/private-balance`

Reads the owner's associated token account on the ephemeral RPC. Requires an `Authorization: Bearer <token>` header obtained from `/v1/spl/login`.

## Query parameters

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

## Response `200`

Ephemeral 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` — Missing auth token (`MISSING_AUTH_TOKEN`) or other 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)