---
title: "Get the balance for a given address: a token balance on a chain for a wallet, or the available bank balance for a Plaid-linked bank account"
method: GET
path: "/accounts/{account_id}/addresses/{address_id}/balance"
tags: ["Addresses"]
---

# Get the balance for a given address: a token balance on a chain for a wallet, or the available bank balance for a Plaid-linked bank account

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

## Request

- Base URL: `https://api.brale.xyz`
- URL: `https://api.brale.xyz/accounts/{account_id}/addresses/{address_id}/balance`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.brale.xyz/oauth2/token` scopes: `addresses:read`

## Path parameters

- `account_id` string, required: ID of the resource
- `address_id` string, required: ID of the resource

## Query parameters

- `transfer_type` string
- `value_type` string

## Response `200`

OK

- AddressBalance
  - `address` AddressReference, required
    - `account_number` string, nullable: Masked account number, last 4 digits only; null for blockchain addresses
    - `address` string, nullable: On-chain address; null for bank addresses
    - `id` string, required: ID of the resource
  - `balance` Amount, required
    - `currency` string, required
    - `value` string, required
  - `transfer_type` string, required
  - `value_type` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Unknown
- `503`: Service Unavailable

## Changes

- **2026-09-29** `ba5b5dacd5ae`: 2 breaking, 7 info
  - the response property `address/address` became nullable for the status `200`
  - the response property `address/address` became optional for the status `200`
  - api operation id `get_address_token_balance` removed and replaced with `get_address_balance`
  - added the non-success response with the status `503`
  - …5 more
- **2026-07-13** `d934fd29acc3`: 5 breaking
  - media type `application/vnd.api+json` was changed to a more general media type `application/json` for the response status `200`
  - media type `application/vnd.api+json` was changed to a more general media type `application/json` for the response status `401`
  - media type `application/vnd.api+json` was changed to a more general media type `application/json` for the response status `403`
  - media type `application/vnd.api+json` was changed to a more general media type `application/json` for the response status `404`
  - …1 more
- **2026-02-07** `4f67c6cbfdb8`: 3 info
  - added the optional property `values` to the response with the `400` status
  - added the optional property `values` to the response with the `404` status
  - added the optional property `values` to the response with the `500` status
- **2025-08-09** `8484d42bf246`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brale/apis/brale-api/changes/accounts/:account_id/addresses/:address_id/balance/get.md)

---

[API](https://skmtc.dev/brale/apis/brale-api.md) - [All operations](https://skmtc.dev/brale/apis/brale-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brale/apis/brale-api/revisions/3378b8f911e0?raw)