๐Ÿฆธ SUPAH Agent API

Multi-Chain Intelligence Oracle for AI Agents
50+
Endpoints
21
EVM Chains
$0.0005
Starting Price
USDC
x402 Payments

โšก Two Ways to Access

Choose your auth method: free API key (50 calls/day) or x402 USDC micropayments (unlimited, pay-per-call).

๐Ÿ”‘ Option 1: API Key (Recommended for Getting Started)

๐Ÿ“ง
1. Generate Key
POST /keys/generate with your email
๐Ÿ”‘
2. Add Header
Include X-API-Key in your requests
๐Ÿ“Š
3. Get Data
50 free calls/day. Contact us for higher limits.
# Generate your free API key
curl -X POST https://api.supah.ai/keys/generate \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'

# Use it
curl -H "X-API-Key: supah_your_key_here" \
  https://api.supah.ai/agent/v1/safety/0x...

๐Ÿ’ฐ Option 2: x402 USDC Micropayments (Unlimited)

๐Ÿ“ก
1. Call Endpoint
Make a GET request to any paid endpoint
๐Ÿ’ฐ
2. Get 402
Server returns HTTP 402 with payment details
๐Ÿ”
3. Sign & Pay
Your agent signs a USDC payment on Base
๐Ÿ“Š
4. Get Data
Resend request with payment proof โ†’ get intelligence

๐ŸŒ 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.

๐ŸŽฎ Free Demo โ€” Try It Now

These endpoints are completely free. No payment, no signup. Click "Try It" to see live data.

๐Ÿ’ฐ 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

๐Ÿ“ก All Paid Endpoints

๐Ÿ”ง 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 (Demo โ€” Free)

# Free demo endpoints โ€” no payment needed curl -s https://api.supah.ai/agent/v1/demo/safety/0x40ba...5838 | jq . curl -s https://api.supah.ai/agent/v1/demo/price/0x40ba...5838 | jq . curl -s https://api.supah.ai/agent/v1/demo/trending | jq .

Payment Details

# Payment Info Payments: Base mainnet (eip155:8453) Data: 20+ EVM chains (add ?chain=eth for Ethereum, etc.) Currency: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) PayTo: 0xD3B2eCfe77780bFfDFA356B70DC190C914521761 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 demo_safety โ€” Live safety score (free) demo_price โ€” Live token price (free) demo_trending โ€” Trending tokens (free)

Discovery Endpoint

curl -s https://api.supah.ai/mcp | jq .