Skip to main content
Use GET /accounts/{account_id}/addresses/{address_id}/balance for both address types. Balances require both transfer_type and value_type.

​
Wallet balance

1

Prerequisites

2

Call the balance endpoint

Use your account_id and an internal address_id.GET /accounts/{account_id}/addresses/{address_id}/balance
3

Review the response

​
Plaid-linked bank balance

1

Prerequisites

2

Call the balance endpoint

3

Review the response

  • Brale uses Plaid’s available balance when Plaid supplies it. Otherwise, Brale uses the current balance.
  • Successful reads may be cached for up to 30 seconds.
  • The balance is a point-in-time snapshot. It does not guarantee that an ACH debit will settle.
  • Brale never returns the full bank account number. account_number is masked.
  • Only Plaid-linked USD bank addresses support balance lookup. Bank addresses created through Direct bank entry do not.
For error responses, see Get an address balance.
Balance queries are supported for internal custodial addresses and Plaid-linked bank addresses. Other external addresses—including self-custody wallets and bank addresses created through Direct bank entry—do not expose balances through Brale.

​
Notes

  • 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.