Coinbase
Trade on Coinbase Exchange and operate CDP-managed wallets — two Coinbase APIs, one node family
coinbase-advanced-trade) places and manages orders on the Coinbase exchange — accounts, orders, fills, products, fees, converts, and portfolios. Server Wallet (coinbase-server-wallet) operates Coinbase Developer Platform (CDP) custodial wallets — EVM/Solana accounts, transfers, swaps, and spend policies — where Coinbase's TEE holds the private key, never this node. They share no code path and no credential: pick the section below that matches what you're building.
Quick Start
- Decide which API you need: Advanced Trade to buy/sell/hold crypto on the Coinbase exchange, or Server Wallet to create and move funds through a Coinbase-managed wallet.
- Add the matching node (
Coinbase Advanced TradeorCoinbase Server Wallet) to your workflow. - Set
resourceandoperation(see the tables below), plus acredentialIdpointing at a vault entry holding your CDP API Key ID + EC (P-256) private key. - Server Wallet only: fund-moving operations also need a
walletSecretCredentialId— see Configuration. - Run the workflow — every operation returns
items[]on success, or an error code + message on the Error port.
resource / operation / credentialId config shape and the same items[] output envelope. Learn the pattern once on Input & Output and every operation below follows it.
Pick a Section
Advanced Trade
24 operations across 7 resources — accounts, orders, fills, products, fees, converts, portfolios. Trades on the live Coinbase exchange.
Server Wallet
16 operations across 7 resources — EVM/Solana/smart accounts, transfers, swaps, policies, balances. Coinbase's TEE holds the key.
Pages in This Guide
Configuration
appsettings.json, both credentials, and dependency registration for both variants.
AT: Accounts
list, get — brokerage account balances.
AT: Orders
create, preview, cancel, list, get — place and manage exchange orders.
AT: Fills
list — executed trade fills.
AT: Products
list, get, getCandles, getMarketTrades, getBestBidAsk, getProductBook — market data.
AT: Fees
getTransactionSummary — your fee tier and volume.
AT: Converts
createQuote, commitTrade, getTrade — stablecoin/currency conversion.
AT: Portfolios
list, create, moveFunds, getBreakdown, edit, delete — sub-portfolio management.
SW: Networks
base, base-sepolia, and per-operation network defaults.
SW: Account (EVM)
getOrCreate, listBalances, requestFaucet.
SW: Solana Account
getOrCreate, requestFaucet.
SW: Smart Account
getOrCreate — ERC-4337 smart account owned by an EVM account.
SW: Transfer
sendNative, sendErc20 — move funds out of a wallet.
SW: Swap
execute, quote — token swaps inside a wallet.
SW: Policy
create, get, list, update, delete — spend/governance policies.
SW: Balance
listTokens — token balances for any address.
Input & Output
The shared config-key pattern, output envelope, and how errors surface.
Examples: Advanced Trade
Worked exchange-trading workflow patterns.
Examples: Server Wallet
Worked custodial-wallet workflow patterns.
Troubleshooting
Every error code from both variants and how to fix them.
Roadmap
What's implemented-but-unconfirmed, and what's next.
Core Concepts
Two APIs, Two Node Types
Unlike most community nodes, "Coinbase" here is not one API surface:
- Advanced Trade (
coinbase-advanced-trade) — Coinbase's exchange trading API (v3 brokerage). Buys, sells, and reads market data againstapi.coinbase.com. Single credential. - Server Wallet (
coinbase-server-wallet) — Coinbase Developer Platform's custodial Wallet-as-a-Service (v2), againstapi.cdp.coinbase.com. Coinbase's TEE (trusted execution environment) holds the actual private key; this node never constructs, receives, or stores one. Dual credential.
They are documented as two clearly separate sections throughout this guide because they don't share a credential, a base URL, a resource model, or an error taxonomy.
Resources
Both variants group operations by resource, matching each API's own service boundaries. See the Operation Summary tables below for the full map.
Advanced Trade Operations
Node type: coinbase-advanced-trade · 24 operations across 7 resources · single credential (CDP API key).
| Resource | Operation | Guide Page |
|---|---|---|
accounts | list, get | Accounts |
orders | create, preview, cancel, list, get | Orders |
fills | list | Fills |
products | list, get, getCandles, getMarketTrades, getBestBidAsk, getProductBook | Products |
fees | getTransactionSummary | Fees |
converts | createQuote, commitTrade, getTrade | Converts |
portfolios | list, create, moveFunds, getBreakdown, edit, delete | Portfolios |
Server Wallet Operations
Node type: coinbase-server-wallet · 16 operations across 7 resources · dual credential (CDP API key + Wallet Secret).
| Resource | Operation | Guide Page |
|---|---|---|
account | getOrCreate, listBalances, requestFaucet | Account (EVM) |
solanaAccount | getOrCreate, requestFaucet | Solana Account |
smartAccount | getOrCreate | Smart Account |
transfer | sendNative, sendErc20 | Transfer |
swap | execute, quote | Swap |
policy | create, get, list, update, delete | Policy |
balance | listTokens | Balance |