SUPAH API Documentation

⚡ How It Works — x402 Micropayments

💰 Pay-Per-Call with USDC on Base

SUPAH API uses the x402 protocol — no API keys, no subscriptions, no sign-up. Just make an HTTP request, pay with USDC on Base chain, and get your data. Like putting a coin in a vending machine.

1️⃣

Make a Request

Call any paid endpoint normally

2️⃣

Get 402 Response

Server returns payment details (amount, address, network)

3️⃣

Pay with USDC

Sign a USDC payment on Base (automated by x402 SDK)

4️⃣

Get Data

Receive your intelligence instantly

💰 Pricing — Per-Call (USDC on Base)

Tier	Price	Endpoints
🆓 Free	$0.00	`/demo/safety/:addr` · `/demo/price/:addr` · `/demo/trending` · `/demo/signals`
⚡ Basic	$0.001	`/price` · `/metadata` · `/pairs` · `/trending`
🔮 Standard	$0.005 – $0.01	`/safety` · `/holders` · `/transfers` · `/swaps` · `/whale-moves` · `/approvals` · `/wallet-history` · `/net-worth` · `/signals/history`
👑 Premium	$0.02 – $0.05	`/scan` · `/signals` · `/discovery` · `/analytics` · `/portfolio` · `/wallet-pnl` · `/defi`

Full manifest: api.supah.ai/.well-known/x402-manifest.json

🆓 Free Demo Endpoints — No Wallet Needed

Try the API instantly — no payment, no sign-up. Demo endpoints return real data.

# Safety score for any Base token (free) curl https://api.supah.ai/agent/v1/demo/safety/0x532f27101965dd16442E59d40670FaF5eBB142E4 # Current price (free) curl https://api.supah.ai/agent/v1/demo/price/0x532f27101965dd16442E59d40670FaF5eBB142E4 # Trending tokens on Base (free) curl https://api.supah.ai/agent/v1/demo/trending # Latest trading signals (free) curl https://api.supah.ai/agent/v1/demo/signals

🌐 Base URL

https://api.supah.ai/agent/v1 (all endpoints — paid via x402) https://api.supah.ai/agent/v1/demo (free demo endpoints)

🛠️ Code Examples

JavaScript (with x402 SDK)

import { paymentMiddleware } from "x402-axios"; import axios from "axios"; // Create x402-enabled client (auto-handles 402 → pay → retry) const client = axios.create(); client.use(paymentMiddleware({ wallet: yourWallet })); // Just call the endpoint — payment happens automatically const { data } = await client.get( "https://api.supah.ai/agent/v1/safety/0x532f..." ); console.log(data); // Full safety report

MCP Server (Claude / Cursor / AI Agents)

# Install and run as MCP tool npx supah-mcp # Or add to Claude Desktop config: { "mcpServers": { "supah": { "command": "npx", "args": ["supah-mcp"] } } }

Published on npm: npmjs.com/package/supah-mcp

❌ Error Handling

{
  "error": "Payment required",
  "code": 402,
  "x402": {
    "amount": "0.01",
    "currency": "USDC",
    "network": "base",
    "payTo": "0x..."
  }
}
            

Status	Meaning
`200`	Success — data returned
`400`	Invalid address or parameters
`402`	Payment required — use x402 SDK to auto-pay
`500`	Server error — try again

🛡️ Token Safety

GET /api/v1/safety/:address Free

Get a comprehensive safety score for any Base chain token. Includes GoPlus audit, deployer analysis, risk flags, and honeypot detection.

Parameter	Type	Description
`address` required	string	Token contract address (0x...)

Example response:

