x402 Payments
x402 Payments
Section titled “x402 Payments”Cerebrus Pulse uses the x402 protocol for payments — an open standard for HTTP-native micropayments built on the 402 Payment Required status code.
How It Works
Section titled “How It Works”Client Pulse Gateway Base / Solana | | | | GET /pulse/BTC | | |--------------------------------->| | | | | | 402 Payment Required | | | + payment options (Base+Solana) | | |<---------------------------------| | | | | | Sign USDC payment | | | (x402 SDK picks your chain) | | |--------------------------------------------> USDC transfer | | | | | Retry request + payment proof | | |--------------------------------->| | | | Verify payment via facilitator| | |------------------------------->| | |<-------------------------------| | 200 OK + analysis data | | |<---------------------------------| |The x402 SDK in your HTTP client handles steps 2–4 automatically. From your perspective, it’s just a normal HTTP request that costs $0.01–$0.04. The 402 response includes payment options for both Base and Solana — your SDK picks whichever chain your wallet is configured for.
Supported Networks
Section titled “Supported Networks”Cerebrus Pulse accepts USDC payments on two chains. The 402 response includes payment options for both — your x402 SDK picks the right one based on your wallet.
| Property | Base (EVM) | Solana |
|---|---|---|
| Network ID | eip155:8453 | solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp |
| Currency | USDC | USDC |
| USDC Address | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 | EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v |
| Scheme | Exact EVM | Exact SVM |
| Facilitator | Coinbase CDP | Coinbase CDP |
| Gas/Fees | ~$0.001 ETH per tx | Gasless (CDP fee payer) |
Payment Details by Endpoint
Section titled “Payment Details by Endpoint”| Endpoint | Price | Description |
|---|---|---|
/screener | $0.04 USDC | Market-wide scan of 50+ coins |
/pulse/{coin} | $0.02 USDC | Multi-timeframe technical analysis |
/sentiment | $0.01 USDC | Market sentiment labels |
/funding/{coin} | $0.01 USDC | Funding rate analysis |
/oi/{coin} | $0.01 USDC | Open interest analysis |
/spread/{coin} | $0.008 USDC | Spread & liquidity analysis |
/correlation | $0.03 USDC | BTC-alt correlation matrix |
/arb | $0.02 USDC | Market Stress Index |
/cex-dex/{token} | $0.01 USDC | CEX-DEX price divergence |
/bundle/{coin} | $0.04 USDC | Combined bundle (17% discount) |
/health | Free | Gateway status |
/coins | Free | List available coins |
Why x402?
Section titled “Why x402?”- No API keys — Your wallet address is your identity. No registration, no accounts.
- No subscriptions — Pay only for what you use. One query = one micropayment.
- Instant settlement — Payments settle on Base (fast, cheap L2) or Solana (sub-second finality).
- Open standard — x402 is an open protocol. Any x402-compatible client works.
- Transparent pricing — The 402 response includes exact payment details before you pay.
Wallet Requirements
Section titled “Wallet Requirements”You need a wallet with USDC on either chain:
Option A: Base (EVM)
Section titled “Option A: Base (EVM)”- USDC on Base — For payments (as little as $1 gets you 50+ pulse queries)
- A small amount of ETH on Base — For gas fees (typically < $0.001 per transaction)
Getting USDC on Base:
- Bridge from Ethereum mainnet via the Base Bridge
- Purchase directly on exchanges that support Base withdrawals (Coinbase, Binance)
- Use a cross-chain bridge (Across, Stargate)
Option B: Solana
Section titled “Option B: Solana”- USDC on Solana — Same pricing, same endpoints
- No SOL needed for gas — The CDP facilitator sponsors transaction fees
Getting USDC on Solana:
- Purchase directly on exchanges that support Solana withdrawals (Coinbase, Phantom, Jupiter)
- Swap on Jupiter or Raydium
SDK Options
Section titled “SDK Options”Python
Section titled “Python”pip install "x402[evm]" httpx # For Basepip install "x402[svm]" httpx # For SolanaSee the Python SDK Guide for full integration details.
TypeScript / Node.js
Section titled “TypeScript / Node.js”npm install x402 viem # For Basenpm install x402 @solana/web3.js # For SolanaSee the TypeScript SDK Guide for full integration details.
Budget Controls
Section titled “Budget Controls”The x402 SDKs support budget limits to prevent accidental overspending:
# Python — the SDK supports per-request and global limits# Configure in your client setupAt Pulse prices ($0.01–$0.04 per query), $10 of USDC gives you 250–1000 API calls.
Security
Section titled “Security”- Payments use EVM or SVM signatures — your private key never leaves your machine
- The x402 facilitator (Coinbase CDP) verifies payments on-chain for both Base and Solana
- Pulse never sees your private key — only the signed payment proof
- All paid endpoints are rate-limited to prevent abuse
- Solana transactions use CDP’s fee payer — no SOL needed for gas
Related
Section titled “Related”- Quickstart — End-to-end first API call in 5 minutes
- Python SDK Guide — Full Python integration with async patterns
- TypeScript SDK Guide — Full TypeScript/Node.js integration
- Rate Limits — Request limits and throttling behavior