Market Data

Public endpoints for market data. No authentication required for most endpoints.

Best Bid/Offer (BBO)

GET /v1/market-data/:market_id/bbo?outcome=0

Returns the best bid and ask for a market.

Response

{
  "market_id": "...",
  "outcome_index": 0,
  "best_bid": "0.48",
  "best_ask": "0.52",
  "bid_size": "5000000",
  "ask_size": "3000000"
}

Batch BBO

POST /v1/market-data/bbo

Get BBO for multiple markets in a single request (up to 50).

Request Body

{
  "market_ids": ["market-id-1", "market-id-2"]
}

Response

{
  "results": [
    {
      "market_id": "market-id-1",
      "outcome_index": 0,
      "best_bid": "0.48",
      "best_ask": "0.52",
      "bid_size": "5000000",
      "ask_size": "3000000"
    },
    ...
  ]
}

Spread

GET /v1/market-data/:market_id/spread?outcome=0

Returns the bid-ask spread for a market.

Response

{
  "market_id": "...",
  "outcome_index": 0,
  "spread": "0.04",
  "spread_bps": 400,
  "best_bid": "0.48",
  "best_ask": "0.52"
}

Midpoint

GET /v1/market-data/:market_id/midpoint?outcome=0

Returns the midpoint price between best bid and ask.

Response

{
  "market_id": "...",
  "outcome_index": 0,
  "midpoint": "0.50"
}

Tick Size

GET /v1/market-data/:market_id/tick-size

Returns the minimum price increment for a market.

Response

{
  "market_id": "...",
  "tick_size": "0.01"
}

Fee Rate

GET /v1/market-data/:market_id/fee-rate

Scope: read:account (Authenticated)

Returns the maker and taker fee rates for the authenticated user in a specific market.

Response

{
  "market_id": "...",
  "maker_fee_bps": 100,
  "taker_fee_bps": 200
}

Server Time

GET /v1/time

Public — No authentication required.

Returns the server's current Unix timestamp. Use this to synchronize your clock for HMAC signatures.

{
  "time": 1709136000
}