GET /api/v3/brokerage/accounts/{account_uuid} — Get Account

GET /api/v3/brokerage/accounts/ — fetch a single trading account’s balance, hold, status, and metadata by its unique UUID.

The Get Account endpoint retrieves full details for a single trading account identified by its UUID. You can use this endpoint to check the current available balance, held funds, account status, and metadata for any specific wallet in your Coinbase Advanced Trade profile. Account UUIDs can be obtained from the List Accounts endpoint.

Endpoint

GET https://api.coinbase.com/api/v3/brokerage/accounts/{account_uuid}

Authentication

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

Authorization: Bearer $JWT

Path Parameters

account_uuid · string · required

The unique identifier (UUID) of the account to retrieve. Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890.

Response Fields

The response contains a single top-level account object with the following fields:

account · object

The account object for the requested UUID.

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.

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.

Examples

cURL

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

Example Response

{
  "account": {
    "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"
    }
  }
}