SUPAH SUPAH
Home Directory API Docs Pricing Dashboard Telegram

⚡ SUPAH API Documentation

Token intelligence API for Base chain. Safety scores, deployer analysis, batch scanning, trading signals, and real-time alerts.

⚡ How It Works — x402 Micropayments

💰 Pay-Per-Call with USDC on Base

SUPAH API uses the x402 protocol. Inspect the live manifest, make the request, settle in Base USDC, and get your data. Like putting a coin in a vending machine that actually shows the price first.

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

Powered by Coinbase x402 Protocol — USDC payments on Base mainnet. No middlemen.

💰 Pricing — Per-Call (USDC on Base)

TierPriceEndpoints
⚡ 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

⚡ x402 Quick Start

SUPAH API charges per call with USDC on Base. The shortest route from curiosity to proof is the Starter Proof lane on app.supah.ai.

Starter Proof: Run the Base proof lane to see the live quote, pay-to wallet, and receipt logger in one route.
# Inspect live pricing + payment requirements curl https://api.supah.ai/.well-known/x402-manifest.json # Call a paid endpoint with an x402-aware client curl https://api.supah.ai/agent/v1/price/0x532f27101965dd16442E59d40670FaF5eBB142E4

🧾 Starter Proof Lane

Want the cleanest first conversion? Open the Base Account proof flow, copy the live quote, make one paid Base USDC call, and log the receipt so it can be reused in builder packets and partnership proof.

Open Base Account Flow Open API Reference

🌐 Base URL

https://api.supah.ai/agent/v1 (all endpoints — paid via x402) https://api.supah.ai/.well-known/x402-manifest.json (live pricing manifest)

🛠️ 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..." } }
StatusMeaning
200Success — data returned
400Invalid address or parameters
402Payment required — use x402 SDK to auto-pay
500Server error — try again

🛡️ Token Safety

GET /api/v1/safety/:address Tier 1

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

ParameterTypeDescription
address requiredstringToken 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.

                
                

                    
ParameterTypeDescription

                    
address requiredstringToken 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
                    Tier 1
                

                
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.

                
                

                    
ParameterTypeDescription

                    
addresses requiredstring[]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.

                
                

                    
ParameterTypeDescription

                    
limit optionalnumberResults per page (default 20, max 100)

                    
action optionalstringFilter: BUY, STRONG_BUY, SELL, HOLD

                

            


            

                

                    GET
                    /api/v1/signals/stats
                    Tier 1
                

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

            


            
            
🧠 Intelligence


            

                

                    GET
                    /api/v1/leaderboard
                    Tier 1
                

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

            


            

                

                    GET
                    /api/v1/social-proof
                    Tier 1
                

                
Platform statistics: total tokens analyzed, active trades, win rate, pipeline depth. Great for integration partners.

            


            
            
🧩 Embeddable Widgets


            

                

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

                
Embeddable safety badge HTML. Drop a token safety score into any webpage or dashboard.

                
                

                    
<!-- Add to any page -->
<iframe src="https://www.supah.ai/api/v1/widget/safety?address=0x4ed4..."
  width="300" height="120" frameborder="0"></iframe>
                

            


            

                

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

                
Get embeddable HTML/JS snippet for your site. Returns copy-paste code for safety badges.

            


            
            
🛠️ Resources


            

                

                    MCP
                    supah-mcp (npm)
                    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
                    Public
                

                
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 — One Starter Proof, Then Scale

                
USDC micropayments on Base. Start with one paid proof receipt, then scale into agent calls, manifests, and MCP installs.

                

                    

                        
⚡ Quick Data

                        
$0.001/call

                        
    
                            
  • Price and metadata
    • 
                            
  • Pairs and trending
    • 
                            
  • x402 on Base
    • 
                            
  • Low-friction agent access
    • 
                        

                        Start →
                    

                    

                        
🧾 Starter Proof

                        
$0.001+/call

                        
    
                            
  • Run one paid Base call
    • 
                            
  • Capture a reusable receipt
    • 
                            
  • USDC on Base
    • 
                            
  • Proof for builders and partners
    • 
                            
  • Manifest-driven pricing
    • 
                        

                        Run Proof →
                    

                    

                        
🤖 MCP Server

                        
npx

                        
    
                            
  • AI agent tool
    • 
                            
  • Claude / Cursor
    • 
                            
  • All endpoints
    • 
                            
  • Auto-discovery
    • 
                        

                        Install →
                    

                

            


            

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

            

        

    


    

        
SUPAH ⚡ Token Intelligence for Base Chain — Built by the Chaos Crew

        
NFA / DYOR — Not financial advice. Always verify independently.