# SUPAH Agent API
> Multi-chain on-chain intelligence oracle for AI agents. Token safety, price data, signals, whale tracking, wallet analytics across 21 EVM chains.

## Endpoints
- OpenAPI spec: https://api.supah.ai/openapi.json
- MCP Server: https://api.supah.ai/mcp (streamable-http)
- x402 Manifest: https://api.supah.ai/.well-known/x402-manifest.json
- AI Plugin: https://api.supah.ai/.well-known/ai-plugin.json
- Health: https://api.supah.ai/health

## Free Demo Endpoints (no payment required)
- GET /demo/safety/:address — Token safety score
- GET /demo/price/:address — Current price + 24h change  
- GET /demo/trending — Trending tokens on Base
- GET /demo/gas — Current gas prices
- GET /demo/search/:query — Search tokens by name

## Paid Endpoints (x402 USDC micropayments OR API key)
- 50+ total endpoints across Token Data, Wallet Data, NFT Data, Blockchain Data, Resolution, Intelligence, Premium Signals
- Price range: $0.0005 - $0.05 per call in USDC
- New competitive pricing: Most endpoints cheaper than a single Moralis API call resold
- Supports: eth, base, polygon, bsc, arbitrum, optimism, avalanche + 14 more chains
- Add ?chain=eth for Ethereum, ?chain=polygon for Polygon, etc.

## Pricing Tiers
- Ultra Cheap ($0.0005): Basic token/wallet/NFT data, blocks, ENS resolution
- Competitive ($0.001): Holders, transfers, swaps, whale moves, contract data
- 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 review
- Premium Signals ($0.05): Live AI signals, Degen Top 5, Swing Watchlist Top 5

## Payment
- Protocol: x402 (Coinbase standard) — HTTP 402 → pay USDC on Base → retry with receipt
- Network: Base (chain ID 8453)
- Currency: USDC

## MCP Integration
Add to Claude Desktop, Cursor, or any MCP client:
```json
{ "mcpServers": { "supah": { "url": "https://api.supah.ai/mcp" } } }
```

## Contact
- Email: supahonbase@gmail.com
- Telegram: https://t.me/SUPAH_Based
- X: https://x.com/supah_based