GateData.AI

Current Order Book

Get the current prediction-market order book.

GET/api/v1/prediction/order-book/current
Domain
Prediction
Level
Prediction market
MCP tool
prediction_markets_query (task=order_book)

Available data

Returns
The current prediction-market order book
Market coverage
Polymarket
Query granularity
One market per query; venue and market are required, and books are not merged

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Market positioning

venue and market_id are both required.

venuePredictionVenuequeryExamplepolymarketrequired

Prediction-market venue.

market_idstringqueryExamplepolymarket:1090479required

Prediction market ID.

Order-book options

All optional.

depth5 | 10 | 20 | 50queryExample20optional

Book depth; defaults to 20.

sideOrderBookSidequeryExamplebothoptional

Return yes, no, or both sides.

Response

best_bidobject

Top-of-book bid probabilities for yes / no

yesnumberExample0.061

Best bid probability on yes

nonumberExample0.903

Best bid probability on no

best_askobject

Top-of-book ask probabilities for yes / no

yesnumberExample0.097

Best ask probability on yes

nonumberExample0.939

Best ask probability on no

spreadobject

yes / no spread

yesnumberExample0.036000000000000004

Yes-side spread

nonumberExample0.03599999999999992

No-side spread

top_depth_usdobject

Top ask / bid depth for yes and no

yesobject

Yes-side top depth

asknumberExample4634.917589999999

Yes-side top ask depth (USD)

bidnumberExample107.88773

Yes-side top bid depth (USD)

noobject

No-side top depth

asknumberExample42768.94227

No-side top ask depth (USD)

bidnumberExample4245.0624099999995

No-side top bid depth (USD)

book_levelsobject

Outcome-sided depth; each of yes / no has bids and asks

yesobject

Yes-side depth (bids / asks)

bids[]array[object (OrderBookLevel)]

Yes-side bid levels; wire format is [price, size] tuples

asks[]array[object (OrderBookLevel)]

Yes-side ask levels; wire format is [price, size] tuples

noobject

No-side depth (bids / asks)

bids[]array[object (OrderBookLevel)]

No-side bid levels; wire format is [price, size] tuples

asks[]array[object (OrderBookLevel)]

No-side ask levels; wire format is [price, size] tuples

market_idstringExamplepolymarket:1090479

Prediction market identifier

event_refstringExamplepolymarket:139537

Related event identifier

snapshot_timestring | integerExample1786955032520

Snapshot time, cache hit status, and data request count; also returned in metadata

cache_statusstring | integerExamplemiss

Snapshot time, cache hit status, and data request count; also returned in metadata

provider_call_countstring | integerExample2

Snapshot time, cache hit status, and data request count; also returned in metadata

venuestringExamplepolymarket

Prediction venue (e.g. polymarket)

metadataobject

Response status and resolution information

cache_statusstringExamplemiss

Cache hit / miss when distinct from the top-level field

provider_call_countintegerExample2

Upstream call count in metadata

data_statusDataStatusExampleready

ready / partial / …

limitations[]string[]

Known data limitations

updated_atdatetime | stringExample2026-08-17T08:24:37Z

Most recent object or response update time

object_refs[]object[]

Unified object references

typeObjectRefTypeExamplemarket

Object reference type

idstringExamplepolymarket:1090479

Canonical object identifier

event_refstring

Related event identifier

market_idstringExamplepolymarket:1090479

Canonical market object identifier

venuestringExamplepolymarket

Related platform code

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.