GateData.AI

Prediction 事件详情

获取单个预测事件详情。

GET/api/v1/prediction/events/{event_id}
数据域
预测市场
解析层级
预测事件
MCP 工具
prediction_markets_query (task=event_detail)

可查询数据

返回数据
指定预测事件的标题、状态与下属市场摘要
市场覆盖
Polymarket、predict.fun
查询粒度
每次查询一个事件，不合并其他事件的市场

认证

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

请求参数

对象定位

路径 ID 必填。

event_idstringpath示例polymarket:139537必填

预测事件 event_ref（如 polymarket:139537）。

关联筛选

均为可选。

event_refstringquery示例polymarket:139537可选

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

market_refstringquery示例polymarket:1090479可选

关联市场引用。

响应

event_refstring示例polymarket:139537

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

venuestring示例polymarket

事件所属平台、标题与状态

titlestring示例Record crypto liquidation in 2026?

事件所属平台、标题与状态

statusstring示例active

事件所属平台、标题与状态

markets_summaryobject

领先市场、流动性、成交量

lead_market_idstring示例polymarket:1090479

领先市场 id

liquidity_usdnumber示例2799.77

领先市场流动性（USD）

market_countinteger示例1

事件下市场数量

volume_24h_usdnumber示例0

24h 成交额（USD）

closes_atdatetime | null

venue 时间戳。

opened_atdatetime | null示例2026-01-03T05:41:53.000+0000

venue 时间戳。

resolved_atdatetime | null

venue 时间戳。

status_as_ofdatetime | null示例2026-08-17T06:42:31.000+0000

venue 时间戳。

market_countinteger示例1

事件下的市场数量

venue_event_idstring示例139537

venue 原生事件 ID

related_asset_ids[]string[]

资产标识数组，标识股票、加密资产等资产对象

related_entity_ids[]string[]

主体标识数组，标识公司、项目方或协议等主体

signal_timedatetime示例2026-08-17T07:00:00.000+0000

领先市场的信号时间，metadata.signal_time 中也会返回

metadataobject

响应状态与解析信息容器

data_statusDataStatus示例partial

ready / partial / …

signal_timedatetime | string示例2026-08-17T07:00:00.000+0000

metadata 中的信号时间（有则返回）

limitations[]string[]示例data_partial

已知数据限制数组

updated_atdatetime | string示例2026-08-17T07:00:00.000+0000

对象或响应最近更新时间

partialboolean示例true

响应是否仅含部分字段

object_refs[]object[]

统一对象引用数组

typeObjectRefType示例event

对象引用类型

idstring示例polymarket:139537

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

event_refstring示例polymarket:139537

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

market_idstring

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

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。