GET odds

从多个博彩公司获取指定比赛的详细赔率及元数据。

端点

GET /v4/odds

请求参数

• fixtureId* (string) — 比赛的唯一 ID
• bookmakers (string) — （可选）以逗号分隔的博彩公司列表
• oddsFormat (string) — （可选）期望的赔率格式。可选值为: fractional, decimal, american
• language (string) — （可选）用于翻译标签的语言代码
• verbosity (number) — （可选）响应的详细程度，值越大返回内容越详细。

请求示例

GET /v4/odds?fixtureId=id1000003969653792&bookmakers=pinnacle&language=en&verbosity=3

示例响应

{
  "fixtureId": "id1000003969653792",
  "participant1Id": 1302,
  "participant2Id": 4872,
  "sportId": 10,
  "tournamentId": 39,
  "seasonId": 130951,
  "statusId": 0,
  "hasOdds": true,
  "startTime": "2026-04-13T17:00:00.000Z",
  "trueStartTime": null,
  "trueEndTime": null,
  "updatedAt": "2026-04-08T18:00:30.461Z",
  "externalProviders": {
    "betradarId": 69653792,
    "mollybetId": "2026-04-13,625,676",
    "opticoddsId": "20260413B49C7BD7",
    "lsportsId": null,
    "txoddsId": null,
    "sofascoreId": 15676262,
    "betgeniusId": 13679074,
    "flashscoreId": "nDaPAq53",
    "pinnacleId": 1627730447,
    "oddinId": null
  },
  "statusName": "Pre-Game",
  "participant1Name": "FC Fredericia",
  "participant1ShortName": "Fredericia",
  "participant1Abbr": "FRE",
  "participant2Name": "Vejle BK",
  "participant2ShortName": "Vejle",
  "participant2Abbr": "VEJ",
  "sportName": "Soccer",
  "tournamentSlug": "superliga",
  "categorySlug": "denmark",
  "categoryName": "Denmark",
  "tournamentName": "Superliga",
  "bookmakerOdds": {
    "pinnacle": {
      "bookmakerIsActive": true,
      "bookmakerFixtureId": "1627730447",
      "fixturePath": "https://www.pinnacle.com/en/e/e/e/1627730447/#all",
      "suspended": false,
      "markets": {
        "10286": {
          "bookmakerMarketId": "1627730447/6020879114/1628099951",
          "marketActive": true,
          "outcomes": {
            "10287": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "1628099962",
                  "bookmakerChangedAt": null,
                  "changedAt": "2026-04-13T09:00:11.194Z",
                  "limit": 125,
                  "playerName": null,
                  "price": 4.01,
                  "priceAmerican": "301",
                  "priceFractional": "301/100",
                  "mainLine": false,
                  "exchangeMeta": null
                }
              }
            }
          }
        }
      }
    }
  }
}

响应字段说明

顶级字段

• fixtureId string — 比赛的内部唯一 ID。
• participant1Id number — 第一参赛方的 ID。
• participant2Id number — 第二参赛方的 ID。
• sportId number — 体育项目 ID
• tournamentId number — 锦标赛 ID
• seasonId number|null — （可选）赛季 ID。
• statusId number — 比赛当前状态。
• hasOdds boolean — 指示该比赛是否有可用赔率。
• startTime string — ISO 8601 格式的开始时间。
• trueStartTime string|null — 比赛实际开始时间（如果可用）。
• trueEndTime string|null — 比赛实际结束时间（如果可用）。
• updatedAt string — ISO 8601 格式的最后更新时间。
• statusName string — 可读的赛事状态（例如：「Pre-Game」、「In-Play」、「Ended」）。
• participant1Name string — 第一参赛方名称（按你请求的语言）。
• participant1ShortName string — 第一参赛方的短显示名称。设置 language 参数时会被翻译。
• participant1Abbr string — 第一参赛方的 3 字母缩写。设置 language 参数时会被翻译。
• participant2Name string — 第二参赛方名称（按你请求的语言）。
• participant2ShortName string — 第二参赛方的短显示名称。设置 language 参数时会被翻译。
• participant2Abbr string — 第二参赛方的 3 字母缩写。设置 language 参数时会被翻译。
• sportName string — 运动项目名称。
• tournamentSlug string — URL 友好的锦标赛标识符。
• categorySlug string — 赛事类别的 slug（例如：「england」）。
• categoryName string — 类别的显示名称（例如：「England」）。
• tournamentName string — 锦标赛全名（设置 language 参数时会被翻译）。
• externalProviders (object) — 第三方数据源的 ID:
  • betradarId (number|null) — （可选）由 Betradar 分配的 ID。
  • mollybetId (string|null) — （可选）由 Mollybet 分配的唯一 ID。
  • opticoddsId (string|null) — （可选）由 Opticodds 分配的唯一 ID。
  • lsportsId (number|null) — （可选）由 LSports 分配的唯一 ID。
  • txoddsId (number|null) — （可选）由 TXOdds 分配的唯一 ID。
  • sofascoreId (number|null) — （可选）由 Sofascore 分配的 ID。
  • betgeniusId (number|null) — （可选）由 Betgenius 分配的 ID。
  • flashscoreId (string|null) — （可选）由 Flashscore 分配的 ID。
  • pinnacleId (number|null) — （可选）由 Pinnacle 分配的 ID。
  • oddinId (number|null) — （可选）由 Oddin 分配的 ID。

bookmakerOdds 对象

• bookmakerIsActive boolean — 此博彩公司当前是否对此赛事处于激活状态（通常表示我们是否从该博彩公司收集数据）。
• bookmakerFixtureId string — 博彩公司自有的赛事标识符。
• fixturePath string — 博彩公司网站上该赛事的直接 URL。
• suspended boolean — 此博彩公司的所有市场是否当前已被暂停。
• markets object — 以市场 ID 为键、市场数据为值的对象:
  • bookmakerMarketId string — 博彩公司的内部市场标识符。
  • marketActive boolean — 此特定市场当前是否处于激活状态。
  • outcomes object — 结果 ID 到结果数据的映射:
    • players object — 玩家 ID 到玩家级定价的映射:
      • active boolean — 当前是否提供此选项。
      • betslip string|null — 投注单深度链接或标识符（如可用）。
      • bookmakerOutcomeId string — 博彩公司的结果标识符（例如：「3.5/under」、「home」）。
      • bookmakerChangedAt string|null — 博彩公司上次报告变更的 ISO 8601 时间戳（如提供）。
      • changedAt string — 我们系统中记录的最后一次变更的 ISO 8601 时间戳。
      • limit number|null — 此选项允许的最大投注金额。
      • playerName string|null — 球员道具市场的球员姓名；标准市场为 null。
      • price number — 十进制格式的赔率。
      • priceAmerican string — 美式格式的赔率（例如：「-201」、「171」）。
      • priceFractional string — 分数格式的赔率（例如：「49/99」）。
      • mainLine boolean — 是否为该市场的主要/主线。
      • exchangeMeta any|null — 交易所类博彩公司的额外元数据（例如：流动性、lay 价格）。