Skip to main content
GET
/
v1
/
spl
/
private-balance
Private Balance
curl --request GET \
  --url https://payments.magicblock.app/v1/spl/private-balance \
  --header 'authorization: <authorization>'
{
  "address": "Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L",
  "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "ata": "3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE",
  "location": "ephemeral",
  "balance": "1000000"
}

Headers

​
authorization
string
required

Required. Authentication token issued by /v1/spl/login. Format: Bearer <token>.

Example:

"Bearer 1234567890"

Query Parameters

​
address
string
required

Owner wallet pubkey.

Example:

"Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L"

​
mint
string
required

SPL mint pubkey.

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

​
cluster

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.

Available options:
mainnet,
devnet
Example:

"mainnet"

Response

Ephemeral token balance

​
address
string
required
​
mint
string
required
​
ata
string
required
​
location
enum<string>
required
Available options:
base,
ephemeral
​
balance
string
required

Base-unit balance as a string.