历史赔率

历史赔率

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

const options = {method: 'GET'};

fetch('https://v5.oddspapi.io/zh/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/zh/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/zh/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/zh/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

历史赔率

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

const options = {method: 'GET'};

fetch('https://v5.oddspapi.io/zh/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/zh/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/zh/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/zh/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
        }
      }
    }
  }
}

授权

apiKey

string

query

必填

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

查询参数

fixtureId

string

必填

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.

响应

Returns FixtureHistoricalOddsResponse (fixture meta + time-series odds)

fixtureId

string

必填

赛事标识符：{providerSlug}{sportId}{tournamentId}{nativeId} —— 参见核心概念 → ID 结构。

status

object

必填

赛事的生命周期状态。

Show child attributes

sport

object

必填

运动引用。

Show child attributes

tournament

object

必填

锦标赛引用。

Show child attributes

season

object

必填

赛季引用（如已解析）。

Show child attributes

venue

object

必填

场馆引用（如已知）。

Show child attributes

startTime

integer

必填

Epoch seconds (UTC).

participants

object

必填

双方参赛者，含名称、轮转号和缩写。

Show child attributes

scores

object

必填

按赛段键组织的比分行（result、p1……）。

Show child attributes

clock

object | null

必填

比赛进行中的实时计时。

Show child attributes

externalProviders

object

必填

该赛事在外部数据源（betradar、pinnacle 等）的原生标识符。

odds

object

必填

Show child attributes

trueStartTime

string | null

实际开始时间（ISO 8601，一旦已知）—— 可能与计划的 startTime 不同。

trueEndTime

string | null

实际结束时间（ISO 8601，一旦已知）。

expectedPeriods

integer | null

该赛事预期的常规赛段数 —— 结合 periodLength 用于按运动/联赛解读赛段键。

periodLength

integer | null

常规赛段的时长（分钟）。

bookmakers

object

该赛事按博彩公司划分的可用性与新鲜度元数据。仅包含当前为该赛事提供有效实时赔率的博彩公司。在赛事和赔率端点中返回；在 CLV、历史赔率和结算响应中省略。

Show child attributes

入门

API 参考

授权

查询参数

响应