Wallet API
Manage wallets for on-chain transactions and payments. Supports both session-based wallets and Coinbase Developer Platform (CDP) wallets.Get wallet
Response (CDP configured)
Response (user wallet exists)
Response (no wallet)
Errors
Wallet actions
Request body
Action: create
Creates a new wallet for the authenticated user.
400 if a wallet already exists.
Action: get_seed
Returns wallet metadata. Private keys are stored encrypted server-side and are never exposed.
Action: export_seed
Seed export is disabled for security. Returns 403.
Errors
Get CDP wallet address
Response (authenticated)
Response (not authenticated)
When the CDP wallet address cannot be retrieved, the response includesauthenticated: false and needsAuth: true. The remaining fields vary by failure reason:
error and setup fields instead of message: