MCP Server & x402
Athena's Model Context Protocol server — ten read-only signal tools for AI agents, gated by x402 holder proof or pay-per-call USDC.
What it is
Athena runs a Model Context Protocol (MCP) server so AI agents — Claude, autonomous trading agents, anything MCP-capable — can call her live signals as tools. It speaks standard JSON-RPC over streamable HTTP at:
https://api.0xathena.ai/mcpDiscovery is free and open: tools/list, the /mcp/info catalog, and /mcp/health need no auth. Only actually calling a tool (tools/call) is gated, via x402 — the open payment-proof standard for HTTP — with two ways in.
The ten tools
| Tool | Returns | Key params |
|---|---|---|
get_wisdom_ranking | The full hourly Athena’s Wisdom ranking — per-asset score, rank, components, and RSI | — |
get_wisdom_skew_leaderboard | One-shot leaderboard joining the Wisdom rank with the liquidation deep-skew rank per asset | — |
get_liquidation_gravity | Liquidation Gravity — near pull, deep overhang, deep skew, and alignment per asset | asset? |
get_funding_map | OI-weighted funding across the ~48-asset universe | — |
get_max_pain | Options max pain for BTC / ETH / SOL — weekly, monthly, quarterly | — |
get_smart_money_signals | The Smart Money positioning grid — cohort long/short splits plus funding | asset? |
get_elite_wallets | The ranked elite cohort with their live books | kind (crypto | hip3), limit? |
get_elite_portfolio | The Elite Consensus Portfolio in any of its five modes | mode |
get_vol_screener | The IVR board — vol-rank rows with the selected short strangles | limit? |
get_implied_vol | Athena’s in-house near-ATM implied vol for arbitrary tickers — the same feed her Synth miner runs on | symbols?, dte? |
All tools are strictly read-only and return live JSON.
Access path 1 — holders (free)
Wallets holding ≥ 1,000,000 $ATHENA (Base) call for free. Each request carries an x402 zero-value USDC authorization signature — a cryptographic proof you control the wallet. Nothing settles on-chain, nothing is spent, no gas is used; the server verifies the signature (EOAs and smart wallets, including Coinbase Smart Wallet), checks the $ATHENA balance, and serves the call. x402-native clients handle the signing automatically against POST /mcp.
Access path 2 — pay-per-call
No $ATHENA? Call POST /mcp/paid and pay 1 USDC per tool call on Base through the standard x402 flow (settlement via the Coinbase CDP facilitator). Any x402-capable agent wallet works; a successful call returns the settlement receipt in the response headers.
Rate limits
| Limit | Value |
|---|---|
| Per IP | 30 requests / minute |
| Per wallet | 12 calls / minute, 300 / day |
| Global | 120 / minute, 3,000 / day |
Responses are always fresh (no-store); very large results are truncated with an explicit flag. Underlying data cadence matches each signal’s page (Smart Money 15 min, elite books ~2 min, Wisdom hourly, max pain 4h).
x402 lets a wallet be the API key: holders authenticate with free signatures instead of accounts, and non-holders pay per call without ever creating one. Both generations of the protocol (v1 and v2) are accepted, on Base (eip155:8453).