GET odds
Retrieves detailed odds and metadata for a specified sports fixture from various bookmakers.
Endpoint
GET /v4/oddsRequest Parameters
- fixtureId*
(string)— Unique ID of the fixture - bookmakers
(string)— (Optional) Comma-separated list of bookmakers - oddsFormat
(string)— (Optional) Desired odds format. Options:fractional,decimal,american - language
(string)— (Optional) Language code for translated labels - verbosity
(number)— (Optional) Level of response detail. Higher value returns more verbose output.
Example Request
GET /v4/odds?fixtureId=id1000001761300517&oddsFormat=decimal&verbosity=3Sample Response
{
"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"
}
}
}Response Fields Breakdown
Top-Level Fields
- fixtureId
string— Internal unique ID for the fixture. - participant1Id
number— The ID of the first participant. - participant2Id
number— The ID of the second participant. - sportId
number— Sport ID - tournamentId
number— Tournament ID - seasonId
number|null— (Optional) The ID of the season. - externalProviders
(object)— IDs from third-party providers:- betradarId
(number|null)— (Optional) The ID assigned by Betradar. - mollybetId
(number|null)— (Optional) The unique ID assigned by Mollybet. - opticoddsId
(number|null)— (Optional) The unique ID assigned by Opticodds. - lsportsId
(number|null)— (Optional) The unique ID assigned by LSports. - txoddsId
(number|null)— (Optional) The unique ID assigned by TXOdds. - sofascoreId
(number|null)— (Optional) The ID assigned by Sofascore. - betgeniusId
(number|null)— (Optional) The ID assigned by Betgenius. - flashscoreId
(string|null)— (Optional) The ID assigned by Flashscore. - pinnacleId
(number|null)— (Optional) The ID assigned by Pinnacle. - oddinId
(number|null)— (Optional) The ID assigned by Oddin.
- betradarId
- statusId
number— The current status of the fixture. - hasOdds
boolean— Whether the fixture has odds available. - startTime
string— ISO 8601 start time. - trueStartTime
string|null— The actual start time of the fixture, if available. - trueEndTime
string|null— The actual end time of the fixture, if available. - updatedAt
string— ISO 8601 last update time.
Notes
- Endpoint cooldown: 500ms
Previous pageGET participants
Next pageGET odds_by_tournament