← Back to Tools Catalog

🦸 SUPAH Agent API

Multi-Chain Intelligence Oracle for AI Agents

FLAGSHIP PRODUCTION x402 PAYMENTS

Endpoints

EVM Chains

$0.001

Starting Price

x402

Access Model

🚀 What Is It?

SUPAH Agent API is a production-grade intelligence oracle providing 53 endpoints across 21 EVM chains. Built specifically for AI agents, with x402 USDC micropayments on Base mainnet.

From token safety scanning to wallet analytics, DeFi positions to NFT data, we power AI agents with the data they need to make smart decisions.

✨ Key Features

🌐 Multi-Chain

21 EVM chains supported: Base, Ethereum, Polygon, BSC, Arbitrum, Optimism, Avalanche, and more.

💳 x402 Payments

USDC micropayments on Base. Every external call clears through x402 with no signup gate.

🧾 x402 Pricing

Usage starts at $0.001 per call and scales by endpoint depth, settled in USDC on Base.

🤖 MCP Integration

Works with Claude Desktop, Cursor, Windsurf via npx supah-mcp.

📊 OpenAPI Spec

Full OpenAPI 3.1 specification for easy integration with any framework.

⚡ Fast Response

< 500ms p95 latency. Optimized for high-frequency agent workflows.

🔌 Endpoints

Token Intelligence

/agent/v1/price/{address} — Price, volume, mcap, liquidity
/agent/v1/safety/{address} — Honeypot check, risk flags, safety score
/agent/v1/metadata/{address} — Name, symbol, supply, deployer
/agent/v1/pairs/{address} — DEX pairs with reserves
/agent/v1/holders/{address} — Top 20 holders, whale %, Gini
/agent/v1/transfers/{address} — Recent ERC20 transfers
/agent/v1/swaps/{address} — Recent DEX swaps
/agent/v1/analytics/{address} — Full analytics + trends

Wallet Analytics

/agent/v1/wallet-portfolio/{wallet} — Holdings with safety scores
/agent/v1/wallet-pnl/{wallet} — Realized/unrealized PnL
/agent/v1/net-worth/{wallet} — Portfolio value breakdown
/agent/v1/wallet-history/{wallet} — Decoded transaction history
/agent/v1/defi/{wallet} — DeFi positions (LP, lending, staking)
/agent/v1/approvals/{wallet} — Token approvals (security audit)

NFT Data

/agent/v1/nft/collection/{address} — Collection metadata
/agent/v1/nft/trending — Trending collections
/agent/v1/nft/top — Top collections by volume

Base-Only (Proprietary)

/agent/v1/signals — Live buy/sell signals from SUPAH pipeline
/agent/v1/discovery — New token discovery with enrichment
/agent/v1/trending — Trending tokens with safety scores

📖 View full API documentation →

💰 Pricing

Tier	Price Range	Examples
Tier 1: Quick Data	$0.001	Price, metadata, pairs, trending
Tier 2: Intelligence	$0.005	Holders, transfers, swaps, approvals
Tier 3: Deep Analysis	$0.01 - $0.03	Full scan, analytics, portfolio, PnL, DeFi
Tier 4: Premium	$0.03 - $0.05	Live signals, discovery (Base only)

Payment Method: x402 USDC micropayments on Base. No free tier, no API-key bypass.

🛠️ Quick Start

Option 1: x402 Micropayments

# Python example
from x402.client import X402Client

client = X402Client(private_key="...", network="base")
result = client.get("https://api.supah.ai/agent/v1/safety/0x...")
print(result.json())

Option 2: Raw HTTP + x402

curl https://api.supah.ai/agent/v1/price/0x40ba93835789b9958ed588308c299fa27ddc5838 \
  -H "X-Payment-402: usdc-base"

Option 3: MCP Integration

# For Claude Desktop, Cursor, Windsurf
npx supah-mcp

# Or add to config:
{
  "mcpServers": {
    "supah-agent-api": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.supah.ai/mcp"]
    }
  }
}

🌐 Supported Chains

All endpoints accept ?chain= parameter. Default is base.

✅ Base

✅ Ethereum

✅ Polygon

✅ BSC

✅ Arbitrum

✅ Optimism

✅ Avalanche

✅ Linea

✅ Cronos

✅ Gnosis

+ 11 more chains

See full chain list →

Explore API Docs → Run Price Proof Route → Open Receipt Rescue →