Skip to main content

​
Overview

Deposit Destinations allow you to manage where funds can be deposited into your accounts.

​
Crypto destinations

Crypto deposit destinations are cryptocurrency addresses that you can generate via the API. Once created, these addresses can receive cryptocurrency payments on their specified network and will settle in your account balance. Key Features:
  • Generate unique crypto addresses for each account
  • Attach metadata to track the purpose or source of deposits
Supported Networks:
  • Base
  • Ethereum
  • Solana
  • Aptos
  • Arbitrum
  • Avalanche
  • Optimism
  • Polygon
  • Sui

​
Examples

Customer Deposits: Generate a unique deposit address for each customer to track their deposits separately: 
{
  "accountId": "account_456",
  "type": "crypto",
  "network": "base",
  "metadata": {
    "customer_id": "123e4567-e89b-12d3-a456-426614174000",
    "reference": "789"
  }
}
Invoice Payments: Create deposit addresses tied to specific invoices: 
{
  "accountId": "account_456",
  "type": "crypto",
  "network": "ethereum",
  "metadata": {
    "invoice_id": "12345",
    "order_id": "67890"
  }
}

​
Metadata

You can attach metadata to any crypto deposit destination you create to track the purpose or source of deposits. This metadata helps you identify and reconcile incoming payments in your system.
Temporary Restriction: Metadata values must currently be in UUID format or integer string format. Free-form metadata values will be supported in a future release.
Example: 
{
  "depositDestinationId": "depositDestination_123",
  "accountId": "account_456",
  "type": "crypto",
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "network": "base",
  "metadata": {
    "customer_id": "123e4567-e89b-12d3-a456-426614174000",
    "order_id": "12345",
    "invoice_number": "98765"
  }
}

​
Filtering and listing

Use the list endpoint to retrieve all deposit destinations. You can filter by Account ID to see deposit destinations for a specific account. Example: 
GET /v2/deposit-destinations?accountId=account_123

​
Unsupported assets

Only send supported assets to your deposit destinations. Sending unsupported assets or using unsupported networks may result in loss of funds.If you accidentally send unsupported crypto, you may be able to recover it using Coinbase’s asset recovery service.