跳转到主要内容
GET
/
fixtures
获取赛事
curl --request GET \
  --url 'https://v5.oddspapi.io/zh/fixtures?apiKey='
[
  {
    "fixtureId": "id1400003160574219",
    "status": {
      "live": false,
      "statusId": 2,
      "statusName": "Finished"
    },
    "sport": {
      "sportId": 11,
      "sportName": "Basketball"
    },
    "tournament": {
      "tournamentId": 132,
      "tournamentName": "NBA",
      "categoryName": "USA"
    },
    "season": {
      "seasonId": 131631,
      "seasonName": "NBA 25/26"
    },
    "startTime": 1766685600,
    "trueStartTime": "2025-12-25T18:00:17.744256+00:00",
    "trueEndTime": "2025-12-25T21:09:09.345372+00:00",
    "participants": {
      "participant1Id": 3423,
      "participant1RotNr": null,
      "participant1Name": "Atlanta Hawks",
      "participant1Abbr": null,
      "participant2Id": 3435,
      "participant2RotNr": null,
      "participant2Name": "Miami Heat",
      "participant2Abbr": null
    },
    "scores": {
      "p1": {
        "period": "p1",
        "participant1Score": 3,
        "participant2Score": 7,
        "updatedAt": "2025-12-25T18:34:06.103743+00:00"
      },
      "result": {
        "period": "result",
        "participant1Score": 23,
        "participant2Score": 30,
        "updatedAt": "2025-12-25T20:59:04.218194+00:00"
      }
    },
    "expectedPeriods": 4,
    "periodLength": 15,
    "externalProviders": {
      "betgeniusId": 12842138,
      "betradarId": 62924759,
      "flashscoreId": "Cx9GSSID",
      "mollybetId": "2025-12-27,29096,29098",
      "oddinId": null,
      "opticoddsId": "2025122770E16F76",
      "pinnacleId": 1621504021,
      "sofascoreId": null,
      "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
必填
status
object
必填
sport
object
必填
tournament
object
必填
season
object
必填
startTime
integer
必填
participants
object
必填
scores
object
必填
externalProviders
object
必填
bookmakers
object
必填
trueStartTime
string | null
trueEndTime
string | null
expectedPeriods
integer | null
periodLength
integer | null