The institutional API for prediction markets

Backed by
a16z crypto · Geneva Trading · DB News

Four venues. One API.
Thousands of markets.

Prediction markets are fragmented across exchanges. Each one has its own authentication, rate limits, data formats, and settlement mechanics. Building serious infrastructure means maintaining five separate integrations.

Kairos collapses that complexity into a single enterprise REST and WebSocket API, the institutional layer for prediction markets. Market data, order execution, portfolio analytics, and on-chain settlement, unified across Kalshi, Polymarket, and every major venue.

Get more than the best execution.

Most providers ship one of these. Kairos ships all three in a single institutional prediction market trading API, so exchanges, apps, and quant desks stop stitching together separate data vendors to cover one asset class.

01

Execution.

Orders, batch operations, and the full on-chain settlement layer across four venues through one integration.

  • REST + WebSocket order entry on Polymarket, Kalshi, Predict.fun, Hyperliquid
  • GTC / GTD / FOK / FAK / IOC time-in-force, post-only, slippage caps
  • Batch cancel (up to 100 orders), per-venue cancel-all kill switch
  • client_order_id idempotency, so replays never double-fill
  • Self-custody lane: EIP-712 intent, you sign, we route
  • Fee quotes before every order, from the same engine that prices fills
02

Market data.

A full prediction market data API, from trending markets and search down to the raw tape, normalized across every venue.

  • Trending, breaking, and expiring markets
  • Full-text search with autocomplete
  • OHLCV candles, single series or 200 series in one batch call
  • Full trade tape: every fill, timestamp, size, price
  • Cross-venue market matching + venue-id resolution to one canonical id
  • Resolution lifecycle: live snapshots and full event timelines
  • Sports markets: live events, cross-platform matching
  • Crypto oracle price history and price-to-beat levels
  • Perpetuals: venue capabilities, instruments, live snapshots
03

Trader intelligence.

The social and analytics layer that powers copy trading, independently useful for research tools and whale watching.

  • Public trader profiles and performance stats
  • Realized-PnL time series per wallet, plus live per-market PnL
  • Top token holders per market
  • Open and closed positions, and live exposure across venues
  • Wallet fill history, the feed copy-trading is built on
For Firms

Capital efficiency at every level of the stack.

Split USDC into YES and NO inventory, quote both sides, merge to recycle capital without waiting months for resolution. The full settlement layer, exposed as API primitives: an institutional platform for prediction markets.

  • CTF split: mint YES and NO at $0.50 each, no spread paid
  • CTF merge: burn a complete set, collateral back instantly
  • Redeem: programmatic settlement, NegRisk unwrapped automatically
  • Batch cancel and per-venue cancel-all
  • Scoped API keys (trade:execute, trade:read, position:read) + IP whitelisting
  • Unified market IDs across every venue
# Recycle matched inventory, no waiting
# for resolution
POST /exchanges/polymarket/ctf/merge
{
  "condition_id": "0x1a2b3c...",
  "market_id":    "570362",
  "amount":       500
}
# burns 500 YES + 500 NO, returns 500 USDC
# booked as two synthetic sells at 0.50
SPLIT
$500 USDC
500 YES + 500 NO into inventory across venues
QUOTE
Post bid / ask
Market make both sides at zero cost basis
MERGE
$500 USDC back
Recycle matched inventory instantly
For Trading Apps

Embed prediction markets into your product. Today.

A single API integration gives your product access to live order books, execution, and market data across all major venues, without direct exchange relationships, venue-specific authentication, or fragmented data pipelines. Build a prediction markets tab, a dedicated trading product, or embed event contracts directly into your existing app.

  • Unified REST + WebSocket API: one integration, four venues
  • Binary protobuf market-data stream at wss://stream.kairos.trade
  • Order and fill events stream live over your authenticated /ws
  • Market discovery, search, and trending across all venues
  • Fee quote endpoint: show users exact costs before order submission
# One query. Every venue.
GET /api/markets/discover/v2
    ?sort_by=volume_1h
{
  "markets": [
    { "provider": "kalshi",
      "ticker": "FED-23SEP", "price": 0.47 },
    { "provider": "polymarket",
      "ticker": "570362", "price": 0.55 },
    { "provider": "predictfun",
      "ticker": "gov-shut", "price": 0.18 }
  ],
  "total": 4812, "offset": 0, "limit": 50
}
Integration

Three headers. Every market.

# Discover markets across all venues
curl https://data.kairos.trade/api/markets/discover/v2 \
  -H "X-Client-Id: kairos_ck_your_id"   \
  -H "X-Api-Key:   your_api_key"        \
  -H "X-Api-Secret: your_secret"

