Get A Balance

Prerequisites

Get your account_id: How to get your account_id
Get a custodial address_id: list addresses and choose one with type=internal:

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

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

Parameter	Description	Example
`transfer_type`	Blockchain network	`solana`, `base`, `ethereum`
`value_type`	Token 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}"

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.

Get your custodial address_ids Add an External Destination

⌘I

How to

Workflows

Integrations

Get A Balance

Notes

​Notes

Notes