Overview
CDP offers two distinct sets of APIs that serve different use cases:- Self-custody APIs: EVM accounts, Solana accounts, Embedded Wallets, Onramp, and related tools. Available to any CDP entity immediately after signing up.
- Custodial APIs: Transfers between custodied accounts, trading orders, payment acceptance, financial reporting, and more. These require a verified business account linked to CDP.
How to onboard
Create a CDP entity
Sign up at portal.cdp.coinbase.com and create your entity. At this point you have access to the self-custody APIs only.
Sign up for Coinbase Prime or Coinbase Business
- Coinbase Business: Sign up at coinbase.com/business if you are a small to mid-sized business.
- Coinbase Prime: Apply at prime.coinbase.com if you are a large organization or institution.
Link your account to CDP to leverage the custodial API endpoints
Once your Prime or Business account is approved, switch to CDP and navigate to the Accounts page in the CDP portal:
- Click Link account.
- Select the accounts you want to make available in CDP.
API endpoints requiring business onboarding
Accounts
Accounts represent custodied assets in CDP. You can create accounts directly via the CDP API, or link existing accounts from Coinbase Prime or Coinbase Business.| Method | Endpoint | Description |
|---|---|---|
GET | /v2/accounts | List all accounts |
POST | /v2/accounts | Create an account |
GET | /v2/accounts/{accountId} | Get an account by ID |
GET | /v2/accounts/{accountId}/balances | List balances for an account |
GET | /v2/accounts/{accountId}/balances/{asset} | Get balance for a specific asset |
GET | /v2/accounts/{accountId}/network-capabilities | Get network capabilities for an account |
GET | /v2/accounts-with-link-status | List accounts with their link status |
GET | /v2/accounts/linkable | List Prime or Business accounts available to link |
POST | /v2/accounts/link | Link a Prime or Business account to CDP |
POST | /v2/accounts/{accountId}/unlink | Unlink an account from CDP (Prime only) |
Deposit Destinations
Inbound deposit addresses attached to your accounts, used to receive crypto from external sources.| Method | Endpoint | Description |
|---|---|---|
GET | /v2/deposit-destinations | List deposit destinations |
POST | /v2/deposit-destinations | Create a deposit destination |
GET | /v2/deposit-destinations/{depositDestinationId} | Get a deposit destination by ID |
Transfers
Move funds between your accounts.| Method | Endpoint | Description |
|---|---|---|
POST | /v2/transfers | Create a transfer |
GET | /v2/transfers | List transfers |
GET | /v2/transfers/{transferId} | Get a transfer by ID |
POST | /v2/transfers/{transferId}/execute | Execute a quoted transfer |
POST | /v2/transfers/{transferId}/travel-rule | Submit travel rule information for a deposit |
Payment Methods
External financial instruments (Fedwire, SWIFT, SEPA) linked to your Prime accounts. Currently only supported for Coinbase Prime.| Method | Endpoint | Description |
|---|---|---|
GET | /v2/payment-methods | List payment methods |
GET | /v2/payment-methods/{paymentMethodId} | Get a payment method by ID |