> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cdp.coinbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sandbox: Deposit Destinations

## 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.

<Note>
  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.
</Note>

<Warning>
  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.
</Warning>

## Prerequisites

The following instructions use `cdpcurl` and a Sandbox API key. Install [cdpcurl](https://github.com/coinbase/cdpcurl#homebrew) to begin.

## Programmatically

### 1. Create a deposit destination

Create a [deposit destination](/api-reference/v2/rest-api/deposit-destinations/create-deposit-destination):

```bash theme={null}
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'
```

<Accordion title="Example response">
  ```json theme={null}
  {
    "depositDestinationId": "dd_abc123...",
    "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "network": "base",
    "asset": "usdc",
    "accountId": "account_db458f63-418a-4a91-a045-fab93ac35c3f",
  }
  ```
</Accordion>

### 2. List your deposit destinations

See all deposit destinations for an account:

```bash theme={null}
cdpcurl -k $CDP_API_KEY \
  'https://sandbox.cdp.coinbase.com/platform/v2/deposit-destinations?accountId=YOUR_ACCOUNT_ID'
```

<Accordion title="Example response">
  ```json theme={null}
  {
    "depositDestinations": [
      {
        "depositDestinationId": "dd_abc123...",
        "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "network": "base",
        "asset": "usdc",
        "accountId": "account_db458f63-418a-4a91-a045-fab93ac35c3f",
      }
    ]
  }
  ```
</Accordion>

### 3. Simulate a deposit

Simulate an incoming deposit to test webhook integration and balance updates.

The following example simulates an external sender depositing funds to a created deposit destination:

```bash theme={null}
cdpcurl -k $CDP_API_KEY \
  -X POST \
  -d '{
    "deposit_address": "<DEPOSIT_DESTINATION_ADDRESS>",
    "amount": "100.00",
    "asset_symbol": "usdc",
    "network": "base"
  }' \
  'https://sandbox.cdp.coinbase.com/fake/deposit/crypto'
```

<Note>
  The `asset_symbol` and `network` should match the configuration of that deposit destination.
</Note>

<Accordion title="Example response">
  ```json theme={null}
  {
    "transfer_id": "transfer_b340437d-4705-446f-8852-2345c83ace60",
    "created_at": "2026-02-24T03:12:10.077Z"
  }
  ```
</Accordion>

**What happens when you simulate a deposit:**

1. **Webhook events fire:**
   * `payment.transfer.processing`
   * `payment.transfer.completed`

2. **Transfer records are created:**
   * Appear in the [List Transfers](/api-reference/v2/rest-api/transfers/list-transfers) API

3. **Balance is credited:**
   * The account balance updates immediately

<Info>
  Use simulated deposits to test webhook integration, reconciliation flows via the Transfers API, or balance updates.
</Info>

## Using Portal UI

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

### 1. Create a deposit address

<Steps>
  <Step title="Navigate to Accounts">
    Go to the [Accounts page](https://portal.cdp.coinbase.com/v2/sandbox) in the CDP Portal Sandbox
  </Step>

  <Step title="Select an account">
    Click on the account row you want to manage to open the Account details page
  </Step>

  <Step title="Open Deposit addresses tab">
    Select the **Deposit addresses** tab. Your existing deposit addresses are listed here.
  </Step>

  <Step title="Create a new deposit address">
    Click the **Create deposit address** button in the upper-right corner
  </Step>

  <Step title="Configure the address">
    Select the account and network for your deposit address
  </Step>

  <Step title="Create address">
    Click **Create address**. On success, you'll see a message: "Deposit address created"
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/coinbase-prod/qQT7x5V3dVP4DCe3/images/payment-apis-deposit-addresses.png?fit=max&auto=format&n=qQT7x5V3dVP4DCe3&q=85&s=dddbcdf8972ba8417746dbcaec09b9c3" alt="Deposit addresses tab showing list of deposit addresses" width="560" height="354" data-path="images/payment-apis-deposit-addresses.png" />
</Frame>

### 2. Simulate a deposit

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.

<Steps>
  <Step title="Navigate to Deposit addresses">
    From your account details page, go to the **Deposit addresses** tab where your addresses are listed
  </Step>

  <Step title="Click Deposit">
    Click **Deposit** under the Action column for the deposit address you want to test
  </Step>

  <Step title="Enter amount">
    Enter the amount you want to deposit to the deposit address

    <Frame>
      <img src="https://mintcdn.com/coinbase-prod/qQT7x5V3dVP4DCe3/images/payment-apis-deposit-sim.png?fit=max&auto=format&n=qQT7x5V3dVP4DCe3&q=85&s=cb4638f4b150973aeef8934ea5ec2851" alt="Simulating a test deposit in the CDP Portal" width="476" height="467" data-path="images/payment-apis-deposit-sim.png" />
    </Frame>
  </Step>

  <Step title="Deposit now">
    Click **Deposit now** to simulate the deposit. On success, a modal will appear with your transfer details.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/coinbase-prod/qQT7x5V3dVP4DCe3/images/payment-apis-deposit-sim-tx-details.png?fit=max&auto=format&n=qQT7x5V3dVP4DCe3&q=85&s=8fb93a28bdd603ec9e1526ac52a41d8b" alt="Transfer details page showing completed deposit with timeline" width="795" height="450" data-path="images/payment-apis-deposit-sim-tx-details.png" />
</Frame>

**What happens when you simulate a deposit:**

1. **Webhook events fire:**
   * `payment.transfer.processing`
   * `payment.transfer.completed`

2. **Transfer records are created:**
   * Appear in the [List Transfers](/api-reference/v2/rest-api/transfers/list-transfers) API

3. **Balance is credited:**
   * The account balance updates immediately

<Info>
  Use simulated deposits to test webhook integration, reconciliation flows via the Transfers API, or balance updates.
</Info>

## What to read next

<CardGroup cols={2}>
  <Card title="Create Deposit Destination" icon="plus" href="/api-reference/v2/rest-api/deposit-destinations/create-deposit-destination">
    API reference for creating deposit destinations
  </Card>

  <Card title="List Deposit Destinations" icon="list" href="/api-reference/v2/rest-api/deposit-destinations/list-deposit-destinations">
    API reference for listing deposit destinations
  </Card>
</CardGroup>