GET odds
从多个博彩公司获取指定比赛的详细赔率及元数据。
端点
GET /v4/odds请求参数
- fixtureId*
(string)— 比赛的唯一 ID - bookmakers
(string)— （可选）以逗号分隔的博彩公司列表 - oddsFormat
(string)— （可选）期望的赔率格式。可选值为:fractional,decimal,american - language
(string)— （可选）用于翻译标签的语言代码 - verbosity
(number)— （可选）响应的详细程度，值越大返回内容越详细。
请求示例
GET /v4/odds?fixtureId=id1000001761300517&oddsFormat=decimal&verbosity=3示例响应
{
"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": 0,
"hasOdds": true,
"startTime": "2025-08-16T16:30:00.000Z",
"trueStartTime": null,
"trueEndTime": null,
"updatedAt": "2025-07-27T16:37:57.903Z",
"participant1Name": "Wolverhampton Wanderers",
"participant2Name": "Manchester City",
"sportName": "Soccer",
"tournamentSlug": "premier-league",
"categorySlug": "england",
"categoryName": "England",
"tournamentName": "Premier League",
"bookmakerOdds": {
"pinnacle": {
"markets": {
"101": {
"outcomes": {
"101": {
"players": {
"0": {
"price": 5.97,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "home"
}
}
},
"102": {
"players": {
"0": {
"price": 4.84,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "draw"
}
}
},
"103": {
"players": {
"0": {
"price": 1.465,
"limit": 537.63,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "away"
}
}
}
},
"bookmakerMarketId": "line/29/1980/3192397468/0/moneyline"
},
"1010": {
"outcomes": {
"1010": {
"players": {
"0": {
"price": 1.641,
"limit": 390.02,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "2.5/over"
}
}
},
"1011": {
"players": {
"0": {
"price": 2.28,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "2.5/under"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127342/0/totals"
},
"1012": {
"outcomes": {
"1012": {
"players": {
"0": {
"price": 2.6,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "3.5/over"
}
}
},
"1013": {
"players": {
"0": {
"price": 1.492,
"limit": 508.13,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "3.5/under"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127345/0/totals"
},
"1074": {
"outcomes": {
"1074": {
"players": {
"0": {
"price": 3.42,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "0.25/home"
}
}
},
"1075": {
"players": {
"0": {
"price": 1.32,
"limit": 781.25,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "0.25/away"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127323/0/spreads"
},
"1076": {
"outcomes": {
"1076": {
"players": {
"0": {
"price": 2.75,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "0.5/home"
}
}
},
"1077": {
"players": {
"0": {
"price": 1.454,
"limit": 550.66,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "0.5/away"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127324/0/spreads"
},
"1078": {
"outcomes": {
"1078": {
"players": {
"0": {
"price": 2.44,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "0.75/home"
}
}
},
"1079": {
"players": {
"0": {
"price": 1.571,
"limit": 437.83,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "0.75/away"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127325/0/spreads"
},
"1080": {
"outcomes": {
"1080": {
"players": {
"0": {
"price": 2.11,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "1.0/home"
}
}
},
"1081": {
"players": {
"0": {
"price": 1.751,
"limit": 332.89,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "1.0/away"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127326/0/spreads"
},
"1082": {
"outcomes": {
"1082": {
"players": {
"0": {
"price": 1.819,
"limit": 305.25,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "1.25/home"
}
}
},
"1083": {
"players": {
"0": {
"price": 2.04,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "1.25/away"
}
}
}
},
"bookmakerMarketId": "line/29/1980/3192397468/0/spreads"
},
"1084": {
"outcomes": {
"1084": {
"players": {
"0": {
"price": 1.636,
"limit": 393.08,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "1.5/home"
}
}
},
"1085": {
"players": {
"0": {
"price": 2.31,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "1.5/away"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127327/0/spreads"
},
"1086": {
"outcomes": {
"1086": {
"players": {
"0": {
"price": 1.467,
"limit": 535.33,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "1.75/home"
}
}
},
"1087": {
"players": {
"0": {
"price": 2.74,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "1.75/away"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127328/0/spreads"
},
"1088": {
"outcomes": {
"1088": {
"players": {
"0": {
"price": 1.298,
"limit": 838.93,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "2.0/home"
}
}
},
"1089": {
"players": {
"0": {
"price": 3.58,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "2.0/away"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127329/0/spreads"
},
"1090": {
"outcomes": {
"1090": {
"players": {
"0": {
"price": 1.25,
"limit": 1000,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "2.25/home"
}
}
},
"1091": {
"players": {
"0": {
"price": 4.02,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "2.25/away"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127330/0/spreads"
},
"10166": {
"outcomes": {
"10166": {
"players": {
"0": {
"price": 1.233,
"limit": 1072.96,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "1.75/over"
}
}
},
"10167": {
"players": {
"0": {
"price": 4.09,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "1.75/under"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127339/0/totals"
},
"10168": {
"outcomes": {
"10168": {
"players": {
"0": {
"price": 1.282,
"limit": 886.52,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "2.0/over"
}
}
},
"10169": {
"players": {
"0": {
"price": 3.63,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "2.0/under"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127340/0/totals"
},
"10170": {
"outcomes": {
"10170": {
"players": {
"0": {
"price": 1.462,
"limit": 541.13,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "2.25/over"
}
}
},
"10171": {
"players": {
"0": {
"price": 2.73,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "2.25/under"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127341/0/totals"
},
"10172": {
"outcomes": {
"10172": {
"players": {
"0": {
"price": 1.806,
"limit": 310.17,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "2.75/over"
}
}
},
"10173": {
"players": {
"0": {
"price": 2.04,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "2.75/under"
}
}
}
},
"bookmakerMarketId": "line/29/1980/3192397468/0/totals"
},
"10174": {
"outcomes": {
"10174": {
"players": {
"0": {
"price": 2.05,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "3.0/over"
}
}
},
"10175": {
"players": {
"0": {
"price": 1.781,
"limit": 320.1,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "3.0/under"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127343/0/totals"
},
"10176": {
"outcomes": {
"10176": {
"players": {
"0": {
"price": 2.33,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "3.25/over"
}
}
},
"10177": {
"players": {
"0": {
"price": 1.609,
"limit": 410.51,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "3.25/under"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127344/0/totals"
},
"10178": {
"outcomes": {
"10178": {
"players": {
"0": {
"price": 3.08,
"limit": 250,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "3.75/over"
}
}
},
"10179": {
"players": {
"0": {
"price": 1.369,
"limit": 677.51,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "3.75/under"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127346/0/totals"
},
"10208": {
"outcomes": {
"10208": {
"players": {
"0": {
"price": 6.25,
"limit": 50,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "home"
}
}
},
"10209": {
"players": {
"0": {
"price": 2.59,
"limit": 50,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "draw"
}
}
},
"10210": {
"players": {
"0": {
"price": 1.943,
"limit": 53.02,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "away"
}
}
}
},
"bookmakerMarketId": "line/29/1980/3192397471/1/moneyline"
},
"10258": {
"outcomes": {
"10258": {
"players": {
"0": {
"price": 2.46,
"limit": 50,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "1.5/over"
}
}
},
"10259": {
"players": {
"0": {
"price": 1.549,
"limit": 91.07,
"active": true,
"changedAt": "2025-07-27T13:25:47.505Z",
"playerId": 0,
"bookmakerOutcomeId": "1.5/under"
}
}
}
},
"bookmakerMarketId": "line/29/1980/49743127391/1/totals"
}
},
"bookmakerIsActive": true,
"bookmakerFixtureId": "1610924789",
"fixturePath": "https://www.pinnacle.com/en/e/e/e/1610924789/#all"
}
}
}响应字段说明
顶级字段
- fixtureId
string— 比赛的内部唯一 ID。 - participant1Id
number— 第一参赛方的 ID。 - participant2Id
number— 第二参赛方的 ID。 - sportId
number— 体育项目 ID - tournamentId
number— 锦标赛 ID - seasonId
number|null— （可选）赛季 ID。 - externalProviders
(object)— 第三方数据源的 ID:- betradarId
(number|null)— （可选）由 Betradar 分配的 ID。 - mollybetId
(number|null)— （可选）由 Mollybet 分配的唯一 ID。 - opticoddsId
(number|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。
- betradarId
- statusId
number— 比赛当前状态。 - hasOdds
boolean— 指示该比赛是否有可用赔率。 - startTime
string— ISO 8601 格式的开始时间。 - trueStartTime
string|null— 比赛实际开始时间（如果可用）。 - trueEndTime
string|null— 比赛实际结束时间（如果可用）。 - updatedAt
string— ISO 8601 格式的最后更新时间。
备注
- 端点冷却时间：500ms