GET odds-by-tournaments

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

端点

GET /v4/odds-by-tournaments

请求参数

• tournamentIds* (string) — 以逗号分隔的锦标赛 ID 列表。
• bookmaker (string) — （可选）要返回其赔率的博彩公司 slug。
• verbosity (number) — （可选）响应的详细程度，用于控制返回数据量。
• oddsFormat (string) — （可选）响应中赔率的格式（例如： decimal, american).

请求示例

GET /v4/odds-by-tournaments?tournamentIds=17

响应示例

[
  {
    "fixtureId": "id1000001761300517",
    "participant1Id": 3,
    "participant2Id": 17,
    "sportId": 10,
    "tournamentId": 17,
    "seasonId": null,
    "externalProviders": {
      "betradarId": 61300517,
      "mollybetId": null,
      "opticoddsId": null,
      "lsportsId": null,
      "txoddsId": null,
      "sofascoreId": null,
      "betgeniusId": 12482853,
      "flashscoreId": null,
      "pinnacleId": 1610924789,
      "oddinId": null
    },
    "statusId": null,
    "hasOdds": true,
    "startTime": "2025-08-16T16:30:00.000Z",
    "trueStartTime": null,
    "trueEndTime": null,
    "updatedAt": "2025-07-14T20:06:02.074Z",
    "participant1Name": "Wolverhampton Wanderers",
    "participant2Name": "Manchester City",
    "sportName": "Soccer",
    "tournamentSlug": "premier-league",
    "categorySlug": "england",
    "categoryName": "England",
    "tournamentName": "Premier League",
    "bookmakerOdds": {
      "pinnacle": {
        "bookmakerFixtureId": "1610924789",
        "fixturePath": "https://www.pinnacle.com/en/e/e/e/1610924789/#all",
        "bookmakerIsActive": true,
        "markets": {
          "101": {
            "bookmakerMarketId": "line/29/1980/3180242530/0/moneyline",
            "outcomes": {
              "101": {
                "players": {
                  "0": {
                    "price": 5.84,
                    "limit": 250,
                    "active": true,
                    "changedAt": "2025-07-17T10:45:56.606Z",
                    "playerId": 0,
                    "bookmakerOutcomeId": "home"
                  }
                }
              },
              "102": {
                "players": {
                  "0": {
                    "price": 4.76,
                    "limit": 250,
                    "active": true,
                    "changedAt": "2025-07-17T10:45:56.606Z",
                    "playerId": 0,
                    "bookmakerOutcomeId": "draw"
                  }
                }
              },
              "103": {
                "players": {
                  "0": {
                    "price": 1.454,
                    "limit": 550.66,
                    "active": true,
                    "changedAt": "2025-07-17T10:45:56.606Z",
                    "playerId": 0,
                    "bookmakerOutcomeId": "away"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
]

响应 (200 OK)

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

• fixtureId(string) — 用于获取比分的比赛唯一标识符。
• sportId(number) — 体育项目的唯一标识符，该 ID 必须对应一个已存在的体育项目。
• tournamentId(string) — 锦标赛的唯一标识符，该 ID 必须对应一个已存在的锦标赛。
• startTime(string) — ISO 8601 格式的开始时间。
• participant1Name(string) — 第一参赛方名称（按你请求的语言）。
• participant2Name(string) — 第二参赛方名称（按你请求的语言）。
• bookmakerOdds (object) — 按博彩公司 slug 分组的赔率:
  • bookmakerFixtureId (string) — 该博彩公司内部使用的比赛（fixture）唯一 ID。
  • fixturePath (string) — 指向该比赛在博彩公司站点上的投注页面链接。
  • bookmakerIsActive (boolean) — 指示该博彩公司当前是否为此比赛提供赔率。
  • markets (object) — 包含市场 ID 作为键及其对应市场数据的对象。:
    • bookmakerMarketId (string) — 博彩公司内部使用的市场 ID 或路径。
    • outcomes (object) — 从结果 ID 到结果数据的映射。 每个结果对象包含球员级别的定价信息。:
      • players (object) — 每个结果对应一个或多个有赔率的球员。:
        • price (number) — 提供的价格（赔率）。
        • limit (number) — 该赔率允许的最大投注额。
        • active (boolean) — 指示该赔率当前是否处于激活状态。
        • changedAt (string) — 该赔率最近一次变更的时间戳。
        • playerId (number) — 球员 ID（通常为 0).
        • bookmakerOutcomeId (string) — 博彩公司定义的结果标签。