# Octodamus Market Intelligence API > Real-time crypto market intelligence for autonomous AI agents. Oracle trading signals (9/11 consensus), Fear & Greed index, Polymarket prediction market edge plays, BTC trend, and macro sentiment across 27 live data feeds. Designed for 15-minute AI agent poll cycles. x402 native: agents pay $29 USDC on Base, receive an API key automatically — no human required. ## AGENT QUICKSTART — read this first (updated 2026-10-10) You can buy from Octodamus per call with x402 on Base. No account, no API key, no signup. 1. Start free (no payment): - GET https://api.octodamus.com/tools/scorecard — the verified record: wins, losses, n, open. - GET https://api.octodamus.com/api/calls — every published call with its Base tx hash. - GET https://api.octodamus.com/v2/demo — signal preview. - GET https://api.octodamus.com/.well-known/x402.json — every paid route and its price. 2. Make a paid call (x402 v2): - Network: Base mainnet (eip155:8453) - Asset: USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 - Pay to: 0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db a. GET https://api.octodamus.com/v2/x402/agent-signal → HTTP 402. The payment requirements are in the `payment-required` response header (base64 JSON) and in the JSON body under `accepts`. Price: 10000 raw = $0.01 USDC. b. Sign an EIP-3009 transferWithAuthorization for exactly that amount to the pay-to address. c. Repeat the same GET with header `PAYMENT-SIGNATURE: ` (`X-PAYMENT` is also accepted). d. The JSON response is Ed25519-signed. Verify `.signature` with the public key published in /.well-known/x402.json under `signing`. Any x402 client (Coinbase x402 SDK, x402-fetch, x402-axios, the x402 Python package) does steps a–c for you. 3. Other ways in: - MCP: https://api.octodamus.com/mcp (Streamable HTTP; tools/list is free). - Agent-to-agent jobs: ACP on Virtuals (Base). 4. What to expect: - Every output is research, not a trade instruction. - If a required data source is down or stale, a paid endpoint should answer 503 with "billable": false instead of charging you. - The track record is live at /tools/scorecard. Only calls with a Base tx hash count. - Do not buy right now: /v2/grok/*, /v2/ben/*, /v2/x_sentiment/* (their X-sentiment source is switched off) and /v2/agents/*/brief once its preview shows "available": false. ## Quick Start - [API Documentation](https://api.octodamus.com/docs): Interactive Swagger docs — all endpoints, schemas, and try-it-now - [Agent Signal](https://api.octodamus.com/v2/agent-signal): Primary decision endpoint (requires API key or x402 payment) - [Demo (no key)](https://api.octodamus.com/v2/demo): Public preview of signal output — no key required - [Data Sources](https://api.octodamus.com/v2/sources): Full list of all 27 live data feeds powering every endpoint - [Get Free Key](https://api.octodamus.com/v1/signup): POST with your email for free Basic tier (500 req/day) - [Agent Checkout](https://api.octodamus.com/v1/agent-checkout): Autonomous x402 purchase — $29 USDC for annual access ## Core Signal Endpoints (require X-OctoData-Key header) - [GET /v2/agent-signal](https://api.octodamus.com/v2/agent-signal): **Primary endpoint for agents.** Returns `action` (BUY/SELL/HOLD), `confidence` (0.0–1.0), `signal` (BULLISH/BEARISH/NEUTRAL), `fear_greed` (0–100), `btc_trend` (UP/DOWN/SIDEWAYS), `polymarket_edge` {market, ev}, `reasoning` (plain-text explanation). Poll every 15 minutes. - [GET /v2/signal](https://api.octodamus.com/v2/signal): Raw Oracle signal pack — individual votes from all 11 oracles, consensus strength, win rate, and timestamp - [GET /v2/polymarket](https://api.octodamus.com/v2/polymarket): Top Polymarket prediction markets with expected-value scoring. Returns `ev`, `edge`, `recommended_side`, and `confidence` per market. - [GET /v2/sentiment](https://api.octodamus.com/v2/sentiment): AI sentiment scores for BTC, ETH, SOL, and macro themes (score –1.0 to +1.0, label, summary) - [GET /v2/prices](https://api.octodamus.com/v2/prices): Current crypto prices with 24h % change for major assets - [GET /v2/brief](https://api.octodamus.com/v2/brief): Full AI market briefing in narrative format — ideal for agent reasoning context - [GET /v2/all](https://api.octodamus.com/v2/all): Combined snapshot of signal + sentiment + prices + Polymarket in one call ## Key Management - [GET /v1/key/status](https://api.octodamus.com/v1/key/status): Check expiry, tier, and usage for your key — also returns renewal x402 payment details when within 30 days of expiry - [POST /v1/signup](https://api.octodamus.com/v1/signup): Create free Basic API key. Params: `email` (query or body) - [POST /v1/agent-checkout](https://api.octodamus.com/v1/agent-checkout): Initiate x402 checkout. Params: `product` (premium_annual | premium_trial), `agent_wallet` (your 0x address) - [GET /v1/agent-checkout/status](https://api.octodamus.com/v1/agent-checkout/status): Poll payment status. Returns `api_key` once payment is confirmed on-chain. ## Pricing - **Free Basic**: 500 req/day, 20 req/min — email signup, no payment - **Premium Annual**: $29 USDC on Base, 10,000 req/day, 200 req/min, 365-day access - **Trial**: $5 USDC on Base, 10,000 req/day, 7-day access - **x402 chain**: eip155:8453 (Base mainnet) - **Pay to**: 0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db - **USDC contract**: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 ## Agent Integration Notes Authentication: `X-OctoData-Key: ` header on all v1/v2 endpoints. x402: All v2 endpoints return HTTP 402 with `payment-required` (base64 JSON, v2) and `X-Payment-Required` (plain JSON, v1) when no key is present. ERC-8004: Registered on Agent Arena. globalId = eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#44306 A2A Card: https://agentarena.site/api/agent/8453/44306/a2a