GateData.AI

Prediction 事件

查询可交易的预测事件。

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

可查询数据

返回数据
可交易的预测事件
市场覆盖
Polymarket、predict.fun
查询粒度
每次返回一组事件，可按平台、状态或关键词筛选，不合并不同市场的盘口

认证

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

请求参数

事件筛选

均为可选；留空可返回事件列表。

querystringquery示例Fed rate cut可选

查询关键词、代码或名称。

venuePredictionVenue[]query示例polymarket可选

交易所标识。

statusstring[]query示例active可选

事件状态筛选。

分页

均为可选。

limitintegerquery示例20可选

返回条数。

cursorstringquery示例eyJvZmZzZXQiOjIwfQ可选

分页游标。

响应

events[]object[]

预测事件：event_ref、venue、title、status、markets_summary

event_refstring示例polymarket:139537

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

venuestring示例polymarket

预测场所（如 polymarket）

titlestring示例Record crypto liquidation in 2026?

事件标题

statusstring示例active

事件状态（如 active）

venue_event_idstring示例139537

场所原生事件 id

related_asset_ids[]string[]

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

related_entity_ids[]string[]

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

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

事件开启时间

resolved_atdatetime | null

结算时间。

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

venue 状态观察时间

metadataobject

响应状态与解析信息容器

data_statusDataStatus示例partial

ready / partial / no_data / …

paginationobject

分页信息：limit、row_count、next_cursor（存在下一游标字段时）

limitinteger示例10

本页条数上限

row_countinteger示例9

本页实际返回行数

next_cursorstring

存在下一页时的游标

limitations[]string[]示例data_partial

已知数据限制数组

updated_atdatetime | string示例2026-08-17T08:23:59Z

对象或响应最近更新时间

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。