↑ ↓ move · Enter open · Esc close

REST API / Prices and books / Unified Orderbook

Unified Orderbook

Live unified orderbook for a market match group across all platforms. Aggregates bid/ask depth from Kalshi, Polymarket, Polymarket US, Opinion, and Predict.fun into a single combined view. Use the group_id from the matching-markets or events endpoints.

GET/v2/unified-orderbook

Parameters

group_idintegerrequired

Market match group ID (required). Get this from /v2/matching-markets, /v2/events, or /v2/search.

Response

event_namestring

Event name for the matched group.

candidatestring

Candidate / group title.

platformsobject

Per-platform orderbook data.

Show 3 fields
kalshiobject

Kalshi orderbook (if available).

Show 5 fields
ticker / token_idstring

Platform-native identifier.

market_idstring

Platform market ID.

timestampnumber

Unix timestamp in milliseconds.

bidsarray[]

Bid levels [price, size], sorted descending.

Show 2 fields
[0]number

Price in cents (0-100).

[1]number

Size (contracts) at this level.

asksarray[]

Ask levels [price, size], sorted ascending.

Show 2 fields
[0]number

Price in cents (0-100).

[1]number

Size (contracts) at this level.

polymarketobject

Polymarket orderbook (if available).

Show 5 fields
ticker / token_idstring

Platform-native identifier.

market_idstring

Platform market ID.

timestampnumber

Unix timestamp in milliseconds.

bidsarray[]

Bid levels [price, size], sorted descending.

Show 2 fields
[0]number

Price in cents (0-100).

[1]number

Size (contracts) at this level.

asksarray[]

Ask levels [price, size], sorted ascending.

Show 2 fields
[0]number

Price in cents (0-100).

[1]number

Size (contracts) at this level.

opinionobject

Opinion orderbook (if available).

Show 5 fields
ticker / token_idstring

Platform-native identifier.

market_idstring

Platform market ID.

timestampnumber

Unix timestamp in milliseconds.

bidsarray[]

Bid levels [price, size], sorted descending.

Show 2 fields
[0]number

Price in cents (0-100).

[1]number

Size (contracts) at this level.

asksarray[]

Ask levels [price, size], sorted ascending.

Show 2 fields
[0]number

Price in cents (0-100).

[1]number

Size (contracts) at this level.

combinedobject

Unified orderbook aggregated across all platforms.

Show 2 fields
bidsarray[]

Aggregated bid levels across all platforms.

Show 2 fields
[0]number

Price in cents (0-100).

[1]number

Size (contracts) at this level.

asksarray[]

Aggregated ask levels across all platforms.

Show 2 fields
[0]number

Price in cents (0-100).

[1]number

Size (contracts) at this level.

Full API response