跳转到主要内容
GET
/
fixtures
获取赛事
curl --request GET \
  --url 'https://v5.oddspapi.io/zh/fixtures?apiKey='
[
  {
    "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": {}
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.oddspapi.io/llms.txt

Use this file to discover all available pages before exploring further.

授权

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
必填
status
object
必填
sport
object
必填
tournament
object
必填
season
object
必填
venue
object
必填
startTime
integer
必填
participants
object
必填
scores
object
必填
clock
object
必填
externalProviders
object
必填
bookmakers
object
必填
trueStartTime
string | null
trueEndTime
string | null
expectedPeriods
integer | null
periodLength
integer | null