Get Account - Coinbase Developer Documentation

Get Account

curl --request GET \
  --url https://api.coinbase.com/api/v3/brokerage/accounts/{account_uuid} \
  --header 'Authorization: Bearer <token>'

{
  "account": {
    "uuid": "8bfc20d7-f7c6-4422-bf07-8243ca4169fe",
    "name": "BTC Wallet",
    "currency": "BTC",
    "available_balance": {
      "value": "1.23",
      "currency": "BTC"
    },
    "default": false,
    "active": true,
    "created_at": "2021-05-31T09:59:59.000Z",
    "updated_at": "2021-05-31T09:59:59.000Z",
    "deleted_at": "2021-05-31T09:59:59.000Z",
    "type": "FIAT",
    "ready": true,
    "hold": {
      "value": "1.23",
      "currency": "BTC"
    },
    "retail_portfolio_id": "b87a2d3f-8a1e-49b3-a4ea-402d8c389aca",
    "platform": "ACCOUNT_PLATFORM_CONSUMER"
  }
}

GET

api

brokerage

accounts

{account_uuid}

Get Account

curl --request GET \
  --url https://api.coinbase.com/api/v3/brokerage/accounts/{account_uuid} \
  --header 'Authorization: Bearer <token>'

{
  "account": {
    "uuid": "8bfc20d7-f7c6-4422-bf07-8243ca4169fe",
    "name": "BTC Wallet",
    "currency": "BTC",
    "available_balance": {
      "value": "1.23",
      "currency": "BTC"
    },
    "default": false,
    "active": true,
    "created_at": "2021-05-31T09:59:59.000Z",
    "updated_at": "2021-05-31T09:59:59.000Z",
    "deleted_at": "2021-05-31T09:59:59.000Z",
    "type": "FIAT",
    "ready": true,
    "hold": {
      "value": "1.23",
      "currency": "BTC"
    },
    "retail_portfolio_id": "b87a2d3f-8a1e-49b3-a4ea-402d8c389aca",
    "platform": "ACCOUNT_PLATFORM_CONSUMER"
  }
}

Authorizations

Authorization

string

header

required

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

Path Parameters

account_uuid

string

required

The account's UUID.

Response

A successful response.

account

object

Show child attributes

account.uuid

string

Unique identifier for account.

Example:

"8bfc20d7-f7c6-4422-bf07-8243ca4169fe"

account.name

string

Name for the account.

Example:

"BTC Wallet"

account.currency

string

Currency symbol for the account.

Example:

"BTC"

account.available_balance

object

Available balance in the account.

Show child attributes

account.available_balance.value

string

required

Amount of currency that this object represents.

Example:

"1.23"

account.available_balance.currency

string

required

Denomination of the currency.

Example:

"BTC"

account.default

boolean

Whether or not this account is the user's primary account

Example:

false

account.active

boolean

Whether or not this account is active and okay to use.

Example:

true

account.created_at

string<RFC3339 Timestamp>

Time at which this account was created.

Example:

"2021-05-31T09:59:59.000Z"

account.updated_at

string<RFC3339 Timestamp>

Time at which this account was updated.

Example:

"2021-05-31T09:59:59.000Z"

account.deleted_at

string<RFC3339 Timestamp>

Time at which this account was deleted.

Example:

"2021-05-31T09:59:59.000Z"

account.type

enum<string>

default:ACCOUNT_TYPE_UNSPECIFIED

What type the account is.

Available options:

ACCOUNT_TYPE_UNSPECIFIED,

ACCOUNT_TYPE_CRYPTO,

ACCOUNT_TYPE_FIAT,

ACCOUNT_TYPE_VAULT,

ACCOUNT_TYPE_PERP_FUTURES

Example:

"FIAT"

account.ready

boolean

Whether or not this account is ready to trade.

Example:

true

account.hold

object

Amount that is being held for pending transfers against the available balance.

Show child attributes

account.hold.value

string

required

Amount of currency that this object represents.

Example:

"1.23"

account.hold.currency

string

required

Denomination of the currency.

Example:

"BTC"

account.retail_portfolio_id

string

The ID of the portfolio this account is associated with.

Example:

"b87a2d3f-8a1e-49b3-a4ea-402d8c389aca"

account.platform

enum<string>

default:ACCOUNT_PLATFORM_UNSPECIFIED

Platform indicates if the account is for spot (CONSUMER), US Derivatives (CFM_CONSUMER), or International Exchange (INTX).

Available options:

ACCOUNT_PLATFORM_UNSPECIFIED,

ACCOUNT_PLATFORM_CONSUMER,

ACCOUNT_PLATFORM_CFM_CONSUMER,

ACCOUNT_PLATFORM_INTX

Example:

"ACCOUNT_PLATFORM_CONSUMER"

Welcome to Coinbase Advanced Trade API

List Accounts

⌘I

REST API

Authorizations

Path Parameters

Response