{ "success": true, "token": { "address": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed", "name": "DEGEN", "symbol": "DEGEN" }, "safety": { "score": 72, "label": "CAUTION", "riskFlags": ["deployer_serial_deployer"], "honeypot": false, "buyTax": "0%", "sellTax": "0%" }, "deployer": { "address": "0x...", "totalDeploys": 15, "rugCount": 2, "riskLevel": "medium" } }

GET /api/v1/analyze/:address Pro

Deep analysis including safety score, on-chain metrics, liquidity health, holder distribution, and trading activity. The full intelligence report.

Parameter	Type	Description
`address` required	string	Token contract address

// Includes everything from /safety plus: { "metrics": { "marketCap": 15420000, "liquidity": 890000, "volume24h": 2340000, "holders": 4521, "buyersVsSellers": 1.8 }, "activity": { "uniqueWallets24h": 342, "experiencedBuyers": 12, "smartMoneyPresent": true } }

GET /api/v1/check/:address Free

Quick safety check — returns cached result if available, otherwise runs a fresh scan. Faster than /safety for known tokens.

POST /api/v1/batch Pro+

Scan up to 20 tokens in a single request. Parallel execution with per-token error isolation. Perfect for portfolio monitoring or DEX aggregators.

Parameter	Type	Description
`addresses` required	string[]	Array of token contract addresses (max 20)

// Request curl -X POST https://api.supah.ai/api/v1/batch \ -H "X-API-Key: YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"addresses": ["0x4ed4...", "0x532f..."]}' // Response { "results": [ { "address": "0x4ed4...", "name": "DEGEN", "score": 72, "label": "CAUTION" }, { "address": "0x532f...", "name": "BRETT", "score": 54, "label": "RISKY" } ], "errors": [], "scanned": 2, "elapsed": "1.2s" }

📡 Trading Signals

GET /api/v1/signals/latest Pro

Get the latest trading signals generated by SUPAH's intelligence engine. Includes BUY, STRONG_BUY, and HOLD signals with conviction scores.

{
  "signals": [
    {
      "token": "0x...",
      "symbol": "EXAMPLE",
      "action": "STRONG_BUY",
      "score": 92,
      "confidence": "high",
      "source": "discovery_smartmoney",
      "timestamp": "2026-02-24T00:15:00Z"
    }
  ]
}
                

GET /api/v1/signals/history Pro

Historical signal data with outcome tracking. See which signals led to profits and which were avoided.

Parameter	Type	Description
`limit` optional	number	Results per page (default 20, max 100)
`action` optional	string	Filter: BUY, STRONG_BUY, SELL, HOLD

GET /api/v1/signals/stats Free

Signal performance statistics. Win rates, average returns, signal count by type. Transparent track record.

🧠 Intelligence

GET /api/v1/leaderboard Free

Safety leaderboard — the safest and riskiest tokens on Base, ranked by SUPAH's composite safety score.

🧩 Embeddable Widgets

🛠️ Resources

MCP supah-mcp (npm) Free to install

Use SUPAH as a tool in Claude, Cursor, OpenClaw, or any MCP-compatible AI agent. All 20+ endpoints available as tools.

npx supah-mcp

npmjs.com/package/supah-mcp

GET /.well-known/x402-manifest.json Free

Machine-readable manifest of all endpoints, pricing, and payment details. Used by x402 clients and AI agents for auto-discovery.

curl https://api.supah.ai/.well-known/x402-manifest.json

⚡ Pay Per Call — No Subscription Needed

USDC micropayments on Base. Just call the API and pay for what you use.

🆓 Free Demo

4 demo endpoints
Real data
No wallet needed
Try right now ↑

Try Free →

💰 x402 API

$0.001+/call

20 paid endpoints
USDC on Base
No API keys
No rate limits
99.5% margin

How It Works →

🤖 MCP Server

npx

AI agent tool
Claude / Cursor
All endpoints
Auto-discovery

Install →

Questions? Ask on Telegram · Follow on X · Open Dashboard

⚡ SUPAH API Documentation

⚡ How It Works — x402 Micropayments

💰 Pay-Per-Call with USDC on Base

💰 Pricing — Per-Call (USDC on Base)

🆓 Free Demo Endpoints — No Wallet Needed

🌐 Base URL

🛠️ Code Examples

JavaScript (with x402 SDK)

MCP Server (Claude / Cursor / AI Agents)

❌ Error Handling

🛡️ Token Safety

GET /api/v1/safety/:address Free

GET /api/v1/analyze/:address Pro

GET /api/v1/check/:address Free

POST /api/v1/batch Pro+

📡 Trading Signals

GET /api/v1/signals/latest Pro

GET /api/v1/signals/history Pro

GET /api/v1/signals/stats Free

🧠 Intelligence

GET /api/v1/leaderboard Free

🧩 Embeddable Widgets

GET /api/v1/widget/safety?address=0x... Free

GET /api/v1/widget/embed?address=0x... Free

🛠️ Resources

MCP supah-mcp (npm) Free to install

GET /.well-known/x402-manifest.json Free

⚡ Pay Per Call — No Subscription Needed

🆓 Free Demo

💰 x402 API

🤖 MCP Server

⚡ SUPAH API Documentation

⚡ How It Works — x402 Micropayments

💰 Pay-Per-Call with USDC on Base

💰 Pricing — Per-Call (USDC on Base)

🆓 Free Demo Endpoints — No Wallet Needed

🌐 Base URL

🛠️ Code Examples

JavaScript (with x402 SDK)

MCP Server (Claude / Cursor / AI Agents)

❌ Error Handling

🛡️ Token Safety

GET /api/v1/safety/:address Free

GET /api/v1/analyze/:address Pro

GET /api/v1/check/:address Free

POST /api/v1/batch Pro+

📡 Trading Signals

GET /api/v1/signals/latest Pro

GET /api/v1/signals/history Pro

GET /api/v1/signals/stats Free

🧠 Intelligence

GET /api/v1/leaderboard Free

GET /api/v1/social-proof Free

🧩 Embeddable Widgets

GET /api/v1/widget/safety?address=0x... Free

GET /api/v1/widget/embed?address=0x... Free

🛠️ Resources

MCP supah-mcp (npm) Free to install

GET /.well-known/x402-manifest.json Free

⚡ Pay Per Call — No Subscription Needed

🆓 Free Demo

💰 x402 API

🤖 MCP Server