Skip to main content
GET
/
accounts
/
{account_id}
/
addresses
/
{address_id}
/
balance
Fetch the balance of an internal (custodial) address for a specific token
curl --request GET \
  --url https://api.brale.xyz/accounts/{account_id}/addresses/{address_id}/balance \
  --header 'Authorization: Bearer <token>'
{
  "address": {
    "id": "2VcUIIsgARwVbEGlIYbhg6fGG57",
    "address": "73uyt9HkEqx9bThYXWaUBP67sWsiJEsyJ5rSCieDx5me"
  },
  "balance": {
    "value": "100.00",
    "currency": "SBC"
  },
  "transfer_type": "solana",
  "value_type": "SBC"
}
Use the playground below to try this endpoint directly, or review the OpenAPI details in the right panel.

Authorizations

​
Authorization
string
header
required

Use the Bearer token returned from the Auth endpoint via OAuth2 client_credentials flow. Include the token in the "Authorization: Bearer " header.

Path Parameters

​
account_id
string<ksuid>
required

The ID of the account

Pattern: ^[a-zA-Z0-9]{26}$
Example:

"2VcUIIsgARwVbEGlIYbhg6fGG57"

​
address_id
string<ksuid>
required

The ID of the address

Pattern: ^[a-zA-Z0-9]{26}$
Example:

"2VcUIIsgARwVbEGlIYbhg6fGG57"

Query Parameters

​
transfer_type
string

The blockchain environment (e.g., Solana, Ethereum)

​
value_type
string

The stablecoin token or currency code

Response

200 - */*

The address details and balance info

Balance of one token on one chain for a specific wallet

​
address
AddressReference · object
required
​
balance
Amount · object
required

Monetary value with explicit currency

​
transfer_type
enum<string>
required

Blockchain where the balance lives

Available options:
solana,
ethereum,
polygon,
base,
arbitrum,
canton,
avalanche,
base_sepolia,
sepolia,
solana_devnet,
tempo_testnet
Example:

"solana"

​
value_type
string
required

Token ticker

Example:

"SBC"