The v2 Wallet API is currently in Beta. Reach out in the #wallet-api channel of the CDP Discord for any questions or fill out this form to schedule a call with a CDP team member.

​
Overview

The v2 Wallet API enables developers to programmatically create, manage, and use crypto accounts while CDP secures the private keys and handles complex infrastructure management. Developers can access the v2 Wallet API through either the CDP SDK or CDP’s REST endpoints.

With the v2 Wallet API, you can execute token swaps directly from your CDP accounts, combining the power of our Swap APIs with secure transaction signing. This allows you to discover the best prices, create swap quotes, and execute trades in a single call.

The following table summarizes the key differences between v1 and v2 Wallet APIs:

Featurev1 Wallet API 🔴v2 Wallet API 🟢
Security managementComplexEasy
Private key securityDeveloper-managedSecured in AWS Nitro Enclave TEE
AuthenticationOne secret per accountSingle secret for all accounts
Network supportEVM onlyEVM and Solana
EVM account scopeSingle EVM networkMultiple EVM networks
Transaction batching-✅
Gas sponsorship-✅
Spend permissions-✅
Viem compatibility-✅

​
Secure key management

Instead of securing your own private keys or needing to set up Server-Signer infrastructure, the v2 Wallet API greatly simplifies crypto key management by signing all of your transactions within a Trusted Execution Environment (TEE).

The TEE ensures that sensitive cryptographic material is never exposed to the outside world - not even to Coinbase!

The Trusted Execution Environment (TEE) provides a secure environment for signing your transactions, and ensures that your private keys are never exposed to Coinbase, AWS, or the outside world. Read more in our Security documentation.

​
Single secret authentication

In the v2 Wallet API, a single Wallet Secret grants access to all of your accounts across both the EVM and Solana ecosystems. This single secret is used for sensitive wallet operations, such as account creation and transaction signing.

​
Rotatable Wallet Secret

In case your Wallet Secret is lost or compromised, you can rotate your secret at any time.

​
Multi-network support

Rather than limiting usage to a single EVM network, EVM accounts created using the v2 Wallet API are compatible across all EVM chains.

The v2 Wallet API also supports Solana accounts, allowing you to create and manage Solana accounts in addition to EVM accounts.

​
Smart accounts

The v2 Wallet API supports EIP-4337 smart accounts, which provide the following advanced features via smart contract calls:

​
viem compatibility

EVM Accounts in the v2 Wallet API can be used directly with viem as custom accounts. This allows you to leverage viem’s widely-used abstractions seamlessly with the CDP SDK. Refer to the viem compatibility guide for more details.

​
CDP-managed swaps

The v2 Wallet API integrates with our Swap APIs to enable seamless token swaps directly from your CDP accounts using Coinbase infrastructure. This integration combines price discovery, quote creation, and transaction execution into a single call, while maintaining the flexibility to use your own wallet and node if preferred. Learn more in the Wallet API Swaps guide or the Swap API overview.

​
Support and feedback

Join #wallet-api in the CDP Discord to access FAQs, schedule project discussions, and connect with other developers. We welcome your feedback and suggestions for improvement.

​
Video: Watch and learn

Explore comprehensive video resources to learn about CDP Wallet API v2 features and see real-world implementations:

  • Quickstart: Create onchain accounts and send funds within minutes using the v2 Wallet API.
  • Security: Learn about new security features and how the v2 Wallet API protects your private keys.
  • Accounts: Descriptions of v2-supported account types and how to use them.
  • API Reference: Full API reference for the v2 Wallet API.