GET/v1/markets/:id/orderbook

Get Market Orderbook

Returns the live orderbook for a specific market with UP and DOWN token books, best bid/ask, and depth.

Path Parameters

idstringrequired

Market ID (conditionId)

Query Parameters

formatstringdefault:json

Response encoding. csv and tsv return the rows as a flat file instead of a JSON envelope — the envelope moves to X-* response headers and nulls render as \N. REQUIRES SCALE OR ENTERPRISE (json is available on every tier). Works with includebook=true — the bids/asks ladders come through as compact JSON inside their cell, complete and parseable (pandas: df["bids"].apply(json.loads)).

Response

200401403404500

Successful Response

Code Snippet

curl -X GET "https://api.resolvedmarkets.com/v1/markets/:id/orderbook" \
  -H "X-API-Key: YOUR_API_KEY"

200

{
  "market_id": "0x778be094...",
  "marketId": "0x778be094...",
  "category": "crypto",
  "subcategory": "BTC",
  "label": "Bitcoin Up or Down - August 4, 5AM ET",
  "question": "Bitcoin Up or Down - August 4, 5AM ET",
  "timeframe": "1h",
  "slug": "bitcoin-up-or-down-august-4-2026-5am-et",
  "crypto": "BTC",
  "crypto_price": 63586.27,
  "cryptoPrice": 63586.27,
  "up": {
    "tokenId": "99024250...",
    "timestamp": 1785837568169,
    "eventTimestamp": 1785837568169,
    "captureTimestamp": 1785837569768,
    "sequenceNumber": 159196,
    "outcomeIndex": 0,
    "bestBid": 0.39,
    "bestAsk": 0.41,
    "midPrice": 0.40,
    "spread": 0.02,
    "bidDepth": 310.52,
    "askDepth": 15727.78,
    "bids": [{ "price": 0.39, "size": 5 }, { "price": 0.37, "size": 5 }],
    "asks": [{ "price": 0.41, "size": 9 }, { "price": 0.42, "size": 620 }]
  },
  "down": { "...same shape, outcomeIndex 1...": "" }
}