赛事赔率

赛事赔率

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://v5.oddspapi.io/zh/fixtures/odds?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?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?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": "id1100013270505136",
  "status": {
    "live": false,
    "statusId": 0,
    "statusName": "Pre-Game"
  },
  "sport": {
    "sportId": 11,
    "sportName": "Basketball"
  },
  "tournament": {
    "tournamentId": 132,
    "tournamentName": "NBA",
    "categoryName": "USA"
  },
  "season": {
    "seasonId": 131631,
    "seasonName": "NBA 25/26",
    "seasonRound": null
  },
  "venue": {
    "venueId": 6112,
    "venueName": "Frost Bank Center",
    "venueLocation": "San Antonio, TX, USA"
  },
  "startTime": 1776816000,
  "trueStartTime": null,
  "trueEndTime": null,
  "participants": {
    "participant1Id": 3429,
    "participant1RotNr": 301,
    "participant1Name": "San Antonio Spurs",
    "participant1ShortName": "San Antonio",
    "participant1Abbr": "SAS",
    "participant2Id": 3414,
    "participant2RotNr": 300,
    "participant2Name": "Portland Trail Blazers",
    "participant2ShortName": "Portland",
    "participant2Abbr": "POR"
  },
  "scores": {},
  "clock": {
    "currentPeriod": null,
    "currentTime": null,
    "remainingTime": null,
    "remainingTimeInPeriod": null,
    "stopped": null
  },
  "expectedPeriods": 4,
  "periodLength": 12,
  "externalProviders": {
    "betgeniusId": 13808312,
    "betradarId": 70505136,
    "flashscoreId": "ruuPcnS7",
    "mollybetId": "2026-04-22,29115,29108",
    "oddinId": null,
    "opticoddsId": "20260422A553CF52",
    "pinnacleId": 1628488896,
    "sofascoreId": 15934995,
    "lsportsId": null,
    "txoddsId": null
  },
  "odds": {
    "pinnacle": {
      "id1100013270505136:pinnacle:111:0": {
        "bookmaker": "pinnacle",
        "outcomeId": 111,
        "playerId": 0,
        "active": true,
        "price": 1.155,
        "marketActive": true,
        "mainLine": true,
        "bookmakerMarketId": "line/4/487/1628488896/3565645414/0/moneyline",
        "bookmakerOutcomeId": "home",
        "bookmakerChangedAt": 1776717657043,
        "limit": 19354,
        "priceAmerican": -645,
        "priceFractional": "11/71",
        "marketId": 111,
        "changedAt": 1776717657402
      },
      "id1100013270505136:pinnacle:112:0": {
        "bookmaker": "pinnacle",
        "outcomeId": 112,
        "playerId": 0,
        "active": true,
        "price": 5.77,
        "marketActive": true,
        "mainLine": true,
        "bookmakerMarketId": "line/4/487/1628488896/3565645414/0/moneyline",
        "bookmakerOutcomeId": "away",
        "bookmakerChangedAt": 1776717657043,
        "limit": 3000,
        "priceAmerican": 477,
        "priceFractional": "477/100",
        "marketId": 111,
        "changedAt": 1776717657402
      }
    }
  },
  "bookmakers": {
    "pinnacle": {
      "bookmaker": "pinnacle",
      "bookmakerFixtureId": "1628488896",
      "fixturePath": "https://www.pinnacle.com/en/e/e/e/1628488896/#all",
      "hasOdds": true,
      "staleOdds": false,
      "staleOddsResponseCode": null,
      "suspended": false,
      "participantsRotated": false,
      "meta": null,
      "updatedAt": "2026-04-20T13:54:39.472368+00:00"
    }
  }
}

GET

fixtures

odds

