Crypto Market Intelligence
API for AI Agents

Quick Start

Python — inject market context into system prompt

import httpx

# Get free key: POST https://api.octodamus.com/v1/signup?email=you@example.com
OCTO_KEY = "octo_your_key_here"

def get_market_context() -> str:
    data = httpx.get(
        "https://api.octodamus.com/v2/agent-signal",
        headers={"X-OctoData-Key": OCTO_KEY},
        timeout=10,
    ).json()
    return (
        f"Market action: {data['action']} (confidence: {data['confidence']})\n"
        f"Fear & Greed: {data['fear_greed'].get('value')} — {data['fear_greed'].get('label')}\n"
        f"BTC trend: {data['btc'].get('trend')}\n"
        f"Top Polymarket edge: {data['polymarket_edge'][0]['question'] if data['polymarket_edge'] else 'none'}\n"
        f"Reasoning: {data['reasoning']}"
    )

system_prompt = f"""You are an autonomous trading agent with live market intelligence.

{get_market_context()}

Use this context to ground every decision. Source: OctoData (api.octodamus.com)
"""

JavaScript / Node.js

const res = await fetch("https://api.octodamus.com/v2/agent-signal", {
  headers: { "X-OctoData-Key": process.env.OCTO_KEY }
});
const { action, confidence, fear_greed, btc, polymarket_edge, reasoning } = await res.json();

// Inject into your LLM system message
const marketContext = `Action: ${action} | Confidence: ${confidence} | F&G: ${fear_greed.value} | BTC: ${btc.trend}`;

cURL — try it now

# Get a free key first (returns immediately)
curl -X POST "https://api.octodamus.com/v1/signup?email=agent@example.com"

# Call the signal endpoint
curl -H "X-OctoData-Key: YOUR_KEY" https://api.octodamus.com/v2/agent-signal

# No key? Try the demo (no auth required)
curl https://api.octodamus.com/v2/demo

Connect any MCP-compatible agent to Octodamus in seconds. Listed on Smithery as octodamusai/market-intelligence.

Claude Desktop / Claude Code

# Add to your MCP config or claude_desktop_config.json:
{
  "mcpServers": {
    "octodamus": {
      "url": "https://api.octodamus.com/mcp"
    }
  }
}

Available MCP Tools

AI agents can purchase API access autonomously via x402 — no human, no browser, no Stripe. Any agent with a funded Base wallet can acquire a key in a single request cycle.

Agent buys trial key autonomously

import httpx, base64

# Step 1: Hit endpoint — receive 402 with payment instructions
r = httpx.get("https://api.octodamus.com/v1/subscribe?plan=trial")
# r.status_code == 402
# r.json()["detail"] contains treasury address, USDC amount, network

# Step 2: Sign EIP-3009 USDC authorization ($5 on Base)
# using Coinbase AgentKit, CDP Wallet SDK, or viem/ethers

# Step 3: Retry with signed authorization
r2 = httpx.get(
    "https://api.octodamus.com/v1/subscribe?plan=trial",
    headers={"PAYMENT-SIGNATURE": signed_authorization}
)
api_key = r2.json()["api_key"]
# api_key is live immediately — 10,000 req/day, 7 days

Treasury: 0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db  ·  USDC (Base): 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913  ·  Network: eip155:8453

{
  "action": "BUY",
  "confidence": "high",
  "signal": { "asset": "BTC", "direction": "LONG", "timeframe": "1W", "opened_at": "2026-04-15T08:00:00" },
  "fear_greed": { "value": 18, "label": "Extreme Fear" },
  "btc": { "price_usd": 84200, "change_24h": 3.2, "trend": "UP" },
  "polymarket_edge": [
    { "question": "Will BTC hit $90k before May?", "side": "NO", "ev": 0.22, "confidence": "high",
      "url": "https://polymarket.com/event/..." }
  ],
  "reasoning": "Oracle LONG on BTC + Extreme Fear (F&G 18) = high-conviction accumulation zone. Trend: UP.",
  "next_poll_seconds": 900,
  "methodology": "9/11 signal consensus + EV>15% for Polymarket entries.",
  "timestamp": "2026-04-21T14:30:00"
}