Fetch the balance of an internal (custodial) address for a specific token

Returns balance data for a given address, chain, and token. Provide transfer_type and value_type as query parameters.

GET /accounts/{account_id}/addresses/{address_id}/balance

Fetch the balance of an internal (custodial) address for a specific token

cURL

curl --request GET \
  --url https://api.brale.xyz/accounts/{account_id}/addresses/{address_id}/balance \
  --header 'Authorization: Bearer <token>'

200

{
  "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

Show child attributes

balance · Amount · object · required

Monetary value with explicit currency

Show child attributes

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"