GateData.AI

事件榜单

查看热门预测事件排行。

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

可查询数据

返回数据
热门预测事件排行
市场覆盖
Polymarket、predict.fun
查询粒度
每次返回一份排行；指定平台时只看该平台

认证

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

请求参数

榜单类型

ranking_type 必填。

ranking_typeRankingTypequery示例volume_24h必填

榜单排序指标。

筛选与返回

均为可选。

venuePredictionVenuequery示例polymarket可选

交易所标识。

statusstring[]query示例active可选

市场状态筛选。

limitintegerquery示例20可选

返回条数。

响应

rankings[]object[]

rank_no、rank_type、ranking_value、rank_date_utc、event_ref、venue_event_id、excluded_reasons、量/流动性

rank_nointeger示例1

排名名次

rank_typestring示例volume_24h

排行类型

ranking_valuenumber示例281664832

排名指标值

rank_date_utcdatetime | string示例2026-08-17

排名快照时间（UTC）

event_refstring示例polymarket:30615

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

venue_event_idstring示例30615

场所原生事件 id

titlestring示例World Cup Winner

事件标题

venuestring示例polymarket

预测场所

excluded_reasons[]string[]

未进入更严格排名的原因

liquidity_usdnumber示例595017090

事件流动性（USD）

volume_24h_usdnumber示例281664832

24h 成交额（USD）

metadataobject

响应状态与解析信息容器

paginationobject

分页信息：limit 与 row_count

limitinteger示例10

本页条数上限

row_countinteger示例10

本页实际返回行数

data_statusDataStatus示例ready

ready / partial / …

limitations[]string[]

已知数据限制数组

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

对象或响应最近更新时间

object_refs[]object[]

统一对象引用数组

typeObjectRefType示例event

对象引用类型

idstring示例polymarket:30615

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

event_refstring示例polymarket:30615

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

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。