⚡ x402 — Pay Per Call with USDC on Base
Every call is a micro-payment. No API keys, no subscriptions, no commitments. Your agent pays automatically via the x402 protocol.
📡
1. Call Endpoint
Make a GET request to any endpoint
💰
2. Get 402
Server returns payment details + amount
🔐
3. Sign & Pay
Your agent signs USDC on Base automatically
📊
4. Get Data
Resend with payment proof → instant intelligence
# Step 1: Call any endpoint (no auth needed)
curl -s https://api.supah.ai/agent/v1/safety/0x40ba93835789b9958ed588308c299fa27ddc5838
# Step 2: Server responds with 402 + payment details
{ "accepts": [{ "maxAmountRequired": "10000", "network": "base", "asset": "USDC" }] }
# Step 3: Your x402 client handles payment automatically
# Step 4: Get your data!
🤖 AI Agent? It's Even Easier
# Python (with x402-python)
from x402.client import X402Client
client = X402Client(private_key="your_key", network="base")
result = client.get("https://api.supah.ai/agent/v1/safety/0x...")
# Node.js (with @coinbase/x402)
import { payForRequest } from '@coinbase/x402';
const paid = await payForRequest(url, response, wallet);
# MCP — add to Claude Desktop / Cursor
{ "mcpServers": { "supah": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.supah.ai/mcp"] } } }
🌐 Supported Chains
Most endpoints work across 21 EVM blockchains. Add ?chain=eth for Ethereum, ?chain=bsc for BNB Chain, etc. Default is always base.
Token data powered by Moralis · Safety scans powered by GoPlus · Best coverage where both ✅
| Chain Param |
Network |
Token Data |
Safety Scan |
Chain ID |
💡 Base-only endpoints: /signals, /discovery, /trending — these use SUPAH's proprietary pipeline data, exclusively on Base.
🚀 Quick Start — See It In Action
All endpoints use x402 micropayments. Here's what a real call looks like:
Example: Token Safety Check ($0.01)
# Request
curl -s https://api.supah.ai/agent/v1/safety/0x40ba93835789b9958ed588308c299fa27ddc5838
# Response (x402 payment required)
HTTP 402 — X-PAYMENT header required
→ x402 client handles USDC payment automatically
→ Data delivered after payment confirmation
# With x402 client — fully automatic
client.get("https://api.supah.ai/agent/v1/safety/0x40ba93835789b9958ed588308c299fa27ddc5838")
→ { "safetyScore": 82, "rating": "SAFE", "isHoneypot": false, ... }
🛡️ Safety Score — $0.01
Honeypot check, deployer profiling, sell simulation, risk flags, A-F rating.
GET /agent/v1/safety/:address
📊 Price Data — $0.005
Live price, volume, mcap, liquidity from DEX feeds.
GET /agent/v1/price/:address
🎯 Live Signals — $0.05
AI buy/sell signals with conviction scoring. Base-only alpha.
GET /agent/v1/signals
🔥 Degen Top 5 — $0.05
Top 5 plays on Base right now. AI-scored, security-gated.
GET /agent/v1/degen/top5
💰 New Competitive Pricing — Most Endpoints Cheaper Than a Single Moralis API Call
🚀 Ultra Cheap ($0.0005)
Basic token/wallet/NFT data, blocks, ENS resolution. Perfect for high-volume apps.
⚡ Competitive ($0.001)
Holders, transfers, swaps, whale moves, contract data. Beat the competition.
📊 Standard ($0.003)
OHLCV, price history, analytics, PnL, DeFi positions, portfolios.
🛡️ Proprietary Intelligence ($0.01-$0.03)
Safety scores, full scans, discovery, signals history, contract reviews.
🎯 Premium Signals ($0.05)
Live AI signals, Degen Top 5, Swing Watchlist Top 5. Exclusive alpha.
Most endpoints cheaper than a single Moralis API call resold. Premium endpoints deliver unique intelligence you can't get anywhere else.
🎯 Premium Endpoints — Exclusive Intelligence
These endpoints provide proprietary intelligence that you can't get anywhere else. Built from SUPAH's trading pipeline and portfolio data.
🛡️ Safety Score ($0.01)
GET /agent/v1/safety/:address
Multi-source security audit combining GoPlus, deployer profiling, honeypot detection, sell simulation, and liquidity analysis. Not just a number — actionable risk intelligence that protects your portfolio.
✓ Honeypot detection ✓ Sell simulation ✓ Deployer history ✓ Tax analysis ✓ Liquidity validation
🔍 Full Scan ($0.03)
GET /agent/v1/scan/:address
The complete intelligence package: safety + deployer history + liquidity depth + holder concentration + whale tracking in a single call. What takes 6 separate API calls elsewhere, delivered in one.
✓ Complete safety audit ✓ Price & volume data ✓ Holder analysis ✓ Liquidity metrics ✓ Risk verdict
🤖 Live Signals ($0.05)
GET /agent/v1/signals
AI-generated buy/sell signals from SUPAH's proprietary pipeline. Conviction-scored, TA-confirmed, security-gated. The same signals that drive real trades in our portfolio.
✓ Real trading signals ✓ Conviction scoring ✓ Technical analysis ✓ Risk filtering ✓ Base-only alpha
🔥 Degen Top 5 ($0.05)
GET /agent/v1/degen/top5
The 5 most interesting plays on Base right now. AI-scored from 100+ tokens scanned hourly — combining volume heat, price momentum, buy pressure ratios, wallet traction, and security gating into a single Degen Score. This is the alpha that Chaos Crew members pay to access.
✓ AI conviction scoring from real-time pipeline data
✓ Volume momentum + buy/sell pressure analysis
✓ Security-gated (GoPlus + deployer profiling, min 50/100)
✓ Unique wallet traction (who's actually trading)
✓ Liquidity depth validation
✓ Updated every scan cycle — true real-time alpha
📈 Swing Watchlist Top 5 ($0.05)
GET /agent/v1/swing/top5
The 5 most interesting mid-tier plays on Base, curated by SUPAH's AI swing trading engine. Not positions — watchlist intelligence. These are the tokens the engine is monitoring for optimal entry timing.
🔍 What's Monitored: 200+ established Base tokens ($100K-$500M mcap) scanned every 30 minutes. Real-time price feeds, volume dynamics (5m/1h/6h/24h), holder growth, liquidity depth, LP lock status, and smart money flow.
📊 Technical Analysis: Multi-timeframe TA on 4h and 1d candles — RSI (oversold/divergence), MACD (momentum crossovers), Bollinger Bands (squeeze/breakout), ADX (trend strength), SMA 20/50 (support/resistance), EMA 20, and Volume SMA. Best entries scored on dip-buying with bounce confirmation.
🌊 Market Sentiment Scaling: Entry thresholds dynamically adjust based on ETH weekly trend. Bull market → relaxed gates with wider stops (ride the wave). Bear market → strict gates with tight stops (capital preservation). Neutral → balanced approach. The engine doesn't fight the market — it surfs it.
🛡️ Security Gating: Every candidate passes GoPlus audit, deployer profiling, sell simulation, and LP verification before appearing on the watchlist. Safety score ≥60, token age ≥2 days, no honeypots.
Signals: SWING_BUY = highest conviction, all gates passed, TA confirms entry | SWING_WATCH = promising fundamentals, monitoring for optimal entry timing
🔮 Discovery ($0.03)
GET /agent/v1/discovery
Freshly discovered tokens with enrichment data — the pipeline's intake funnel. Early signal on what's emerging before the crowd notices.
✓ Fresh token discovery ✓ Early detection ✓ Safety pre-screening ✓ Volume filtering ✓ Base-exclusive
📊 Signal History ($0.01)
GET /agent/v1/signals/history
Historical signals with actual PnL outcomes. Backtest our conviction engine. See what we called, when, and how it played out.
✓ Historical performance ✓ Real PnL outcomes ✓ Signal backtesting ✓ Win rate analysis ✓ Conviction tracking
🛠️ Contract Review ($0.02)
GET /agent/v1/contract/:address/review
Deep contract audit with source verification, permission analysis, and risk assessment.
✓ Source code analysis ✓ Permission mapping ✓ Risk assessment ✓ Verification status ✓ Security flags
🔧 Integration Guide
Python (with x402-python)
from x402.client import X402Client
client = X402Client(
private_key="your_base_wallet_private_key",
network="base"
)
# Get token safety score — costs $0.01 USDC
result = client.get("https://api.supah.ai/agent/v1/safety/0x...")
print(result.json())
Node.js (with @coinbase/x402)
import { payForRequest } from '@coinbase/x402';
const url = 'https://api.supah.ai/agent/v1/safety/0x...';
const res = await fetch(url);
if (res.status === 402) {
// Sign USDC payment and retry with proof
const paid = await payForRequest(url, res, wallet);
const data = await paid.json();
console.log(data);
}
cURL (Manual x402)
# Step 1: Call endpoint — server responds with 402 + payment details
curl -i https://api.supah.ai/agent/v1/safety/0x40ba93835789b9958ed588308c299fa27ddc5838
# Step 2: Server returns payment requirements in JSON body
# Step 3: Sign USDC transfer on Base, attach X-PAYMENT header, retry
# For automated agents, use x402 client libraries
Payment Details
# Payment Info
Payments: Base mainnet (eip155:8453)
Data: 20+ EVM chains (add ?chain=eth for Ethereum, etc.)
Currency: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
PayTo: 0xD3B2eCfe77780bFfDFA356B70DC190C914511761
Protocol: x402 (https://www.x402.org)
Multi-Chain Usage
# Multi-Chain Examples
# Ethereum
curl "https://api.supah.ai/agent/v1/demo/safety/0xdAC17F958D2ee523a2206206994597C13D831ec7?chain=eth"
# Polygon
curl "https://api.supah.ai/agent/v1/demo/safety/0x2791bca1f2de4661ed88a30c99a7a9449aa84174?chain=polygon"
# BNB Chain
curl "https://api.supah.ai/agent/v1/demo/safety/0x55d398326f99059ff775485246999027b3197955?chain=bsc"
# Supported chains:
eth, polygon, bsc, avalanche, fantom, cronos, arbitrum, gnosis,
base, optimism, linea, moonbeam, moonriver, ronin, lisk, pulse,
mantle, blast, scroll, zksync, celo
# Base-only endpoints (proprietary SUPAH data):
/trending, /signals, /discovery
🤖 MCP Integration
Connect your AI agent (Claude, Cursor, etc.) to SUPAH via the Model Context Protocol. Discover endpoints, check pricing, and try demos — all from your agent's tool interface.
Add to Claude Desktop / Cursor
Add this to your MCP config file (claude_desktop_config.json or .cursor/mcp.json):
{
"mcpServers": {
"supah-agent-api": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.supah.ai/mcp"]
}
}
}
Available MCP Tools
# Tools your agent can use:
search_endpoints — Search API catalog by keyword
get_pricing — Full pricing table
get_chains — List all supported blockchain networks
get_endpoint_info — Detailed endpoint info + x402 price
Discovery Endpoint
curl -s https://api.supah.ai/mcp | jq .