VoxOdds API

Free public API for prediction market data. No auth required. JSON responses.

GET /api/v1/markets

List prediction markets with live odds.

Parameters:

category — Filter: Politics, Crypto, Sports, Geopolitics, Economics
q — Search query (e.g. "bitcoin", "france")
limit — Max results (default 50, max 200)

Example response

{
  "markets": [
    {
      "id": "558936",
      "question": "Will France win the 2026 FIFA World Cup?",
      "category": "Sports",
      "outcomes": ["Yes", "No"],
      "prices": [0.17, 0.83],
      "volume_24h": 1500000,
      "polymarket_url": "https://polymarket.com/event/...",
      "voxodds_url": "https://voxodds.com/market/558936"
    }
  ],
  "count": 1,
  "source": "voxodds.com"
}

GET /api/v1/market/{id}

Single market with price history and community sentiment.

Returns: current odds, 7-day hourly price history, community sentiment breakdown, insight count.

GET /api/v1/trending

Top 20 markets by 24h volume.

GET /api/v1/edges

Ranked spread, price-discovery, and integrity-risk signals.

Parameters: limit, min_edge, include_risky.

GET /api/v1/backtest

Backtest price-action signals against stored hourly snapshots.

Parameters: lookback, horizon, min_move, min_vol.

GET /api/v1/strategies

Current strategy playbook built from backtests and live Edge filters.

Returns: top tactic, avoid tactics, current setup candidates, and guardrails.

GET /api/v1/research-desk Research workflow

Live Research Desk data for active theses, demand queue, watched setups, recent thesis changes, and paper-tracker links.

Parameters: limit — max active theses / queue items (default 6, max 20).

Example response

{
  "source": "voxodds.com",
  "active_insights": [{"id": "hormuz-traffic-normal-may15", "yes_pct": 2.1}],
  "research_queue": [{"title": "Queued market", "score": 4}],
  "hot_insights": [],
  "alert_events": [],
  "links": {"html": "https://voxodds.com/research-desk"}
}

GET /api/v1/investment-insights

Public research notes with thesis, tracker state, triggers, invalidation, research queue, and watcher demand.

Related: /api/v1/investment-insights/{id} returns a single thesis.

EMBED /embed/{id}

Embeddable odds widget. Use in an iframe on your site.

<iframe src="https://voxodds.com/embed/{market_id}" width="400" height="200" frameborder="0"></iframe>

GET /api/v1/answer?q=your question AI-friendly

Ask a natural language question. Returns structured answer with odds and trade links. Designed for AI chatbot integration.

Example: /api/v1/answer?q=will france win the world cup

{
  "question": "Will France win the 2026 FIFA World Cup?",
  "answer": "According to prediction markets, the current odds are: Yes: 17%, No: 83%.",
  "odds": {"Yes": "17.0%", "No": "83.0%"},
  "trade": {
    "polymarket": "https://polymarket.com/event/...",
    "kalshi": "https://kalshi.com/markets"
  },
  "full_analysis": "https://voxodds.com/market/558936",
  "source": "VoxOdds (voxodds.com)"
}

GET /api/v1/markdown/{market_id}

Returns ready-to-paste markdown with odds, analysis, and affiliate links.

SPEC /api/openapi.json

OpenAPI 3.0 specification for tool/plugin discovery.

Also: /.well-known/ai-plugin.json (ChatGPT plugin) · /.well-known/mcp.json (Claude MCP)

RSS /research-desk/feed.xml

RSS feed for active research theses and recent thesis-change events.

General market feed: /feed.xml

CLI — Odds in your terminal

curl -sL https://voxodds.com/cli/install.sh | sh

voxodds — Trending markets

voxodds "france world cup" — Search a market

voxodds --category crypto — Filter by category

voxodds --json — JSON output for scripting

Rate Limits & Terms

60 requests per minute per IP
No authentication required
Data sourced from Polymarket and Kalshi — please attribute
Free for non-commercial use. Contact us for commercial licensing.

Building something with prediction market data?

Get in touch →

VoxOdds API

CLI — Odds in your terminal

Rate Limits & Terms

Get the edge — weekly