Start Here

Endpoint Index

Browse every public v2 operation. Use the live explorer for parameter and response schemas. Some account and webhook routes require their own authentication.

POST/api/v2/alerts

Create Alert

See the live explorer for request parameters and response schemas.

GET/api/v2/alerts

List Alerts

See the live explorer for request parameters and response schemas.

POST/api/v2/alerts/evaluate

Evaluate Alerts

See the live explorer for request parameters and response schemas.

GET/api/v2/alerts/history

Alert History

See the live explorer for request parameters and response schemas.

POST/api/v2/alerts/{alert_id}/snooze

Snooze Alert

See the live explorer for request parameters and response schemas.

GET/api/v2/arbitrage

Get Arbitrage

Events with cross-platform arbitrage opportunities. Requires 2+ platforms tracking the same event.

GET/api/v2/auth/api-keys

List Auth Api Keys

List API keys for an authenticated dashboard user.

POST/api/v2/auth/api-keys

Create Auth Api Key

Create the first free API key for an authenticated dashboard user.

POST/api/v2/auth/oauth/signin

Oauth Signin

Create or find a developer account via OAuth.

POST/api/v2/auth/profile/update

Update Profile

Update user profile (name, etc.).

POST/api/v2/auth/signup/email

Signup With Email

Generate a magic link for email-based signup.

POST/api/v2/auth/verify-email-token

Verify Email Token

Verify a magic token and create or return a developer account.

POST/api/v2/billing/checkout

Create Checkout

See the live explorer for request parameters and response schemas.

GET/api/v2/billing/subscription

Get Subscription State

See the live explorer for request parameters and response schemas.

POST/api/v2/billing/webhook

Billing Webhook

See the live explorer for request parameters and response schemas.

GET/api/v2/categories

List Categories

List all categories with event counts.

POST/api/v2/developers/api-keys

Create Developer Api Key

See the live explorer for request parameters and response schemas.

POST/api/v2/developers/login

Developer Login

See the live explorer for request parameters and response schemas.

GET/api/v2/developers/me

Developer Me

See the live explorer for request parameters and response schemas.

POST/api/v2/developers/signup

Developer Signup

See the live explorer for request parameters and response schemas.

GET/api/v2/events

List Events

List events for the main table. Returns collapsed event rows. Each row includes leading outcome, aggregated volume, platform count. Optimized: Phase 1 gets sorted event IDs, Phase 2 batch-loads summaries.

GET/api/v2/events/coverage

Event Coverage

See the live explorer for request parameters and response schemas.

GET/api/v2/events/{slug}

Get Event Detail

Get full event detail with all platform markets, outcomes, and breakdowns. Powers the event detail page (expanded view).

GET/api/v2/events/{slug}/history

Get Event History

Get time-series data for an event's leading outcome (or specified outcome). Powers charts on event detail pages.

GET/api/v2/kalshi/events

List Kalshi Events

See the live explorer for request parameters and response schemas.

GET/api/v2/kalshi/market-price

Get Kalshi Market Price

See the live explorer for request parameters and response schemas.

GET/api/v2/kalshi/markets

List Kalshi Markets

See the live explorer for request parameters and response schemas.

GET/api/v2/kalshi/prices

List Kalshi Prices

See the live explorer for request parameters and response schemas.

GET/api/v2/polymarket/activity

List Polymarket Activity

Trading activity (merges, splits, redeems, trades) for a wallet, proxied from data-api.polymarket.com.

GET/api/v2/polymarket/candlesticks

List Polymarket Candlesticks

Price history (candlestick series) for a Polymarket market, proxied from clob.polymarket.com.

GET/api/v2/polymarket/events

List Polymarket Events

See the live explorer for request parameters and response schemas.

GET/api/v2/polymarket/market-price

Get Polymarket Market Price

See the live explorer for request parameters and response schemas.

GET/api/v2/polymarket/markets

List Polymarket Markets

See the live explorer for request parameters and response schemas.

GET/api/v2/polymarket/orderbook-history

Get Polymarket Orderbook

Current orderbook (bids/asks) for a Polymarket market, proxied from clob.polymarket.com.

GET/api/v2/polymarket/orders

List Polymarket Orders

Trade history for a Polymarket market, proxied from clob.polymarket.com.

GET/api/v2/polymarket/positions/wallet/{wallet_address}

List Polymarket Positions

Current open positions for a Polymarket wallet, proxied from data-api.polymarket.com.

GET/api/v2/polymarket/prices

List Polymarket Prices

See the live explorer for request parameters and response schemas.

GET/api/v2/polymarket/wallet/{wallet_address}

Get Polymarket Wallet

Wallet profile for a Polymarket address, proxied from data-api.polymarket.com.

GET/api/v2/polymarket/wallet/{wallet_address}/pnl

Get Polymarket Wallet Pnl

Realized profit-and-loss for a Polymarket wallet, proxied from data-api.polymarket.com.

GET/api/v2/signals/news-sentiment

Get News Sentiment Signal

See the live explorer for request parameters and response schemas.

GET/api/v2/signals/news-sentiment/latest

Get Latest News Sentiment Snapshot

See the live explorer for request parameters and response schemas.

GET/api/v2/sitemap/events

Sitemap Events

Lightweight source for public event sitemaps. Existing Event rows are routable by /api/v2/events/{slug} and /event/{slug}.

GET/api/v2/spreads

Get Spreads

See the live explorer for request parameters and response schemas.

GET/api/v2/spreads/history

Get Spread History

See the live explorer for request parameters and response schemas.

GET/api/v2/spreads/top

Get Top Spreads

See the live explorer for request parameters and response schemas.

GET/api/v2/stats

Get Stats

Global stats for the header.

GET/api/v2/stream/health

Collector & Stream Freshness Health

Returns the real-time health metrics of the live collectors, including p50/p95 end-to-end ingestion latency and feed health.

GET/api/v2/stream/replay

Replay Stream Events from Cursor

Replays quote events from the durable Redis Stream starting immediately after the provided `cursor`. Uses numeric cursor comparison for retention checking.

GET/api/v2/stream/snapshot

Current Quote Snapshot with Cursor

Returns the latest versioned quote snapshot from Redis hashes along with the current stream tip cursor ID (`stream_tip_cursor`).

GET/api/v2/stream/sse

Server-Sent Events Live Stream with Gapless XREAD & Reconnect

Subscribes the client to an SSE stream driven directly by Redis Stream (`XREAD <cursor>`). - Numeric cursor retention loss check (on connection AND during catch-up). - Gapless delivery: uses `Last-Event-ID` or `?cursor=` to replay from exact disconnection point. - Browser ID reset: `resync` and `snapshot` frames send `id: <tip_cursor>` to reset browser Last-Event-ID. - Fully normalized payload: JSON nulls instead of empty strings.

GET/api/v2/ticker

Get Ticker Events

Ticker logic: Active events expiring in next 2 weeks, sorted by total volume. Returns Top 10 for the marquee strip.

GET/api/v2/trending

Get Trending

Trending events by momentum + activity. Optimized two-phase version.

POST/api/v2/watchlists

Create Watchlist

See the live explorer for request parameters and response schemas.

GET/api/v2/watchlists

List Watchlists

See the live explorer for request parameters and response schemas.

POST/api/v2/watchlists/{watchlist_id}/items

Add Watchlist Item

See the live explorer for request parameters and response schemas.

GET/api/v2/watchlists/{watchlist_id}/items

List Watchlist Items

See the live explorer for request parameters and response schemas.

Build with TPM

Get your API key

Start with Kalshi and Polymarket market data, then add unified spreads, signals, alerts, and watchlists as your workflow grows.