Skip to main content
GET
/
v2
/
accounts
/
{accountId}
/
balances
/
{asset}
Get balance for account
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/accounts/{accountId}/balances/{asset} \
  --header 'Authorization: Bearer <token>'
{
  "asset": {
    "symbol": "btc",
    "type": "crypto",
    "name": "Bitcoin",
    "decimals": 8
  },
  "amount": {
    "btc": {
      "available": "2.5",
      "total": "3.0"
    },
    "usd": {
      "available": "252705.4",
      "total": "303246.48"
    }
  }
}

Authorizations

​
Authorization
string
header
required

A JWT signed using your CDP API Key Secret, encoded in base64. Refer to the Generate Bearer Token section of our Authentication docs for information on how to generate your Bearer Token.

Path Parameters

​
accountId
string
required

The unique identifier of the account. The ID of the Account, which is a UUID prefixed by the string account_.

Pattern: ^account_[a-f0-9\-]{36}$
Example:

"account_af2937b0-9846-4fe7-bfe9-ccc22d935114"

​
asset
string
required

The symbol of the asset. The symbol of the asset (e.g., eth, usd, usdc, usdt).

Required string length: 1 - 42
Example:

"usd"

Response

Successfully got balance.

A balance of an asset.

​
asset
object
required

An asset, e.g. fiat or crypto.

Example:
{
  "symbol": "btc",
  "type": "crypto",
  "name": "Bitcoin",
  "decimals": 8
}
​
amount
object
required

Amount details denominated in different assets.

  • The keys represent the asset symbols (e.g., "btc", "usd"), - Each value contains available and total amounts. - There will always be an entry for the asset specified in the asset field.