跳转到主要内容
GET
实时期货

授权

apiKey
string
query
必填

作为 apiKey 查询参数传入的 API 密钥。

查询参数

sportId
integer | null

按 sportId 过滤。

tournamentId
integer | null

按 tournamentId 过滤。

bookmakers
string | null

逗号或空格分隔的博彩公司标识(默认:全部)。

响应

Returns FutureMeta[] (live only)

futureId
string
必填

期货标识符:{prefix}{sportId}{seasonId}{futureMarketId} —— 参见核心概念 → 期货ID。锦标赛是期货上的一个字段,而非该 ID 的片段。

reissuedFutureId
string | null
必填

当一项被取消的期货以新的 id 重新上架时,这里是替代它的那项期货。null 才是常态:只有在期货已被取消(status.statusId 为 3)且替代期货确实已出现在数据流中时才会被填充,因此永久性取消会一直保持 null,而一项期货也可能在您首次看到它被取消之后才从 null 变为具体的 id。只指向一跳:若该替代期货本身也被取消,请继续跟随它自己的 reissuedFutureId。

previousFutureId
string | null
必填

reissuedFutureId 的反向指针:本项期货所替代的那项已取消期货。与正向指针不同,该字段位于一项正常开放的期货上,因此即使您从未见过那项被取消的期货,也能知道本项期货的来历。null 才是常态。最多只指向一跳、一个前身——反复跟随即可回溯到整条链的起点。若取消被撤销,该字段会被重新清空。

status
object
必填

期货的生命周期状态。

sport
object
必填

运动(或预测市场主题)引用。

tournament
object
必填

锦标赛引用。

season
object
必填

赛季引用。

startTime
integer
必填

Epoch seconds (UTC).

endTime
integer
必填

Epoch seconds (UTC).

market
object
必填

期货盘口引用(如冠军盘口)。

participants
object[]
必填

与本项期货关联的参赛方。生产环境目前不填充该字段——所有期货均返回 [](在覆盖 40 个运动项目的 2,018 项期货抽样中,无一携带参赛方),因此请改用 /participants 或赛事/赛季元数据来解析名称。

externalProviders
object
必填

该期货在外部数据源(polymarket、kalshi 等)的原生标识符。

bookmakers
object
必填

该期货按博彩公司划分的元数据。仅包含当前提供有效实时赔率的博彩公司(无则为空对象)。