Market Data

All market data endpoints are public -- no authentication needed. Hit the gateway directly.

Markets

GET /v1/markets

Returns all markets with live YES/NO prices, spreads, and volume. Results are event-grouped: binary markets are inline, multi-outcome markets have an outcomes[] array.

Key fields per market:

Field	Description
id	Short identifier (also available as market_id)
question	The market question
category	Category object, e.g. {"name": "crypto", "sub": "bitcoin"}
status	"active", "halted", "resolved"
yes_price	Midpoint YES price in basis points
no_price	10000 - yes_price
yes_bid / yes_ask	Best bid/ask for YES
spread	yes_ask - yes_bid
fee_bps	Protocol fee for this market
volume	Cumulative volume

NO-side prices can be derived: NO bid = 10000 - yes_ask, NO ask = 10000 - yes_bid.

Events

Events group multiple outcome markets under one question.

GET /v1/events

{
  "events": [
    {
      "event_id": "abc123...",
      "title": "Who will win the 2024 election?",
      "category": {"name": "politics", "sub": "elections"},
      "outcomes": [
        {"label": "Trump", "market_id": "def...", "yes_price": 6200, "no_price": 3800},
        {"label": "Biden", "market_id": "ghi...", "yes_price": 3100, "no_price": 6900}
      ]
    }
  ]
}

Order Book

GET /v1/markets/{id}/book

{
  "yes_bids": [{"price": 6200, "size": 500, "order_count": 3}],
  "yes_asks": [{"price": 6300, "size": 200, "order_count": 1}],
  "no_bids": [{"price": 3700, "size": 200, "order_count": 1}],
  "no_asks": [{"price": 3800, "size": 500, "order_count": 3}],
  "yes_price": 6250,
  "no_price": 3750,
  "spread": 100,
  "sequence": 42
}

Use sequence to detect gaps when combining with WebSocket updates.

Trades

GET /v1/markets/{id}/trades?limit=50

Newest first. Use before param with the last id for pagination.

Candles

GET /v1/markets/{id}/candles?interval=5m

OHLCV data for charting. Fields: t (timestamp), o, h, l, c (prices in bps), v (volume).

Intervals: 1m, 5m, 15m, 1h, 1d

Categories

Markets are organized by category object ({"name": "...", "sub": "..."}):

Category	Subcategories	Protocol Fee
crypto	bitcoin, ethereum, solana, defi, nft, regulation	0.25%
sports	football, basketball, baseball, soccer, tennis, mma, esports	2.00%
politics	us, eu, asia, elections, legislation	0.50%
finance	stocks, forex, commodities, interest_rates, earnings	0.25%
tech	ai, launches, acquisitions	0.25%
economy	gdp, inflation, employment, housing, trade	0.25%
culture	entertainment, awards, social	0.25%

GET /v1/fees

Returns the full fee schedule with all categories and current rates.