Fixture Odds Historical

curl --request GET \
  --url 'https://v5.oddspapi.io/en/fixtures/odds/historical?apiKey='

const options = {method: 'GET'};

fetch('https://v5.oddspapi.io/en/fixtures/odds/historical?apiKey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://v5.oddspapi.io/en/fixtures/odds/historical?apiKey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://v5.oddspapi.io/en/fixtures/odds/historical?apiKey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://v5.oddspapi.io/en/fixtures/odds/historical?apiKey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "fixtureId": "id1400003160574219",
  "status": {
    "live": false,
    "statusId": 2,
    "statusName": "Finished"
  },
  "sport": {
    "sportId": 14,
    "sportName": "American Football"
  },
  "tournament": {
    "tournamentId": 31,
    "tournamentName": "NFL",
    "categoryName": "USA"
  },
  "season": {
    "seasonId": null,
    "seasonName": null,
    "seasonRound": null
  },
  "venue": {
    "venueId": null,
    "venueName": null,
    "venueLocation": null
  },
  "startTime": 1766685600,
  "trueStartTime": "2025-12-25T18:00:17.744256+00:00",
  "trueEndTime": "2025-12-25T21:09:09.345372+00:00",
  "participants": {
    "participant1Id": 4423,
    "participant1RotNr": null,
    "participant1Name": "Minnesota Vikings",
    "participant1ShortName": "Vikings",
    "participant1Abbr": null,
    "participant2Id": 4419,
    "participant2RotNr": null,
    "participant2Name": "Detroit Lions",
    "participant2ShortName": "Lions",
    "participant2Abbr": null
  },
  "scores": {},
  "clock": {
    "currentPeriod": null,
    "currentTime": null,
    "remainingTime": null,
    "remainingTimeInPeriod": null,
    "stopped": null
  },
  "expectedPeriods": 4,
  "periodLength": 15,
  "externalProviders": {},
  "odds": {
    "bet365": {
      "id1400003160574219:bet365:14198:0": {
        "1765975761422": {
          "bookmaker": "bet365",
          "outcomeId": 14198,
          "playerId": 0,
          "price": 1.952,
          "active": true,
          "changedAt": 1765975761422,
          "marketActive": true
        },
        "1766361894121": {
          "bookmaker": "bet365",
          "outcomeId": 14198,
          "playerId": 0,
          "price": 1.952,
          "active": true,
          "changedAt": 1766361894121,
          "marketActive": true
        }
      }
    }
  }
}

GET

fixtures

odds

historical

Fixture Odds Historical

curl --request GET \
  --url 'https://v5.oddspapi.io/en/fixtures/odds/historical?apiKey='

const options = {method: 'GET'};

fetch('https://v5.oddspapi.io/en/fixtures/odds/historical?apiKey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://v5.oddspapi.io/en/fixtures/odds/historical?apiKey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://v5.oddspapi.io/en/fixtures/odds/historical?apiKey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://v5.oddspapi.io/en/fixtures/odds/historical?apiKey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "fixtureId": "id1400003160574219",
  "status": {
    "live": false,
    "statusId": 2,
    "statusName": "Finished"
  },
  "sport": {
    "sportId": 14,
    "sportName": "American Football"
  },
  "tournament": {
    "tournamentId": 31,
    "tournamentName": "NFL",
    "categoryName": "USA"
  },
  "season": {
    "seasonId": null,
    "seasonName": null,
    "seasonRound": null
  },
  "venue": {
    "venueId": null,
    "venueName": null,
    "venueLocation": null
  },
  "startTime": 1766685600,
  "trueStartTime": "2025-12-25T18:00:17.744256+00:00",
  "trueEndTime": "2025-12-25T21:09:09.345372+00:00",
  "participants": {
    "participant1Id": 4423,
    "participant1RotNr": null,
    "participant1Name": "Minnesota Vikings",
    "participant1ShortName": "Vikings",
    "participant1Abbr": null,
    "participant2Id": 4419,
    "participant2RotNr": null,
    "participant2Name": "Detroit Lions",
    "participant2ShortName": "Lions",
    "participant2Abbr": null
  },
  "scores": {},
  "clock": {
    "currentPeriod": null,
    "currentTime": null,
    "remainingTime": null,
    "remainingTimeInPeriod": null,
    "stopped": null
  },
  "expectedPeriods": 4,
  "periodLength": 15,
  "externalProviders": {},
  "odds": {
    "bet365": {
      "id1400003160574219:bet365:14198:0": {
        "1765975761422": {
          "bookmaker": "bet365",
          "outcomeId": 14198,
          "playerId": 0,
          "price": 1.952,
          "active": true,
          "changedAt": 1765975761422,
          "marketActive": true
        },
        "1766361894121": {
          "bookmaker": "bet365",
          "outcomeId": 14198,
          "playerId": 0,
          "price": 1.952,
          "active": true,
          "changedAt": 1766361894121,
          "marketActive": true
        }
      }
    }
  }
}

Authorizations

apiKey

string

query

required

Your API key (query-based auth for v5).

Query Parameters

fixtureId

string

required

Single fixture ID (e.g. id1400003160574219).

bookmaker

string | null

Single bookmaker slug. RULE: If oddsIds is NOT provided, you must pass exactly ONE bookmaker.

oddsIds

string | null

Optional: comma/space-separated oddsIds to restrict the response.

Response

Returns FixtureHistoricalOddsResponse (fixture meta + time-series odds)

fixtureId

string

required

Fixture identifier: {providerSlug}{sportId}{tournamentId}{nativeId} — see Core Concepts → ID structure.

status

object

required

Lifecycle status of the fixture.

Show child attributes

sport

object

required

Sport reference.

Show child attributes

tournament

object

required

Tournament reference.

Show child attributes

season

object

required

Season reference, when resolved.

Show child attributes

venue

object

required

Venue reference, when known.

Show child attributes

startTime

integer

required

Epoch seconds (UTC).

participants

object

required

Both participants with names, rotation numbers and abbreviations.

Show child attributes

scores

object

required

Score rows keyed by period (result, p1, …).

Show child attributes

clock

object | null

required

Live match clock, while in play.

Show child attributes

externalProviders

object

required

Native identifiers of this fixture at external providers (betradar, pinnacle, …).

odds

object

required

Show child attributes

trueStartTime

string | null

Actual start time (ISO 8601), once known — may differ from the scheduled startTime.

trueEndTime

string | null

Actual end time (ISO 8601), once known.

expectedPeriods

integer | null

Number of regular periods expected for this fixture — use it (with periodLength) to interpret period keys per sport/league.

periodLength

integer | null

Length of a regular period in minutes.

bookmakers

object

Per-bookmaker availability and freshness metadata. Contains only bookmakers that currently offer valid realtime odds for this fixture. Present on fixture and odds endpoints; omitted on CLV, historical-odds and settlement responses.

Show child attributes

Getting Started

Reference

Fixture Odds Historical

Authorizations

Query Parameters

Response