v1

latestOpenAPI 3.1.02026-07-2619047.9 KB

Private Balance

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

get/v1/spl/private-balance

Query parameters

addressstring required
Example:Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L

Owner wallet pubkey.

mintstring required
Example:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

SPL mint pubkey.

'mainnet' | 'devnet'
OR
string

Optional. Use mainnet for BASE_RPC_URL and EPHEMERAL_RPC_URL, devnet for BASE_DEVNET_RPC_URL and EPHEMERAL_DEVNET_RPC_URL, or provide a custom http(s) RPC URL to override the base RPC while keeping the configured ephemeral RPC.

Response

Ephemeral token balance

addressstring required
mintstring required
atastring required
location'base' | 'ephemeral' required
balancestring required

Base-unit balance as a string.