Skip to main content
GET
/
accounts
/
{account_id}
/
addresses
Fetch all addresses
curl --request GET \
  --url https://api.brale.xyz/accounts/{account_id}/addresses \
  --header 'Authorization: Bearer <token>'
{
  "addresses": [
    {
      "id": "2VcUIIsgARwVbEGlIYbhg6fGG57",
      "status": "active",
      "name": "Solana Custodial Wallet",
      "address": "73uyt9HkEqx9bThYXWaUBP67sWsiJEsyJ5rSCieDx5me",
      "transfer_types": [
        "solana",
        "base",
        "wire"
      ]
    }
  ]
}
Use the playground below to try this endpoint directly, or review the OpenAPI details in the right panel.

​
Supported query parameters

You can filter the results using the following query parameters:
ParameterTypeDescription
addressstringFilters results to addresses whose onchain address exactly matches the provided value (e.g., an EVM or Solana address).
typeenumFilter by address type: internal | external.
transfer_typeenum (repeatable)Filter by one or more transfer types (e.g., ethereum, base, solana, stellar).
If you already know the onchain address you are looking for, you can filter the addresses list by passing the exact address in the address query parameter. This is useful when you need to resolve an onchain address to its Brale address_id.
If you already know the address_id, use GET /accounts/{account_id}/addresses/{address_id} to retrieve a single Address directly.

​
Example: filter by exact onchain address

To find a specific registered onchain address, pass it as the address query parameter: 
curl --request GET \
  --url "https://api.brale.xyz/accounts/${ACCOUNT_ID}/addresses?address=0xcdCfd05B57c6136F090658C123063d12DebaA51D" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}"

​
Example: filter by type and transfer type

curl --request GET \
  --url "https://api.brale.xyz/accounts/${ACCOUNT_ID}/addresses?type=external&transfer_type=solana&transfer_type=base" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}"

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"

Response

200 - */*

A list of addresses

​
addresses
Address · object[]