跳转到主要内容

基础 URL

集成期间可按需提供测试环境,它有自己的基础 URL 和密钥。每个路径都以 /v1 开头。请在 x-api-key 头中发送您的密钥;参见认证。

语言

只有行情数据带有语言,作为其路径的第一段:/v1/{lang}/…。lang 取 en、es、fr、pt、de、it、ru、zh 之一。
  • 名称(例如 sportName)在有翻译时使用该语言。
  • 标识符永远不依赖于语言。
  • API 参考以英语展示行情数据路径:将 en 替换为您需要的语言。
  • 其他端点没有需要翻译的文本,也不带语言。
在 WebSocket 上,登录时的 lang 决定 fixtures 频道的语言;参见 WebSocket 语言。

约定

  • 请求和响应均使用 JSON,请求体需带上 content-type: application/json。
  • 金额是一个包含十进制字符串、以整数分表示的同一金额和货币的对象:{ "amount": "12.50", "amountCents": 1250, "currency": "USD" }。参见金额。
  • 价格是以字符串表示的十进制赔率:"1.95"。
  • 时间采用 UTC 的 ISO 8601 格式:"2026-10-05T14:30:00.000Z"。
  • 标识符:订单和注单使用 UUID。fixtureId、outcomeId 和 playerId 是行情数据所使用的 OddsPapi 标识符。
  • 列表按最新优先排序,并通过游标分页:将 nextCursor 作为 cursor 传回,直到它为 null。
  • 枚举可能新增取值。请妥善处理您不认识的取值。
  • 错误带有稳定的 code;参见错误。

端点

健康状态

GET /v1/health 是 /v1 下唯一无需 API 密钥的端点。
  • 状态。 每个服务的状态为 healthy、degraded 或 unhealthy。status 取其中最差的一个。
  • 200:API 健康或降级时返回。降级的 API 仍可下单。
  • 503:API 不健康时返回相同的响应体;API 被关闭时返回 503 PUBLIC_API_DISABLED。
  • 时效。 结果最多每 15 秒刷新一次:更频繁地轮询只会得到相同的结果。
  • 限制。 每个地址每分钟 120 个请求;参见限制。

账户

行情数据

行情数据是 OddsPapi v5,位于 /v1/{lang} 下,使用 OddsPapi 的路径、参数、响应和标识符。lang 参见语言。 其他路径返回 404。赔率仅限于您账户的博彩公司:请求其他博彩公司会返回 403 BOOKMAKER_NOT_AVAILABLE。
有关运动、赛事、盘口和选项如何组合在一起,以及一行赔率如何变成订单,参见行情数据与标识符。

投注单

投注单价格才是您下单所用的价格。它可能与行情数据中的赔率不同:参见行情赔率与投注单。

订单

注单、持仓与盈亏

从仪表板下达的订单和注单也会出现在这些端点中。

参考文档

侧边栏中的端点页面是生成的:
  • 健康状态、账户、投注单、订单、注单、持仓和盈亏。 来自 API 导出的 OpenAPI 契约:字段、类型和状态码与 API 完全一致。
  • 行情数据。 来自 OddsPapi v5 参考文档,仅限于 Apexium 提供的路径和参数。