GET /api/v3/brokerage/accounts — List All Accounts

GET /api/v3/brokerage/accounts — returns a paginated list of all trading accounts for the authenticated user, including balances and currency.

The List Accounts endpoint returns all trading accounts associated with your authenticated Coinbase Advanced Trade profile. Each account represents a wallet for a specific asset — such as BTC, ETH, or USD — and includes the available balance, any funds held for open orders, and metadata about the account’s type and status. You can paginate through large account sets using the limit and cursor query parameters.

Endpoint

GET https://api.coinbase.com/api/v3/brokerage/accounts

Authentication

This endpoint requires a valid JWT Bearer token passed in the Authorization header:

Authorization: Bearer $JWT

Query Parameters

limit · integer

Number of accounts to return per page. Defaults to 49. Maximum value is 250.

cursor · string

Pagination cursor returned by a previous response. Pass this value to retrieve the next page of results.

Response Fields

accounts · array

List of account objects belonging to the authenticated user.

Show Account object fields

uuid · string

Unique identifier for the account.

name · string

Human-readable display name for the account (e.g., "BTC Wallet").

currency · string

The asset currency code associated with this account (e.g., BTC, USD, ETH).

available_balance · object

The balance currently available for trading.

Show available_balance fields

value · string

The numeric balance amount as a string (e.g., "0.5").

currency · string

The currency of the balance (e.g., "BTC").

default · boolean

Whether this is the default account for its currency. Each currency has at most one default account.

active · boolean

Whether the account is currently active and able to send or receive funds.

created_at · string

ISO 8601 timestamp indicating when the account was created (e.g., "2023-01-15T10:30:00Z").

updated_at · string

ISO 8601 timestamp of the most recent update to the account (e.g., "2024-01-20T14:22:00Z").

type · string

The account type. One of:

• ACCOUNT_TYPE_CRYPTO — a cryptocurrency wallet
• ACCOUNT_TYPE_FIAT — a fiat currency account (e.g., USD)

ready · boolean

Whether the account is fully set up and ready for trading activity.

hold · object

Funds currently held and unavailable due to open orders or pending transactions.

Show hold fields

value · string

The amount on hold as a string (e.g., "0.1").

currency · string

The currency of the held funds.

has_next · boolean

Indicates whether additional pages of accounts are available. If true, use the returned cursor to fetch the next page.

cursor · string

Pagination cursor to pass as the cursor query parameter in your next request. Empty string when there are no further pages.

size · integer

The number of accounts returned in this response.

Examples

cURL — Basic

curl -H "Authorization: Bearer $JWT" \
  'https://api.coinbase.com/api/v3/brokerage/accounts'

Example Response

{
  "accounts": [
    {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "BTC Wallet",
      "currency": "BTC",
      "available_balance": {
        "value": "0.5",
        "currency": "BTC"
      },
      "default": true,
      "active": true,
      "created_at": "2023-01-15T10:30:00Z",
      "updated_at": "2024-01-20T14:22:00Z",
      "type": "ACCOUNT_TYPE_CRYPTO",
      "ready": true,
      "hold": {
        "value": "0.1",
        "currency": "BTC"
      }
    },
    {
      "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "USD Wallet",
      "currency": "USD",
      "available_balance": {
        "value": "5000.00",
        "currency": "USD"
      },
      "default": true,
      "active": true,
      "created_at": "2023-01-15T10:30:00Z",
      "updated_at": "2024-01-20T14:22:00Z",
      "type": "ACCOUNT_TYPE_FIAT",
      "ready": true,
      "hold": {
        "value": "0",
        "currency": "USD"
      }
    }
  ],
  "has_next": false,
  "cursor": "",
  "size": 2
}