Skip to main content

​
Overview

Deposit destinations are addresses where you can receive crypto payments. In Sandbox, these are placeholder addresses for API testing. They are not real blockchain addresses, and the Sandbox does not connect to any blockchain network.
In this guide, deposit destination and deposit address are used interchangeably. The API refers to the full resource as a “deposit destination,” while the Portal UI uses “deposit address” to refer to the same concept.
Deposit addresses are placeholders for testing only. Do not send real funds to Sandbox addresses as they don’t exist on any blockchain and your funds will be lost.

​
Prerequisites

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

​
1. Create a deposit destination

Create a deposit destination: 
cdpcurl -k $CDP_API_KEY \
  -X POST \
  -d '{
    "accountId": "YOUR_ACCOUNT_ID",
    "network": "base",
    "asset": "usdc"
  }' \
  'https://sandbox.cdp.coinbase.com/platform/v2/deposit-destinations'

{
  "depositDestinationId": "dd_abc123...",
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "network": "base",
  "asset": "usdc",
  "accountId": "account_db458f63-418a-4a91-a045-fab93ac35c3f",
  "createdAt": "2026-02-11T20:00:00Z"
}

​
2. List your deposit destinations

See all deposit destinations for an account: 
cdpcurl -k $CDP_API_KEY \
  'https://sandbox.cdp.coinbase.com/platform/v2/deposit-destinations?accountId=YOUR_ACCOUNT_ID'

{
  "depositDestinations": [
    {
      "depositDestinationId": "dd_abc123...",
      "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "network": "base",
      "asset": "usdc",
      "accountId": "account_db458f63-418a-4a91-a045-fab93ac35c3f",
      "createdAt": "2026-02-11T20:00:00Z"
    }
  ]
}

​
Using Portal UI

You can create deposit destinations and simulate deposits through the Portal UI.

​
1. Create a deposit address

1

Navigate to Accounts

Go to the Accounts page in the CDP Portal Sandbox
2

Select an account

Click on the account row you want to manage to open the Account details page
3

Open Deposit addresses tab

Select the Deposit addresses tab. Your existing deposit addresses are listed here.
4

Create a new deposit address

Click the Create deposit address button in the upper-right corner
5

Configure the address

Select the account and network for your deposit address
6

Create address

Click Create address. On success, you’ll see a message: “Deposit address created”
Deposit addresses tab showing list of deposit addresses

​
2. Simulate deposits

Simulate incoming deposits to test your webhook integration and balance updates. This simulates an external sender depositing funds to your deposit address, which then automatically credits your account balance.
1

Navigate to Deposit addresses

From your account details page, go to the Deposit addresses tab where your addresses are listed
2

Click Deposit

Click Deposit under the Action column for the deposit address you want to test
3

Enter amount

Enter the amount you want to deposit to the deposit address
Simulating a test deposit in the CDP Portal
4

Deposit now

Click Deposit now to simulate the deposit. On success, a modal will appear with your transfer details.
Transfer details page showing completed deposit with timeline
What happens when you simulate a deposit:
  1. Webhook events fire:
    • payment.transfer.processing
    • payment.transfer.completed
  2. Transfer records are created:
  3. Balance is credited:
    • The account balance updates immediately
Use simulated deposits to test webhook integration, reconciliation flows via the Transfers API, or balance updates.

Create Deposit Destination

API reference for creating deposit destinations

List Deposit Destinations

API reference for listing deposit destinations