OctoData API Docs

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.

Get Free API Key →

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.

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 }

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)
"""

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

$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 →