# Oddpool API

Prediction market data across Kalshi and Polymarket. Real-time WebSocket feeds, whale tracking, arbitrage detection, search, and historical data.

Base URL: https://api.oddpool.com
WebSocket: wss://feeds.oddpool.com/ws
Docs: https://docs.oddpool.com

## Documentation index

### Getting started
- [Oddpool API](https://docs.oddpool.com/index.md): Prediction market data across Kalshi and Polymarket.
- [Authentication](https://docs.oddpool.com/authentication.md): Authenticate API requests with your API key.
- [Rate limits](https://docs.oddpool.com/rate-limits.md): Per-tier rate limits, monthly quotas, and API key allowances.
- [Error handling](https://docs.oddpool.com/errors.md): HTTP status codes and error response format.

### WebSocket feeds
- [WebSocket overview](https://docs.oddpool.com/websocket/overview.md): Stream real-time prediction market data over a single WebSocket connection. Auth, subscribe/unsubscribe, channel format.
- [Macro feed](https://docs.oddpool.com/websocket/macro-feed.md): Cross-venue matched macro economic events from Kalshi and Polymarket. FOMC, CPI, NFP, GDP, unemployment, equities, commodities.
- [Crypto feed](https://docs.oddpool.com/websocket/crypto-feed.md): Bitcoin and Ethereum prediction markets enriched with real-time Binance spot and futures data. Auto-discovered and cross-venue matched events across 5m, 15m, and hourly timeframes. Every message includes spot bid/ask, futures mark price, funding rate, and 24h volume.
- [Message reference](https://docs.oddpool.com/websocket/messages.md): Schema reference for dist, book, trade, and snapshot channel messages. Includes reference data fields for enriched feeds.
- [Feed catalog](https://docs.oddpool.com/websocket/catalog.md): GET /feeds/catalog — discover available events and channel names. Filter by feed (macro, crypto) and status (active, upcoming, resolved).
- [Limits and errors](https://docs.oddpool.com/websocket/limits.md): WebSocket connection limits by tier (Free/Pro/Premium/Enterprise) and error codes.

### Whale tracking
- [Whale tracking overview](https://docs.oddpool.com/whales/overview.md): Monitor large trades across prediction markets.
- [List events](https://docs.oddpool.com/whales/list-events.md): GET /whales/user/events — list all events you are currently tracking.
- [Get feed](https://docs.oddpool.com/whales/get-feed.md): GET /whales/user/feed — get whale trades for all your tracked events.
- [Get stats](https://docs.oddpool.com/whales/get-stats.md): GET /whales/user/stats — aggregated statistics for all tracked events.
- [Event trades](https://docs.oddpool.com/whales/event-trades.md): GET /whales/user/event/{event_id} — whale trades for a specific event.
- [Event stats](https://docs.oddpool.com/whales/event-stats.md): GET /whales/user/event/{event_id}/stats — statistics for a specific event.
- [List markets](https://docs.oddpool.com/whales/list-markets.md): GET /whales/user/markets — all markets for your tracked events.
- [Market stats](https://docs.oddpool.com/whales/market-stats.md): GET /whales/user/market/{market_id}/stats — statistics for a specific market.
- [Market trades](https://docs.oddpool.com/whales/market-trades.md): GET /whales/user/market/{market_id}/trades — whale trades for a specific market.

### Arbitrage
- [Arbitrage overview](https://docs.oddpool.com/arbitrage/overview.md): Cross-venue arbitrage opportunities and price spreads.
- [Cross-venue arbitrage](https://docs.oddpool.com/arbitrage/current.md): GET /arbitrage/current — find risk-free cross-venue arbitrage opportunities.
- [Price spreads](https://docs.oddpool.com/arbitrage/differences.md): GET /arbitrage/current/difference — find where venues disagree on the same outcome's price.

### Search
- [Search overview](https://docs.oddpool.com/search/overview.md): Query, filter, and discover prediction markets across Kalshi and Polymarket.
- [Search markets](https://docs.oddpool.com/search/search-markets.md): GET /search/markets — full-text search across all prediction markets with filtering and sorting.
- [Search events](https://docs.oddpool.com/search/search-events.md): GET /search/events — search across prediction market events.
- [Recent markets](https://docs.oddpool.com/search/recent-markets.md): GET /search/recent/markets — latest market listings without a search query.
- [Recent events](https://docs.oddpool.com/search/recent-events.md): GET /search/recent/events — latest event listings without a search query.
- [Event markets](https://docs.oddpool.com/search/event-markets.md): GET /search/events/{event_id}/markets — list all markets under one event.

### Kalshi historical data
- [Kalshi overview](https://docs.oddpool.com/kalshi/overview.md): Historical orderbook snapshots, top-of-book timeseries, and trade data for Kalshi markets.
- [Historical orderbook](https://docs.oddpool.com/kalshi/orderbook.md): GET /historical/kalshi/orderbook — full orderbook snapshots with YES bids, NO bids, and derived best bid/ask.
- [Historical top of book](https://docs.oddpool.com/kalshi/top-of-book.md): GET /historical/kalshi/top-of-book — lightweight timeseries of best bid, best ask, mid, and spread.
- [Historical trades](https://docs.oddpool.com/kalshi/trades.md): GET /historical/kalshi/trades — every trade execution on a Kalshi market.

### Polymarket historical data
- [Polymarket overview](https://docs.oddpool.com/polymarket/overview.md): Historical orderbook snapshots, top-of-book timeseries, and trade data for Polymarket markets.
- [Historical orderbook](https://docs.oddpool.com/polymarket/orderbook.md): GET /historical/polymarket/orderbook — full orderbook snapshots with bids, asks, and derived best bid/ask per token.
- [Historical top of book](https://docs.oddpool.com/polymarket/top-of-book.md): GET /historical/polymarket/top-of-book — lightweight timeseries of best bid, best ask, mid, and spread per token.
- [Historical trades](https://docs.oddpool.com/polymarket/trades.md): GET /historical/polymarket/trades — trade executions on a Polymarket market.