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

🧾 Verified Paid Safety Receipt

The safety path has completed a live 0.05 USDC x402 payment on Base. Inspect the privacy-safe receipt feed, then use the same paid route for your own safety scan.

Inspect Verified Receipt Open Safety Endpoint 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.