获取赛事

获取赛事

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://v5.oddspapi.io/zh/fixtures?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?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?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": "id1100013270505056",
    "status": {
      "live": true,
      "statusId": 1,
      "statusName": "Live"
    },
    "sport": {
      "sportId": 11,
      "sportName": "Basketball"
    },
    "tournament": {
      "tournamentId": 132,
      "tournamentName": "NBA",
      "categoryName": "USA"
    },
    "season": {
      "seasonId": 131631,
      "seasonName": "NBA 25/26",
      "seasonRound": null
    },
    "venue": {
      "venueId": 6054,
      "venueName": "Madison Square Garden",
      "venueLocation": "New York, NY, USA"
    },
    "startTime": 1776729600,
    "trueStartTime": "2026-04-21T00:09:08+00:00",
    "trueEndTime": null,
    "participants": {
      "participant1Id": 3421,
      "participant1RotNr": 303,
      "participant1Name": "New York Knicks",
      "participant1ShortName": "New York",
      "participant1Abbr": "NYK",
      "participant2Id": 3423,
      "participant2RotNr": 302,
      "participant2Name": "Atlanta Hawks",
      "participant2ShortName": "Atlanta",
      "participant2Abbr": "ATL"
    },
    "scores": {
      "p1": {
        "period": "p1",
        "participant1Score": 32,
        "participant2Score": 23,
        "updatedAt": "2026-04-21T00:59:42.287458+00:00"
      },
      "p2": {
        "period": "p2",
        "participant1Score": 29,
        "participant2Score": 31,
        "updatedAt": "2026-04-21T01:25:05.532295+00:00"
      },
      "result": {
        "period": "result",
        "participant1Score": 61,
        "participant2Score": 54,
        "updatedAt": "2026-04-21T01:24:37.154297+00:00"
      }
    },
    "clock": {
      "currentPeriod": null,
      "currentTime": null,
      "remainingTime": null,
      "remainingTimeInPeriod": null,
      "stopped": null
    },
    "expectedPeriods": 4,
    "periodLength": 12,
    "externalProviders": {
      "betgeniusId": 13808265,
      "betradarId": 70505056,
      "flashscoreId": "nTPkYS3K",
      "mollybetId": "2026-04-21,29093,29096",
      "oddinId": null,
      "opticoddsId": "20260421A1AB4678",
      "pinnacleId": 1628730839,
      "sofascoreId": 15935017,
      "lsportsId": null,
      "txoddsId": null
    },
    "bookmakers": {}
  }
]

GET

fixtures

获取赛事

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://v5.oddspapi.io/zh/fixtures?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?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?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": "id1100013270505056",
    "status": {
      "live": true,
      "statusId": 1,
      "statusName": "Live"
    },
    "sport": {
      "sportId": 11,
      "sportName": "Basketball"
    },
    "tournament": {
      "tournamentId": 132,
      "tournamentName": "NBA",
      "categoryName": "USA"
    },
    "season": {
      "seasonId": 131631,
      "seasonName": "NBA 25/26",
      "seasonRound": null
    },
    "venue": {
      "venueId": 6054,
      "venueName": "Madison Square Garden",
      "venueLocation": "New York, NY, USA"
    },
    "startTime": 1776729600,
    "trueStartTime": "2026-04-21T00:09:08+00:00",
    "trueEndTime": null,
    "participants": {
      "participant1Id": 3421,
      "participant1RotNr": 303,
      "participant1Name": "New York Knicks",
      "participant1ShortName": "New York",
      "participant1Abbr": "NYK",
      "participant2Id": 3423,
      "participant2RotNr": 302,
      "participant2Name": "Atlanta Hawks",
      "participant2ShortName": "Atlanta",
      "participant2Abbr": "ATL"
    },
    "scores": {
      "p1": {
        "period": "p1",
        "participant1Score": 32,
        "participant2Score": 23,
        "updatedAt": "2026-04-21T00:59:42.287458+00:00"
      },
      "p2": {
        "period": "p2",
        "participant1Score": 29,
        "participant2Score": 31,
        "updatedAt": "2026-04-21T01:25:05.532295+00:00"
      },
      "result": {
        "period": "result",
        "participant1Score": 61,
        "participant2Score": 54,
        "updatedAt": "2026-04-21T01:24:37.154297+00:00"
      }
    },
    "clock": {
      "currentPeriod": null,
      "currentTime": null,
      "remainingTime": null,
      "remainingTimeInPeriod": null,
      "stopped": null
    },
    "expectedPeriods": 4,
    "periodLength": 12,
    "externalProviders": {
      "betgeniusId": 13808265,
      "betradarId": 70505056,
      "flashscoreId": "nTPkYS3K",
      "mollybetId": "2026-04-21,29093,29096",
      "oddinId": null,
      "opticoddsId": "20260421A1AB4678",
      "pinnacleId": 1628730839,
      "sofascoreId": 15935017,
      "lsportsId": null,
      "txoddsId": null
    },
    "bookmakers": {}
  }
]

授权

apiKey

string

query

必填

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

查询参数

fixtureIds

string | null

Comma/space-separated fixture IDs (fast path).

sportId

integer | null

Single sport ID.

tournamentId

integer | null

Single tournament ID.

bookmakers

string | null

Comma/space-separated bookmaker slugs. If present (even empty), includes bookmaker META and filters by mapping.

startTimeFrom

integer | null

Start time from (epoch seconds).

startTimeTo

integer | null

Start time to (epoch seconds).

响应

Returns Fixture[] (fixture meta objects)

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 等）的原生标识符。

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 参考

授权

查询参数

响应