# Submit a limit order (custodial lane)
curl -X POST https://execution.kairos.trade/orders \
  -H "X-Client-Id: kairos_ck_your_id"   \
  -H "X-Api-Key:   your_api_key"        \
  -H "X-Api-Secret: your_secret"        \
  -H "Content-Type: application/json"   \
  -d '{
    "exchange_id":     "kalshi",
    "market_id":       "FED-23SEP",
    "outcome":         "Yes",
    "side":            "buy",
    "kind":            "limit",
    "quantity":        "500",
    "price":           "0.47",
    "time_in_force":   "GTC",
    "client_order_id": "desk-001"
  }'
# 200 = validated + enqueued. Track the fill on
# GET /orders/{order_id} or the /ws stream.
// Same three headers on the upgrade
// request. No query-string tokens.
const ws = new WebSocket(
  'wss://execution.kairos.trade/ws',
  { headers: {
      'X-Client-Id':  'kairos_ck_your_id',
      'X-Api-Key':    'your_api_key',
      'X-Api-Secret': 'your_secret'
  } }
);

ws.send(JSON.stringify({
  type:       "submit_order",
  request_id: "order-001",
  payload: {
    exchange_id:   "polymarket",
    market_id:     "570362",
    outcome:       "Yes",
    side:          "buy",
    kind:          "limit",
    quantity:      "100",
    price:         "0.45",
    time_in_force: "GTC"
  }
}));

// order_response, then order_update / fill
// frames stream back on the same socket.
100-500 req/minMarket Data, per route
5 orders/secExecution, raisable per key
10 connectionsWebSocket, per user
Pricing

Priced per desk.

Fees are set per credential against your volume, venue mix, and whether you are taking or making. Talk to the team and we will quote yours.

Exchange and network fees pass through at cost. GET /orders/fee-quote returns the platform fee, the venue fee, and the all-in cost of a trade before you submit it, priced off the live book by the same engine that computes the fee at fill time.

FAQ

Enterprise API questions, answered.

What is an institutional prediction market API?

An institutional prediction market API gives trading firms and apps programmatic access to event markets: market data, order execution, and settlement, with production-grade controls like scoped keys, IP whitelisting, and rate limits. Kairos provides all of this across four venues through one REST and WebSocket integration.

Which prediction market venues does the Kairos API cover?

Order entry runs on Kalshi (custodial and self-custody lanes), Polymarket, Predict.fun, and Hyperliquid, and market data covers every venue Kairos ingests. Cross-venue matching and identifier resolution mean the same event is addressable through one canonical Kairos market id on every venue.

Is Kairos a prediction market data API or a trading API?

Both, plus a third layer most providers skip. The API covers execution (orders, batch cancel, cancel-all, CTF split/merge/redeem), market data (OHLCV candles, the full trade tape, discovery, search, resolutions, sports, perpetuals), and trader intelligence (realized-PnL time series, positions, exposure, top holders, wallet fill history) in one integration.

How is this different from using the Kalshi API or Polymarket API directly?

Direct venue APIs each have their own authentication, rate limits, data formats, and settlement mechanics, so four venues means four integrations. Kairos consolidates them behind one set of credentials. For a deep dive on the individual venue APIs, see our Kalshi API guide and Polymarket API guide.

How much does the enterprise API cost?

Pricing is set per credential against your volume, venue mix, and whether you are taking or making, so it is quoted rather than published. Talk to the team for yours. Exchange and network fees always pass through at cost, and GET /orders/fee-quote returns the platform fee, the venue fee, and the all-in cost of a prospective trade before you submit it, priced off the live book by the same engine that computes the fee at fill time.

What are the API rate limits?

Data API limits are per route on a sliding window: 100 requests per minute by default, up to 500 on candles and down to 30 on the heaviest discovery feeds, with 429s carrying Retry-After. Execution is capped at 5 orders per second per user, and idempotent replays of the same client_order_id never consume a slot. WebSocket connections are capped at 10 per user. Higher limits are available per credential. Talk to the team.

How does authentication work?

Three headers on every request: X-Client-Id (your kairos_ck_… client id), X-Api-Key, and X-Api-Secret. The same three headers authenticate the WebSocket upgrade, and there are no query-string tokens. Credentials carry scopes (trade:execute, trade:read, position:read) and optional IP whitelisting, both enforced per request.

Does Kairos have to custody my funds to execute?

No. There are two lanes. The custodial lane (POST /orders) has Kairos sign and route on your behalf, acknowledging asynchronously once the order is validated and enqueued. The self-custody lane, for allow-listed institutional accounts, has Kairos build the EIP-712 payload (POST /v2/orders/intent), you sign it with your own key, and submission (POST /v2/orders/submit) returns the venue result synchronously.

How do I get API access?

Schedule a demo with the team. You will get scoped API keys, IP whitelisting for production, and integration support across all four venues.

Ready to build on
prediction markets?

Talk to the team about enterprise API access, integration support, and venue coverage.

Schedule Demo

Backed by a16z crypto · Built by ex-Cboe engineers