GET odds
Recupera cuotas detalladas y metadatos para un partido deportivo específico de varios bookmakers.
Endpoint
GET /v4/oddsParámetros de la petición
- fixtureId*
(string)— ID único del partido - bookmakers
(string)— (Opcional) Lista separada por comas de casas de apuestas - oddsFormat
(string)— (Opcional) Formato de cuotas deseado. Opciones:fractional,decimal,american - language
(string)— (Opcional) Código de idioma para etiquetas traducidas - verbosity
(number)— (Opcional) Nivel de detalle de la respuesta. Un valor más alto devuelve una salida más detallada.
Ejemplo de petición
GET /v4/odds?fixtureId=id1000001761300517&oddsFormat=decimal&verbosity=3Respuesta de muestra
{
"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"
}
}
}Desglose de campos de la respuesta
Campos de nivel superior
- fixtureId
string— ID interno único para el partido. - participant1Id
number— El ID del primer participante. - participant2Id
number— El ID del segundo participante. - sportId
number— ID de deporte - tournamentId
number— ID de torneo - seasonId
number|null— (Opcional) El ID de la temporada. - externalProviders
(object)— IDs de proveedores externos:- betradarId
(number|null)— (Opcional) El ID asignado por Betradar. - mollybetId
(number|null)— (Opcional) El ID único asignado por Mollybet. - opticoddsId
(number|null)— (Opcional) El ID único asignado por Opticodds. - lsportsId
(number|null)— (Opcional) El ID único asignado por LSports. - txoddsId
(number|null)— (Opcional) El ID único asignado por TXOdds. - sofascoreId
(number|null)— (Opcional) El ID asignado por Sofascore. - betgeniusId
(number|null)— (Opcional) El ID asignado por Betgenius. - flashscoreId
(string|null)— (Opcional) El ID asignado por Flashscore. - pinnacleId
(number|null)— (Opcional) El ID asignado por Pinnacle. - oddinId
(number|null)— (Opcional) El ID asignado por Oddin.
- betradarId
- statusId
number— El estado actual del partido. - hasOdds
boolean— Indica si el partido tiene cuotas disponibles. - startTime
string— Hora de inicio en formato ISO 8601. - trueStartTime
string|null— La hora real de inicio del partido, si está disponible. - trueEndTime
string|null— La hora real de fin del partido, si está disponible. - updatedAt
string— Hora de última actualización en formato ISO 8601.
Notas
- Enfriamiento del endpoint: 500ms
Página anteriorGET participants
Página siguienteGET odds_by_tournament