OCTODAMUS API
Docs Get Free Key Premium ● v3.0
OctoData API  ·  v3.0  ·  27 live data feeds
Market Intelligence
for AI Agents

Octodamus is an autonomous AI oracle that monitors derivatives markets, sentiment flows, and Polymarket positions 24/7. OctoData is the API layer — the same intelligence that powers Octodamus, available to your agents in clean, structured JSON.

The Data Streams

27 live feeds. No synthetic data. No simulated signals. Every endpoint pulls from primary sources on every request.

Derivatives
Oracle Signals
High-conviction directional calls published only when 9 of 11 internal systems agree. Includes entry price, target, confidence, and full reasoning chain.
Source: CoinGlass · Deribit · internal consensus
On-Chain
Funding Rates & Open Interest
Real-time BTC, ETH, SOL funding rates, OI, long/short ratios, and liquidation flows — the same data derivatives desks watch before sizing positions.
Source: CoinGlass
Prediction Markets
Polymarket Positions
OctoBoto's live Polymarket plays with expected value, true probability, Kelly sizing, and confidence. Entry rule: EV > 15% only.
Source: Polymarket CLOB API
Sentiment
AI Sentiment Scores
Per-asset AI sentiment on a -100 to +100 scale. Aggregated from news, social, and on-chain signals. Updated nightly. BTC, ETH, SOL, NVDA, TSLA, AAPL.
Source: NewsAPI · Alternative.me · proprietary NLP
Macro
Fear & Greed Index
Live market fear and greed reading with historical context. Composite of volatility, momentum, social, and survey data.
Source: Alternative.me
Prices
Price Snapshots
Current prices with 24h change for BTC, ETH, SOL, NVDA, TSLA, AAPL. Pulled fresh on every request — no stale cache.
Source: CoinGecko · Kraken · Nasdaq
LLM-Ready
Market Brief
A single paragraph summarizing BTC/ETH/SOL price action, derivatives positioning, sentiment, and Polymarket. Designed to drop directly into an LLM system prompt.
Source: all feeds above, synthesized by Claude
Congressional
Stock Trade Alerts
Live congressional stock trade disclosures. Know when elected officials buy or sell — before the market fully prices it in.
Source: QuiverQuant
Why Your AI Needs This

LLMs have no live market data. Without grounding, they hallucinate prices, invent signals, and give confidently wrong answers about markets that moved months ago.

Ground your AI in real-time reality
Inject /v2/brief into your system prompt and your model instantly knows current BTC funding, fear & greed, open signals, and Polymarket positioning — without any hallucination risk.
Let agents self-serve intelligence
Agents can call /v2/all before every decision to pull a full market snapshot in a single request. Rate-limit headers tell them exactly when to back off — no 429 loops.
High-conviction signals, not noise
The oracle only publishes when 9 of 11 systems agree. Your agent isn't wading through 50 conflicting indicators — it gets one directional call with full reasoning when the bar is met.
Agents can pay autonomously
No Stripe, no browser, no human. An agent can POST to /v1/agent-checkout, send $5 USDC on Base, poll for confirmation, and receive a Premium key — fully automated.
Connect Your AI in 3 Steps

From zero to live market context in under 2 minutes. Works with any Python, Node, or curl-based agent.

01
Get a free API key — no credit card
One POST request returns your key instantly. Basic tier: 500 requests/day, 20/min. Enough to test every endpoint.
# Terminal / curl curl -X POST "https://api.octodamus.com/v1/[email protected]" # Response { "api_key": "oct_live_xxxxxxxxxxxx", "tier": "basic", "daily_limit": 500 }
02
Inject live market context into your LLM system prompt
Pull /v2/brief before every inference call. Your model now knows current prices, positioning, and sentiment — with zero extra tokens beyond what it needs.
## Python — inject into system prompt import httpx OCTO_KEY = "oct_live_xxxxxxxxxxxx" market = httpx.get( "https://api.octodamus.com/v2/brief", headers={"X-OctoData-Key": OCTO_KEY} ).json() system_prompt = f"""You are a trading assistant with live market context. {market['brief']} Use this to ground your analysis. Do not speculate on prices you cannot verify. Source: OctoData API (api.octodamus.com) """
03
Pull everything in one call — or ask Octodamus directly
Use /v2/all to get signals, polymarket, sentiment, prices, and brief in a single request. Or call /v2/ask to query Octodamus in natural language — no key required, 20 free questions/day per IP.
## Option A — get everything in one call (counts as 1 request) data = httpx.get( "https://api.octodamus.com/v2/all", headers={"X-OctoData-Key": OCTO_KEY} ).json() # data["signal"], data["polymarket"], data["sentiment"], data["prices"], data["brief"] ## Option B — ask in natural language (no key needed) answer = httpx.post( "https://api.octodamus.com/v2/ask", params={"q": "What is your current read on BTC funding rates?"} ).json() print(answer["answer"]) # natural language response print(answer["suggested_endpoints"]) # which endpoint automates this ## Self-throttle using rate-limit headers on every response # X-RateLimit-Remaining-Day: 487 # X-RateLimit-Remaining-Minute: 19
Pricing

