GET odds-by-tournaments

获取指定锦标赛内所有比赛的赔率。

端点

GET /v4/odds-by-tournaments

请求参数

• tournamentIds* (string) — 以逗号分隔的锦标赛 ID 列表。
• bookmakers (string) — Docs.GetOddsByTournaments.bookmakers_param
• language (string) — （可选）翻译标签的语言代码（例如：en、de、es）。默认值为 en。
• verbosity (number) — （可选）响应的详细程度，用于控制返回数据量。
• oddsFormat (string) — （可选）响应中赔率的格式（例如： decimal, american).

请求示例

GET /v4/odds-by-tournaments?tournamentIds=17&bookmakers=pinnacle&language=en&verbosity=3

响应示例

{
  "fixtureId": "id1000001761301153",
  "participant1Id": 35,
  "participant2Id": 34,
  "sportId": 10,
  "tournamentId": 17,
  "seasonId": 130281,
  "statusId": 0,
  "hasOdds": true,
  "startTime": "2026-04-13T19:00:00.000Z",
  "trueStartTime": null,
  "trueEndTime": null,
  "updatedAt": "2026-04-06T23:17:08.202Z",
  "bookmakerOdds": {
    "pinnacle": {
      "bookmakerIsActive": true,
      "bookmakerFixtureId": "1626291706",
      "fixturePath": "https://www.pinnacle.com/en/e/e/e/1626291706/#all",
      "suspended": false,
      "markets": {
        "1012": {
          "bookmakerMarketId": "line/29/1980/1626291706/56152425451/0/totals",
          "marketActive": true,
          "outcomes": {
            "1012": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "3.5/over",
                  "bookmakerChangedAt": "2026-04-13T09:24:46.990Z",
                  "changedAt": "2026-04-13T09:24:47.424Z",
                  "limit": 20000,
                  "playerName": null,
                  "price": 2.71,
                  "priceAmerican": "171",
                  "priceFractional": "171/100",
                  "mainLine": false,
                  "exchangeMeta": null
                }
              }
            },
            "1013": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "3.5/under",
                  "bookmakerChangedAt": "2026-04-13T09:11:04.603Z",
                  "changedAt": "2026-04-13T09:11:05.099Z",
                  "limit": 40241,
                  "playerName": null,
                  "price": 1.497,
                  "priceAmerican": "-201",
                  "priceFractional": "49/99",
                  "mainLine": false,
                  "exchangeMeta": null
                }
              }
            }
          }
        }
      }
    }
  }
}

响应 (200 OK)

当请求成功时，服务器会返回状态码 200 并返回一个 JSON 对象，其中包含比赛及其对应的赔率。

顶级字段

• fixtureId (string) — 用于获取比分的比赛唯一标识符。
• participant1Id (number) — 第一参赛方的 ID。
• participant2Id (number) — 第二参赛方的 ID。
• sportId (number) — 体育项目的唯一标识符，该 ID 必须对应一个已存在的体育项目。
• tournamentId (number) — 锦标赛的唯一标识符，该 ID 必须对应一个已存在的锦标赛。
• seasonId (number|null) — 赛季 ID（如适用）。
• statusId (number) — 赛事状态码（例如：0 = 赛前，1 = 已安排，2 = 进行中，3 = 已结束）。
• hasOdds (boolean) — 此赛事是否有可用的赔率数据。
• startTime (string) — ISO 8601 格式的开始时间。
• trueStartTime (string|null) — 若与计划不同，则为实际开始时间（例如延迟开球）。
• trueEndTime (string|null) — 赛事的实际结束时间（如可用）。
• updatedAt (string) — 最后更新时间的 ISO 8601 时间戳（UTC）。
• bookmakerOdds (object) — 按博彩公司 slug 分组的赔率:
  • bookmakerIsActive (boolean) — 此博彩公司当前是否对此赛事处于激活状态（通常表示我们是否从该博彩公司收集数据）。
  • bookmakerFixtureId (string) — 该博彩公司内部使用的比赛（fixture）唯一 ID。
  • fixturePath (string) — 指向该比赛在博彩公司站点上的投注页面链接。
  • suspended (boolean) — 此博彩公司的所有市场是否当前已被暂停。
  • markets (object) — 以市场 ID 为键、市场数据为值的对象:
    • bookmakerMarketId (string) — 博彩公司内部使用的市场 ID 或路径。
    • marketActive (boolean) — 此特定市场当前是否处于激活状态。
    • outcomes (object) — 结果 ID 到结果数据的映射:
      • players (object) — 玩家 ID 到玩家级定价的映射:
        • active (boolean) — 指示该赔率当前是否处于激活状态。
        • betslip (string|null) — 投注单深度链接或标识符（如可用）。
        • bookmakerOutcomeId (string) — 博彩公司定义的结果标签。
        • bookmakerChangedAt (string|null) — 博彩公司上次报告变更的 ISO 8601 时间戳（如提供）。
        • changedAt (string) — 该赔率最近一次变更的时间戳。
        • limit (number|null) — 该赔率允许的最大投注额。
        • playerName (string|null) — 球员道具市场的球员姓名；标准市场为 null。
        • price (number) — 十进制格式的赔率。
        • priceAmerican (string) — 美式格式的赔率（例如：「-201」、「171」）。
        • priceFractional (string) — 分数格式的赔率（例如：「49/99」）。
        • mainLine (boolean) — 是否为该市场的主要/主线。
        • exchangeMeta (any|null) — 交易所类博彩公司的额外元数据（例如：流动性、lay 价格）。