Prediction 市场详情
获取单个预测市场详情。
GET/api/v1/prediction/markets/{market_id}
可查询数据
- 返回数据
- 指定预测市场的流动性、24 小时成交量与状态
- 市场覆盖
- Polymarket、predict.fun
- 查询粒度
- 每次查询一个市场,同一事件下的其他市场需另行查询
认证
所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。
请求参数
对象定位
路径 ID 必填。
market_idstringpath示例polymarket:1090479必填预测市场标识,标识预测事件下的具体市场
关联筛选
均为可选。
event_refstringquery示例polymarket:139537可选关联事件标识,标识与当前对象关联的事件
market_refstringquery示例polymarket:1090479可选关联市场引用。
响应
market_idstring示例polymarket:1090479预测市场标识,标识预测事件下的具体市场
market_titlestring示例Record crypto liquidation in 2026?预测市场标题与平台原始标识
venue_market_idstring示例1090479预测市场标题与平台原始标识
event_refstring示例polymarket:139537关联事件标识,标识与当前对象关联的事件
venuestring示例polymarket所属平台与市场状态
statusstring示例active所属平台与市场状态
liquidity_usdnumber示例2799.77市场流动性与成交量
volume_24h_usdnumber示例0市场流动性与成交量
closes_atdatetime | null关闭 / 结算时间(有则返回)
resolved_atdatetime | null关闭 / 结算时间(有则返回)
market_countinteger示例1所属事件的市场数量
signal_timedatetime示例2026-08-17T07:00:00.000+0000领先市场信号时间(有则返回)
metadataobject
响应状态与解析信息容器
ready / partial / …
limitations[]string[]示例data_partial已知数据限制数组
updated_atdatetime | string示例2026-08-17T08:24:13Z对象或响应最近更新时间
partialboolean示例true响应是否仅含部分字段
object_refs[]object[]
统一对象引用数组
对象引用类型
idstring示例polymarket:1090479对象标识,标识 type 指定的具体对象
event_refstring关联事件标识,标识与当前对象关联的事件
market_idstring示例polymarket:1090479预测市场标识,标识预测事件下的具体市场
venuestring对象关联的平台代码
错误与降级
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。