Skip to main content
GET
/
v2
/
coinbase-accounts
/
balances
List Coinbase account balances
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances \
  --header 'Authorization: Bearer <token>'
{
  "balances": [
    {
      "asset": {
        "symbol": "usdc",
        "type": "crypto",
        "name": "USD Coin",
        "decimals": 6
      },
      "amount": {
        "usdc": {
          "available": "50.00",
          "total": "100.00"
        }
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

A Coinbase OAuth Bearer token provided by the end user (payer). EntryGateway terminates the OAuth token and mints a scoped CAT (Coinbase Auth Token) JWT for downstream services.

Response

Successfully retrieved Coinbase account balances.

A list of balances for an account.

​
balances
object[]
required

The list of balances.

Example:
[
  {
    "asset": {
      "symbol": "btc",
      "type": "crypto",
      "name": "Bitcoin",
      "decimals": 8
    },
    "amount": {
      "btc": { "available": "2.5", "total": "3.0" },
      "usd": {
        "available": "252705.4",
        "total": "303246.48"
      }
    }
  }
]