Start free. Upgrade when you need full signal depth, all assets, and webhooks.

Free forever
Basic
500 req/day  ·  20/min
  • Latest oracle signal (direction, asset, timeframe)
  • BTC sentiment score
  • BTC, ETH, SOL prices
  • Top Polymarket play
  • Market brief for LLM injection
  • /v2/ask — 20 questions/day
  • /v2/demo & /v2/sources — no key required
Get Free Key →
Premium
Premium
$29 / year
  • All open signals + confidence, entry, target, reasoning chain
  • BTC, ETH, SOL, NVDA, TSLA, AAPL — all assets
  • Full AI market brief + Polymarket context + AI mood
  • All Polymarket positions with EV, true_p, Kelly size
  • Webhooks — push on signal.new, signal.resolved, polymarket.new
  • /v2/all — everything in one call
  • 10,000 req/day · 200/min
  • /v2/ask — 200 questions/day
Upgrade to Premium →
Connect Your Way

Five integration paths. Pick the one that matches how your agent or system is built.

● ACP Agent
Virtuals Agent Commerce Protocol
Octodamus is a live ACP provider on the Virtuals network. Any ACP-compatible agent can purchase market intelligence reports directly on-chain — no API key, no browser, no human. Pay $1 USDC per job via the Virtuals ACP protocol and receive structured JSON in return.
# Connect to Octodamus as an ACP provider # Agent ID: 019d8ec8-0885-766e-b3c4-0a2e70e31274 # Offerings: Oracle Signal · BTC Deep Dive · Fear & Greed · Congress Trades npm install -g @virtual-protocol/acp-cli acp browse Octodamus # find the agent acp job create --provider 019d8ec8... --offering "Oracle Market Signal"
GET/api/report/{id}— retrieve fulfilled report
GET/.well-known/agent.json— agent card + offerings
Browse on Virtuals ↗
MCP
Model Context Protocol
Add Octodamus as an MCP server in Claude, Cursor, Windsurf, or any MCP-compatible host. Ten tools available — get signals, Polymarket edges, sentiment, prices, and market briefs directly in your AI session. Also listed on Smithery.
# claude_desktop_config.json / .cursor/mcp.json { "mcpServers": { "octodamus": { "url": "https://api.octodamus.com/mcp" } } }
MCPget_agent_signal— BUY/SELL/HOLD decision
MCPget_all_data— all signals in one call
MCPbuy_premium_api— subscribe via x402
View on Smithery ↗
SaaS
REST API with Key
The standard integration path. Get a free API key in one POST request and start hitting endpoints immediately. Pass your key as the X-OctoData-Key header on every request. Rate-limit headers on every response tell you exactly how much headroom you have.
# 1. Get free key (500 req/day) curl -X POST "https://api.octodamus.com/v1/[email protected]" # 2. Hit any endpoint curl "https://api.octodamus.com/v2/agent-signal" -H "X-OctoData-Key: octo_your_key" # Rate-limit headers on every response: # X-RateLimit-Remaining-Day: 487 # X-RateLimit-Remaining-Minute: 19
GET/v2/agent-signal— primary signal
GET/v2/all— full snapshot
GET/v2/brief— LLM system prompt injection
Get Free Key ↗
x402
HTTP Payment Protocol
Pay per call or subscribe autonomously — no account, no browser, no human. Hit any endpoint without a key, receive a 402 Payment Required response with treasury and amount, sign an EIP-3009 USDC authorization on Base, and retry with the PAYMENT-SIGNATURE header.
# Option A — $0.01 USDC per call (no key needed) # 1. Probe to get payment requirements GET /v2/agent-signal → 402 + payment-required header # amount: 10000 (= $0.01 USDC, 6 decimals) # Option B — Subscribe for full access GET /v1/subscribe?plan=trial → $5 USDC / 7 days GET /v1/subscribe?plan=annual → $29 USDC / 365 days Treasury: 0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db USDC Base: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 Network: Base mainnet (eip155:8453)
GET/.well-known/x402.json— discovery doc
GET/v1/subscribe— autonomous purchase
x402 Code Examples ↗
ERC-8004
On-Chain Agent Identity
Octodamus is registered on-chain via ERC-8004 on Base — a standard for autonomous agent identity and capability discovery. Any agent that reads the ERC-8004 registry can discover Octodamus, verify its identity, and call its endpoints without any prior configuration.
# Discover Octodamus via ERC-8004 GET /.well-known/agent.json # full agent card GET /.well-known/agent-registration.json # on-chain registration # On-chain identity globalId: eip155:8453:0x8004A169...#44306 Registry: Base mainnet (eip155:8453) Wallet: 0x94c037393ab0263194dcfd8d04a2176d6a80e385 # Agent card includes: endpoints, pricing, payment terms, # MCP server, x402 treasury, and capability list
GET/.well-known/agent.json— ERC-8004 agent card
GET/.well-known/oauth-protected-resource— ACP resource
ERC-8004 Spec ↗

API Reference
All endpoints · schemas · try it live