GateData.AI

当前盘口

获取预测市场当前盘口。

GET/api/v1/prediction/order-book/current
数据域
预测市场
解析层级
预测市场
MCP 工具
prediction_markets_query (task=order_book)

可查询数据

返回数据
预测市场当前盘口
市场覆盖
Polymarket
查询粒度
每次查询一个市场，需指定平台与市场，不合并其他市场盘口

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

请求参数

市场定位

venue 和 market_id 均为必填。

venuePredictionVenuequery示例polymarket必填

交易所标识。

market_idstringquery示例polymarket:1090479必填

预测市场标识，标识预测事件下的具体市场

盘口选项

均为可选。

depth5 | 10 | 20 | 50query示例20可选

盘口深度档位数。

sideOrderBookSidequery示例both可选

返回 yes、no 或双边盘口。

响应

best_bidobject

买一概率（yes / no）

yesnumber示例0.061

Yes 侧买一概率

nonumber示例0.903

No 侧买一概率

best_askobject

卖一概率（yes / no）

yesnumber示例0.097

Yes 侧卖一概率

nonumber示例0.939

No 侧卖一概率

spreadobject

yes / no 价差

yesnumber示例0.036000000000000004

Yes 侧价差

nonumber示例0.03599999999999992

No 侧价差

top_depth_usdobject

yes / no 顶档深度（USD）

yesobject

Yes 侧顶档深度

asknumber示例4634.917589999999

Yes 侧卖一深度（USD）

bidnumber示例107.88773

Yes 侧买一深度（USD）

noobject

No 侧顶档深度

asknumber示例42768.94227

No 侧卖一深度（USD）

bidnumber示例4245.0624099999995

No 侧买一深度（USD）

book_levelsobject

按结果侧的深度。

yesobject

Yes 侧深度（bids / asks）

bids[]array[object (OrderBookLevel)]

Yes 侧买单档位。

asks[]array[object (OrderBookLevel)]

Yes 侧卖单档位。

noobject

No 侧深度（bids / asks）

bids[]array[object (OrderBookLevel)]

No 侧买单档位。

asks[]array[object (OrderBookLevel)]

No 侧卖单档位。

market_idstring示例polymarket:1090479

预测市场标识，标识预测事件下的具体市场

event_refstring示例polymarket:139537

关联事件标识，标识与当前对象关联的事件

snapshot_timestring | integer示例1786955032520

快照时间、缓存命中情况与数据请求次数，metadata 中也会返回

cache_statusstring | integer示例miss

快照时间、缓存命中情况与数据请求次数，metadata 中也会返回

provider_call_countstring | integer示例2

快照时间、缓存命中情况与数据请求次数，metadata 中也会返回

venuestring示例polymarket

预测平台（如 polymarket）

metadataobject

响应状态与解析信息容器

cache_statusstring示例miss

缓存命中 / 未命中（与顶层字段并存时）

provider_call_countinteger示例2

metadata 中的上游调用次数

data_statusDataStatus示例ready

ready / partial / …

limitations[]string[]

已知数据限制数组

updated_atdatetime | string示例2026-08-17T08:24:37Z

对象或响应最近更新时间

object_refs[]object[]

统一对象引用数组

typeObjectRefType示例market

对象引用类型

idstring示例polymarket:1090479

对象标识，标识 type 指定的具体对象

event_refstring

关联事件标识，标识与当前对象关联的事件

market_idstring示例polymarket:1090479

预测市场标识，标识预测事件下的具体市场

venuestring示例polymarket

对象关联的平台代码

错误与降级

200
assets_resolve 名称多命中；从 data[] 候选确认。
200
对象已解析但无可用数据；empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效，或行情 listing 多命中；歧义响应含 required_params + candidates。
401
缺少 API Key，或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在；数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限；body 返回 retry_after，响应头同步返回 Retry-After。