Skip to main content

Overview

Accounts are containers that hold assets and can be used for transacting. In Sandbox, create accounts through the Portal UI.
Sandbox accounts are isolated from production and do not require linking to any external Coinbase accounts.

Prerequisites

Before you begin, you need cdpcurl and a Sandbox API key. See the Quickstart for instructions.

1. List accounts

See all your Sandbox accounts:
cdpcurl -k $CDP_API_KEY \
  'https://sandbox.cdp.coinbase.com/platform/v2/accounts'
{
  "accounts": [
    {
      "accountId": "account_db458f63-418a-4a91-a045-fab93ac35c3f",
      "name": "My Test Account",
      "createdAt": "2026-02-11T20:00:00Z",
      "updatedAt": "2026-02-11T20:00:00Z"
    }
  ]
}
To get just your account IDs:
cdpcurl -k $CDP_API_KEY \
  'https://sandbox.cdp.coinbase.com/platform/v2/accounts' | sed '1d' | jq -r '.accounts[].accountId'

2. Get account details

View detailed account information including balances:
cdpcurl -k $CDP_API_KEY \
  'https://sandbox.cdp.coinbase.com/platform/v2/accounts/YOUR_ACCOUNT_ID'
{
  "accountId": "account_db458f63-418a-4a91-a045-fab93ac35c3f",
  "name": "My Test Account",
  "balances": [
    {
      "asset": "usd",
      "amount": "1000.00"
    },
    {
      "asset": "usdc",
      "amount": "500.00"
    }
  ],
  "createdAt": "2026-02-11T20:00:00Z",
  "updatedAt": "2026-02-11T23:00:00Z"
}

Using Portal UI

You can create, manage, and fund accounts through the Portal UI:
1

Access your account

Navigate to Portal Accounts in Sandbox
2

Create account

Name the account (e.g., “My Test Account”)
3

Edit test assets

Add a balance to your account. Currently we support USD, USDC, USDT (e.g., set USD to $1000)
Sandbox account showing test balances for USD, USDT, and USDC
Account funding is only available through the Portal UI. All balances are simulated within the Sandbox environment.