n8n-nodes-coinbase-cdp

This is an n8n community node for Coinbase CDP (Developer Platform) with two powerful nodes:

• Coinbase CDP (Advanced Trade API v3) - For trading, portfolios, and market data
• Coinbase Server Wallet (API v2) - For wallet operations, deposits, withdrawals, and blockchain interactions (EVM & Solana)

Installation

Community Nodes (Recommended)

Install directly from n8n:

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-coinbase-cdp
4. Click Install

Manual Installation

For local development or self-hosted n8n:

npm install n8n-nodes-coinbase-cdp

In n8n, search for "Coinbase" to find both nodes.

Features

• 🔐 Secure Authentication: Dual credential system for Advanced Trade and Server Wallet APIs
• 📊 Complete API Coverage: Generated from official Coinbase OpenAPI specifications
• 🌐 Multi-Environment: Supports both Production and Sandbox environments
• ⚡ Two Powerful Nodes:
  • Coinbase CDP: Trading, portfolios, orders, market data
  • Coinbase Server Wallet: EVM & Solana wallets, deposits, withdrawals, smart accounts
• 🔗 Blockchain Support: Ethereum, Base, Arbitrum, Polygon, Solana networks

Authentication

Coinbase CDP API (Advanced Trade)

This node uses Coinbase Developer Platform (CDP) API keys with ES256 JWT authentication.

Getting Your API Keys

1. Go to Coinbase Developer Platform
2. Create a new API key
3. Download the private key (.pem file)
4. Copy the API Key Name (format: organizations/{org_id}/apiKeys/{key_id})

Setting Up Credentials in n8n

1. In n8n, create new credentials: Coinbase CDP API
2. Enter your CDP API Key Name
3. Paste your EC Private Key (see formats below)
4. Select Environment (Production or Sandbox)
5. Click Save and test the connection

Private Key Format

The private key can be provided in two formats:

Multi-line format (recommended):

-----BEGIN PRIVATE KEY-----
MIGHAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBG0wawIBAQQg...
-----END PRIVATE KEY-----

.env format (single-line with literal \n):

-----BEGIN PRIVATE KEY-----\nMIGHAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBG0wawIBAQQg...\n-----END PRIVATE KEY-----

Both SEC1 (BEGIN EC PRIVATE KEY) and PKCS8 (BEGIN PRIVATE KEY) formats are supported.

Coinbase Server Wallet API (Wallet Operations)

This node uses two-layer JWT authentication with Secret API Key and Wallet Secret.

Getting Your API Keys

1. Go to Coinbase Developer Platform
2. Create a Secret API Key for Server Wallet
3. Download the Secret API Key private key (.pem file)
4. Create or export your Wallet Secret private key
5. Copy the Secret API Key Name

Setting Up Credentials in n8n

1. In n8n, create new credentials: Coinbase Server Wallet API
2. Enter your Secret API Key Name
3. Paste your Secret API Key (Private Key)
4. Paste your Wallet Secret (Private Key)
5. Click Save and test the connection

Note: Both private keys support multi-line and .env format (with literal \n).

Available Operations

Coinbase CDP Node (Advanced Trade API)

Full-featured node with all Coinbase Advanced Trade API operations:

• Portfolio: View balances, portfolios, and portfolio breakdown
• Accounts: List and manage trading accounts
• Orders: Create, cancel, and query orders
• Products: Get product information, candles, and market data
• Transactions: View transaction history
• Fees: Query transaction and fee summaries

Coinbase Server Wallet Node (Wallet API v2)

Comprehensive wallet operations for EVM and Solana blockchains:

EVM Operations (Ethereum, Base, Arbitrum, Polygon)

• Accounts: Create accounts, get balances, list accounts
• Transactions: Send transactions, sign transactions, get transaction status
• Smart Accounts: Create and manage smart contract accounts
• Token Operations: Token balances, token swaps
• Faucet: Request testnet tokens

Solana Operations

• Accounts: Create Solana accounts, get balances
• Transactions: Sign and send Solana transactions
• Token Operations: SPL token management

Additional Features

• Payments: Payment processing and confirmations
• Data: Blockchain data queries
• Onramp: Fiat-to-crypto onramp integration
• Policy Engine: Transaction policy management
• X402: Advanced wallet features

Example Workflows

Advanced Trade: Check Account Balance

1. Add Coinbase CDP node
2. Select Resource: Portfolio
3. Select Operation: List Portfolios
4. Execute to see all your portfolios

Advanced Trade: Place a Market Order

1. Add Coinbase CDP node
2. Select Resource: Orders
3. Select Operation: Create Order
4. Fill in order parameters (product, side, amount)
5. Execute to place the order

Server Wallet: Create EVM Account

1. Add Coinbase Server Wallet node
2. Select Resource: EVM Accounts
3. Select Operation: Create Account
4. Specify network (e.g., "base-sepolia")
5. Execute to create a new wallet account

Server Wallet: Send Transaction

1. Add Coinbase Server Wallet node
2. Select Resource: EVM Transactions
3. Select Operation: Send Transaction
4. Fill in: account address, recipient, amount, token
5. Execute to send the transaction

Server Wallet: Get Token Balance

1. Add Coinbase Server Wallet node
2. Select Resource: EVM Token Balances
3. Select Operation: Get Token Balances
4. Specify network and address
5. Execute to see all token balances

Troubleshooting

"Authorization failed" or 401 errors

1. Verify your API Key Name is correct (should include organizations/ and apiKeys/)
2. Ensure your private key is complete (includes -----BEGIN and -----END lines)
3. Check that your API key has the required permissions
4. Test the credential connection using the "Test" button in the credential modal

Private key format issues

If you get "Failed to parse EC private key":

• Make sure there are no extra spaces or characters
• If copying from a file, include the full key with header/footer
• Try converting literal \n to actual newlines or vice versa

Development

Local Development Setup

# Clone repository
git clone <your-repo-url>
cd n8n-nodes-coinbase-cdp

# Install dependencies
npm install

# Build
npm run build

# Link for local testing
npm link
cd ~/.n8n/custom
npm init -y
npm link n8n-nodes-coinbase-cdp

# Start n8n
n8n start

Commands

npm run build        # Build TypeScript and copy icons
npm run dev          # Watch mode for development
npm test             # Run tests
npm run format       # Format code with Prettier
npm run lint         # Lint code
npm run lintfix      # Fix linting issues

Tech Stack

• Built with TypeScript
• Generated from Coinbase Advanced Trade OpenAPI specification
• Uses @devlikeapro/n8n-openapi-node for OpenAPI integration
• JWT authentication with ES256 algorithm

Resources

• Coinbase Developer Platform Documentation
• Advanced Trade API Reference
• n8n Community Nodes Documentation

License

MIT

Support

For issues, questions, or contributions:

• Open an issue on GitHub
• Check existing issues for solutions
• Contribute via pull requests

Changelog

See CHANGELOG.md for version history and updates.