赛事赔率

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://v5.oddspapi.io/zh/fixtures/odds?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?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?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": "id1100013270505136",
  "status": {
    "live": false,
    "statusId": 0,
    "statusName": "Pre-Game"
  },
  "sport": {
    "sportId": 11,
    "sportName": "Basketball"
  },
  "tournament": {
    "tournamentId": 132,
    "tournamentName": "NBA",
    "categoryName": "USA"
  },
  "season": {
    "seasonId": 131631,
    "seasonName": "NBA 25/26",
    "seasonRound": null
  },
  "venue": {
    "venueId": 6112,
    "venueName": "Frost Bank Center",
    "venueLocation": "San Antonio, TX, USA"
  },
  "startTime": 1776816000,
  "trueStartTime": null,
  "trueEndTime": null,
  "participants": {
    "participant1Id": 3429,
    "participant1RotNr": 301,
    "participant1Name": "San Antonio Spurs",
    "participant1ShortName": "San Antonio",
    "participant1Abbr": "SAS",
    "participant2Id": 3414,
    "participant2RotNr": 300,
    "participant2Name": "Portland Trail Blazers",
    "participant2ShortName": "Portland",
    "participant2Abbr": "POR"
  },
  "scores": {},
  "clock": {
    "currentPeriod": null,
    "currentTime": null,
    "remainingTime": null,
    "remainingTimeInPeriod": null,
    "stopped": null
  },
  "expectedPeriods": 4,
  "periodLength": 12,
  "externalProviders": {
    "betgeniusId": 13808312,
    "betradarId": 70505136,
    "flashscoreId": "ruuPcnS7",
    "mollybetId": "2026-04-22,29115,29108",
    "oddinId": null,
    "opticoddsId": "20260422A553CF52",
    "pinnacleId": 1628488896,
    "sofascoreId": 15934995,
    "lsportsId": null,
    "txoddsId": null
  },
  "odds": {
    "pinnacle": {
      "id1100013270505136:pinnacle:111:0": {
        "bookmaker": "pinnacle",
        "outcomeId": 111,
        "playerId": 0,
        "active": true,
        "price": 1.155,
        "marketActive": true,
        "mainLine": true,
        "bookmakerMarketId": "line/4/487/1628488896/3565645414/0/moneyline",
        "bookmakerOutcomeId": "home",
        "bookmakerChangedAt": 1776717657043,
        "limit": 19354,
        "priceAmerican": -645,
        "priceFractional": "11/71",
        "marketId": 111,
        "changedAt": 1776717657402
      },
      "id1100013270505136:pinnacle:112:0": {
        "bookmaker": "pinnacle",
        "outcomeId": 112,
        "playerId": 0,
        "active": true,
        "price": 5.77,
        "marketActive": true,
        "mainLine": true,
        "bookmakerMarketId": "line/4/487/1628488896/3565645414/0/moneyline",
        "bookmakerOutcomeId": "away",
        "bookmakerChangedAt": 1776717657043,
        "limit": 3000,
        "priceAmerican": 477,
        "priceFractional": "477/100",
        "marketId": 111,
        "changedAt": 1776717657402
      }
    }
  },
  "bookmakers": {
    "pinnacle": {
      "bookmaker": "pinnacle",
      "bookmakerFixtureId": "1628488896",
      "fixturePath": "https://www.pinnacle.com/en/e/e/e/1628488896/#all",
      "hasOdds": true,
      "staleOdds": false,
      "staleOddsResponseCode": null,
      "suspended": false,
      "participantsRotated": false,
      "meta": null,
      "updatedAt": "2026-04-20T13:54:39.472368+00:00"
    }
  }
}

授权

apiKey

string

query

必填

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

查询参数

fixtureId

string

必填

Single fixture ID (e.g. id1400003160574219).

bookmakers

string | null

Comma/space-separated bookmaker slugs (default: all).

since

integer | null

changedAt >= since (ms)

marketActive

boolean | null

If set, filter by marketActive flag.

mainLine

boolean | null

If set, filter by mainLine flag.

响应

Returns FixtureOddsResponse (fixture meta + odds + bookmaker meta)

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

授权

查询参数

响应