Skip to main content
GET /api/v1/orderbook Returns the current orderbook (bids and asks) for a market identified by its parsec_id.

Parameters

parsec_id
string
required
Market identifier in the format {exchange}:{market_id} (e.g., polymarket:0x1234abcd).
outcome
string
default:"yes"
Outcome to fetch: yes or no. Required for categorical markets.
limit
number
default:"50"
Max price levels per side. Range: 1–100.
depth
number
default:"50"
Alias for limit (for REST/WS symmetry). If both are provided, limit takes precedence.

Response

success
boolean
Whether the request succeeded.
data
object
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parsecapi.com/api/v1/orderbook?parsec_id=polymarket:0x1234abcd&outcome=yes&depth=10"
{
  "success": true,
  "data": {
    "parsec_id": "polymarket:0x1234abcd",
    "exchange": "polymarket",
    "outcome": "yes",
    "token_id": "21742633143...",
    "market_id": "0x1234abcd",
    "bids": [[0.65, 1000.0], [0.64, 2500.0]],
    "asks": [[0.66, 800.0], [0.67, 1500.0]],
    "timestamp": "2025-02-04T12:34:56Z"
  }
}
For real-time streaming, use the WebSocket API.