Skip to main content
1

Prerequisites

curl --request GET \
  --url "https://api.brale.xyz/accounts/${ACCOUNT_ID}/addresses" \
  --header "Authorization: Bearer ${AUTH_TOKEN}"
2

Call the balance endpoint

Use your account_id and an internal address_id. Balances require both transfer_type and value_type.GET /accounts/{account_id}/addresses/{address_id}/balance
ParameterDescriptionExample
transfer_typeBlockchain networksolana, base, ethereum
value_typeToken symbol (case-sensitive)SBC, USDC, PYUSD
curl --request GET \
  --url "https://api.brale.xyz/accounts/${ACCOUNT_ID}/addresses/${ADDRESS_ID}/balance?transfer_type=base&value_type=SBC" \
  --header "Authorization: Bearer ${AUTH_TOKEN}"
3

Review the response

{
  "address": {
    "id": "2VcUIonJeVQzFoBuC7LdFT0dRe4",
    "address": "0xcdEA458750b9A8D6C4Ba8B3D68CE98Ba2330352A"
  },
  "balance": {
    "value": "45314.07",
    "currency": "USD"
  },
  "value_type": "SBC",
  "transfer_type": "base"
}
Balances are only available for type=internal custodial addresses managed by Brale.

​
Notes

  • Works only for internal custodial addresses (type=internal).
  • Always send both transfer_type and value_type; a custodial address can hold multiple tokens across chains.
  • See Value Types and Transfer Types for supported combinations.