赔率

主客和、让球及进球大小，另有马会球队盘口、角球与正确比分、赔率走势、凯利指数及交易所数据。

本页内容

赛事赔率

GET/v1/football/matches/{matchId}/odds

参数

matchIdinteger (int32)path必填
从实时比分或赛程列表获取的 Tipsme 数字比赛 ID，适用于比赛详情、赔率及分析；分析需要 Plus 或 Pro。在 API 参考查找此值

请求示例

请先填写必填参数：matchId

响应字段 · 26

选填栏位可能不会出现。API 会省略值为 null 的栏位；使用前请先检查栏位是否存在。栏位名称在所有语言中均相同。

字段	类型	说明
matchId	integer	Tipsme 比赛识别码。
lastUpdatedUtc	datetime可能省略	该场比赛任何赔率最后变动的时间。
matchResult	HadQuoteDto[]	主客和（主胜／和局／客胜）。
└bookmaker	string可能省略	博彩公司名称，末尾可能带星号。请以 /odds/bookmakers 提供的数字识别码建立网址。
└openHome	string可能省略	初始主胜赔率。
└openDraw	string可能省略	初始和局赔率。
└openAway	string可能省略	初始客胜赔率。
└closeHome	string可能省略	最新主胜赔率。
└closeDraw	string可能省略	最新和局赔率。
└closeAway	string可能省略	最新客胜赔率。
asianHandicap	HdpQuoteDto[]	亚洲让球盘口及赔率。
└bookmaker	string可能省略	博彩公司名称。
└openLine	string可能省略	初始让球盘口，例如 -0.5 表示主队让半球。
└openHome	string可能省略	初始盘口的主队赔率。
└openAway	string可能省略	初始盘口的客队赔率。
└closeLine	string可能省略	最新让球盘口。
└closeHome	string可能省略	最新主队赔率。
└closeAway	string可能省略	最新客队赔率。
overUnder	HiloQuoteDto[]	总入球大细盘口及赔率。
└bookmaker	string可能省略	博彩公司名称。
└openLine	string可能省略	初始总入球盘口，例如 2.5。
└openOver	string可能省略	初始大球赔率。
└openUnder	string可能省略	初始细球赔率。
└closeLine	string可能省略	最新总入球盘口。
└closeOver	string可能省略	最新大球赔率。
└closeUnder	string可能省略	最新细球赔率。

返回状态 200, 401, 403, 404, 429

前往试用

凯利指数

GET/v1/football/matches/{matchId}/odds/kelly

参数

matchIdinteger (int32)path必填
从实时比分或赛程列表获取的 Tipsme 数字比赛 ID，适用于比赛详情、赔率及分析；分析需要 Plus 或 Pro。在 API 参考查找此值

请求示例

请先填写必填参数：matchId

响应字段 · 21

选填栏位可能不会出现。API 会省略值为 null 的栏位；使用前请先检查栏位是否存在。栏位名称在所有语言中均相同。

字段	类型	说明
matchId	integer	Tipsme 比赛识别码。
opening	KellyQuoteDto[]	每间公司的初始报价。
└bookmaker	string可能省略	博彩公司名称。
└home	string可能省略	主队赔率。
└draw	string可能省略	和局赔率。
└away	string可能省略	客队赔率。
└kellyHome	string可能省略	主胜的凯利指数，用于比较市场报价；并非投注金额或胜出机率。
└kellyDraw	string可能省略	和局的凯利指数。
└kellyAway	string可能省略	客胜的凯利指数。
└payout	string可能省略	此组报价的公司返还率。
└recordedUtc	datetime可能省略	记录此报价的时间。
closing	KellyQuoteDto[]	每间公司的最新报价。
└bookmaker	string可能省略	博彩公司名称。
└home	string可能省略	主队赔率。
└draw	string可能省略	和局赔率。
└away	string可能省略	客队赔率。
└kellyHome	string可能省略	主胜的凯利指数，用于比较市场报价；并非投注金额或胜出机率。
└kellyDraw	string可能省略	和局的凯利指数。
└kellyAway	string可能省略	客胜的凯利指数。
└payout	string可能省略	此组报价的公司返还率。
└recordedUtc	datetime可能省略	记录此报价的时间。

返回状态 200, 401, 403, 404, 429

前往试用

香港赛马会赔率

GET/v1/football/matches/{matchId}/odds/hkjc

参数

matchIdinteger (int32)path必填
从实时比分或赛程列表获取的 Tipsme 数字比赛 ID，适用于比赛详情、赔率及分析；分析需要 Plus 或 Pro。在 API 参考查找此值

马会盘口范围

提供 18 组全场及半场盘口的赔率记录，包括球队进球大小、球队角球大小、半场球队进球大小、半场球队角球大小、正确比分及半场正确比分。

查看盘口示例（不扣 API 配额）

球队盘口与正确比分字段

盘口	字段	彩池代码
球队进球大小	teamOverUnder	HLH / HLA
球队角球大小	teamCornersOverUnder	CHH / CHA
半场球队进球大小	firstHalfTeamOverUnder	FLH / FLA
半场球队角球大小	firstHalfTeamCornersOverUnder	CFH / CFA
正确比分	correctScore	CRS
半场正确比分	firstHalfCorrectScore	FCS

球队盘口的 poolType 识别主客队：HLH、CHH、FLH、CFH 为主队；HLA、CHA、FLA、CFA 为客队。同一球队及时间可有多条大小盘口。

正确比分的 scoreOdds 保留原始投注选项代码、赔率、状态及嵌套数据；其中的 name_en、name_ch、line_status 等字段保留 snake_case 名称。选项可包括 HO、OAN 等特殊结果，不能一律当作数字比分；未提供或暂停的赔率不代表零。

各组记录由旧至新排列；以 recordedUtc 判断数据时间。马会没有提供的盘口返回空数组，整张赔率表尚未提供时可返回 404。

赔率表默认缓存 60 秒，HTTP 响应亦可私有缓存 60 秒。建议每分钟最多查询一次；缓存命中的 API 请求仍会扣除配额。recordedUtc 是赔率观察时间，并非请求时间。

请求示例

请先填写必填参数：matchId

响应字段 · 106

选填栏位可能不会出现。API 会省略值为 null 的栏位；使用前请先检查栏位是否存在。栏位名称在所有语言中均相同。

字段	类型	说明
matchId	integer	Tipsme 比赛识别码。
matchResult	HkjcMatchResultRowDto[]	全场主客和的不同选项。
└home	string可能省略	主队赔率。
└draw	string可能省略	和局赔率。
└away	string可能省略	客队赔率。
└recordedUtc	datetime可能省略	赔率表显示这些价格的时间。
handicap	HkjcHandicapRowDto[]	全场亚洲让球变化。
└homeLine	string可能省略	主队盘口，例如 -1。
└awayLine	string可能省略	客队盘口，例如 +1。
└home	string可能省略	主队赔率。
└away	string可能省略	客队赔率。
└recordedUtc	datetime可能省略	赔率表显示这些价格的时间。
overUnder	HkjcOverUnderRowDto[]	全场总入球的不同选项。
└line	string可能省略	入球或角球的盘口。
└over	string可能省略	大球赔率。
└under	string可能省略	细球赔率。
└recordedUtc	datetime可能省略	赔率表显示这些价格的时间。
firstHalfMatchResult	HkjcMatchResultRowDto[]	上半场主客和的不同选项。
└home	string可能省略	主队赔率。
└draw	string可能省略	和局赔率。
└away	string可能省略	客队赔率。
└recordedUtc	datetime可能省略	赔率表显示这些价格的时间。
firstHalfOverUnder	HkjcOverUnderRowDto[]	上半场总入球的不同选项。
└line	string可能省略	入球或角球的盘口。
└over	string可能省略	大球赔率。
└under	string可能省略	细球赔率。
└recordedUtc	datetime可能省略	赔率表显示这些价格的时间。
cornersOverUnder	HkjcOverUnderRowDto[]	全场角球大小变化。
└line	string可能省略	入球或角球的盘口。
└over	string可能省略	大球赔率。
└under	string可能省略	细球赔率。
└recordedUtc	datetime可能省略	赔率表显示这些价格的时间。
handicapMatchResult	HkjcHandicapMatchResultRowDto[]可能省略	全场让球主客和变化。
└homeLine	string可能省略	马会主队让球盘口。
└awayLine	string可能省略	马会客队让球盘口。
└home	string可能省略	主队赔率。
└draw	string可能省略	和局赔率。
└away	string可能省略	客队赔率。
└recordedUtc	datetime可能省略	赔率表显示这些价格的时间。
oddEven	HkjcOddEvenRowDto[]可能省略	全场进球单双变化。
└odd	string可能省略	总进球单数赔率。
└even	string可能省略	总进球双数赔率。
└recordedUtc	datetime可能省略	赔率表显示这些价格的时间。
firstHalfHandicap	HkjcHandicapRowDto[]可能省略	半场亚洲让球变化。
└homeLine	string可能省略	主队盘口，例如 -1。
└awayLine	string可能省略	客队盘口，例如 +1。
└home	string可能省略	主队赔率。
└away	string可能省略	客队赔率。
└recordedUtc	datetime可能省略	赔率表显示这些价格的时间。
firstHalfCornersOverUnder	HkjcOverUnderRowDto[]可能省略	半场角球大小变化。
└line	string可能省略	入球或角球的盘口。
└over	string可能省略	大球赔率。
└under	string可能省略	细球赔率。
└recordedUtc	datetime可能省略	赔率表显示这些价格的时间。
cornersHandicap	HkjcHandicapRowDto[]可能省略	全场角球让球变化。
└homeLine	string可能省略	主队盘口，例如 -1。
└awayLine	string可能省略	客队盘口，例如 +1。
└home	string可能省略	主队赔率。
└away	string可能省略	客队赔率。
└recordedUtc	datetime可能省略	赔率表显示这些价格的时间。
firstHalfCornersHandicap	HkjcHandicapRowDto[]可能省略	半场角球让球变化。
└homeLine	string可能省略	主队盘口，例如 -1。
└awayLine	string可能省略	客队盘口，例如 +1。
└home	string可能省略	主队赔率。
└away	string可能省略	客队赔率。
└recordedUtc	datetime可能省略	赔率表显示这些价格的时间。
teamOverUnder	HkjcTeamOverUnderRowDto[]可能省略	全场球队进球大小：HLH 为主队，HLA 为客队。
└poolType	string	原始马会彩池：HLH/HLA（进球）、FLH/FLA（半场进球）、CHH/CHA（角球）、CFH/CFA（半场角球）。
└teamSide	string	HLH、FLH、CHH、CFH 对应 home（主队）；HLA、FLA、CHA、CFA 对应 away（客队）。
└line	string可能省略	球队大小盘口，已移除外围括号。
└over	string可能省略	大盘赔率；字符串保留来源报价精度。
└under	string可能省略	小盘赔率；字符串保留来源报价精度。
└recordedUtc	datetime可能省略	观察到此球队赔率的 UTC 时间。
firstHalfTeamOverUnder	HkjcTeamOverUnderRowDto[]可能省略	半场球队进球大小：FLH 为主队，FLA 为客队。
└poolType	string	原始马会彩池：HLH/HLA（进球）、FLH/FLA（半场进球）、CHH/CHA（角球）、CFH/CFA（半场角球）。
└teamSide	string	HLH、FLH、CHH、CFH 对应 home（主队）；HLA、FLA、CHA、CFA 对应 away（客队）。
└line	string可能省略	球队大小盘口，已移除外围括号。
└over	string可能省略	大盘赔率；字符串保留来源报价精度。
└under	string可能省略	小盘赔率；字符串保留来源报价精度。
└recordedUtc	datetime可能省略	观察到此球队赔率的 UTC 时间。
teamCornersOverUnder	HkjcTeamOverUnderRowDto[]可能省略	全场球队角球大小：CHH 为主队，CHA 为客队。
└poolType	string	原始马会彩池：HLH/HLA（进球）、FLH/FLA（半场进球）、CHH/CHA（角球）、CFH/CFA（半场角球）。
└teamSide	string	HLH、FLH、CHH、CFH 对应 home（主队）；HLA、FLA、CHA、CFA 对应 away（客队）。
└line	string可能省略	球队大小盘口，已移除外围括号。
└over	string可能省略	大盘赔率；字符串保留来源报价精度。
└under	string可能省略	小盘赔率；字符串保留来源报价精度。
└recordedUtc	datetime可能省略	观察到此球队赔率的 UTC 时间。
firstHalfTeamCornersOverUnder	HkjcTeamOverUnderRowDto[]可能省略	半场球队角球大小：CFH 为主队，CFA 为客队。
└poolType	string	原始马会彩池：HLH/HLA（进球）、FLH/FLA（半场进球）、CHH/CHA（角球）、CFH/CFA（半场角球）。
└teamSide	string	HLH、FLH、CHH、CFH 对应 home（主队）；HLA、FLA、CHA、CFA 对应 away（客队）。
└line	string可能省略	球队大小盘口，已移除外围括号。
└over	string可能省略	大盘赔率；字符串保留来源报价精度。
└under	string可能省略	小盘赔率；字符串保留来源报价精度。
└recordedUtc	datetime可能省略	观察到此球队赔率的 UTC 时间。
correctScore	HkjcCorrectScoreRowDto[]可能省略	全场正确比分（CRS）快照，包括特殊结果及选项数据。
└poolType	string	原始马会彩池：CRS（全场）或 FCS（半场）。
└poolId	string可能省略	马会彩池标识符，若来源有提供。
└poolStatus	string可能省略	原始彩池开放状态，若来源有提供。
└scoreOdds	array	按来源排序的原始马会投注选项对象。保留数字及命名结果（例如 HO/AO/DO）、null 或未提供的赔率、status、line_status、combination_id、name_en、name_ch 及嵌套 selections。原始对象内的字段保留 snake_case 名称，亦保留未知数据。
└recordedUtc	datetime可能省略	观察到完整彩池快照的 UTC 时间。
firstHalfCorrectScore	HkjcCorrectScoreRowDto[]可能省略	半场正确比分（FCS）快照，包括特殊结果及选项数据。
└poolType	string	原始马会彩池：CRS（全场）或 FCS（半场）。
└poolId	string可能省略	马会彩池标识符，若来源有提供。
└poolStatus	string可能省略	原始彩池开放状态，若来源有提供。
└scoreOdds	array	按来源排序的原始马会投注选项对象。保留数字及命名结果（例如 HO/AO/DO）、null 或未提供的赔率、status、line_status、combination_id、name_en、name_ch 及嵌套 selections。原始对象内的字段保留 snake_case 名称，亦保留未知数据。
└recordedUtc	datetime可能省略	观察到完整彩池快照的 UTC 时间。

返回状态 200, 401, 403, 404, 429, 503

前往试用

赔率变动记录

GET/v1/football/matches/{matchId}/odds/{market}/{bookmaker}

参数

matchIdinteger (int32)path必填
从实时比分或赛程列表获取的 Tipsme 数字比赛 ID，适用于比赛详情、赔率及分析；分析需要 Plus 或 Pro。在 API 参考查找此值
marketstringpath必填
赔率市场：had = 主胜／平／客胜（1X2）；hdp = 亚洲让球；hilo = 总进球大小。
bookmakerstringpath必填
使用 /odds/bookmakers 的数字 ID，或赔率响应中的完整庄家名称。特殊字符会自动编码。在 API 参考查找此值

请求示例

请先填写必填参数：matchId

响应字段 · 19

选填栏位可能不会出现。API 会省略值为 null 的栏位；使用前请先检查栏位是否存在。栏位名称在所有语言中均相同。

字段	类型	说明
matchId	integer	Tipsme 比赛识别码。
market	integer	had（主客和）、hdp（让球）或 hilo（大细）。
bookmaker	string	此走势所属的博彩公司。
opening	OddsPointDto可能省略	首次记录的价格。
└recordedUtc	datetime可能省略	记录此价格的时间。
└line	string可能省略	让球或总数盘口（只适用于 hdp／hilo）。
└home	string可能省略	主队赔率（had／hdp）。
└draw	string可能省略	和局赔率（只适用于 had）。
└away	string可能省略	客队赔率（had／hdp）。
└over	string可能省略	大球赔率（只适用于 hilo）。
└under	string可能省略	细球赔率（只适用于 hilo）。
history	OddsPointDto[]	开盘后的每次记录，按时间排列。
└recordedUtc	datetime可能省略	记录此价格的时间。
└line	string可能省略	让球或总数盘口（只适用于 hdp／hilo）。
└home	string可能省略	主队赔率（had／hdp）。
└draw	string可能省略	和局赔率（只适用于 had）。
└away	string可能省略	客队赔率（had／hdp）。
└over	string可能省略	大球赔率（只适用于 hilo）。
└under	string可能省略	细球赔率（只适用于 hilo）。

返回状态 200, 400, 401, 403, 404, 429

前往试用

交易所赔率

GET/v1/football/matches/{matchId}/odds/exchange

参数

matchIdinteger (int32)path必填
从实时比分或赛程列表获取的 Tipsme 数字比赛 ID，适用于比赛详情、赔率及分析；分析需要 Plus 或 Pro。在 API 参考查找此值

请求示例

请先填写必填参数：matchId

这个端点按原样返回上游文档。它的结构随赛事赛制而变，没有固定的数据结构可供示例——映射之前请先查看一次真实响应。

返回状态 401, 403, 404, 429, 502

前往试用

庄家 ID

GET/v1/football/odds/bookmakers

请求示例

curl -H "Authorization: Bearer $TIPSME_API_KEY" \
  "https://api.tipsme.hk/v1/football/odds/bookmakers"

data 中每个项目包含 · 4

选填栏位可能不会出现。API 会省略值为 null 的栏位；使用前请先检查栏位是否存在。栏位名称在所有语言中均相同。

字段	类型	说明
id	integer	固定的数字识别码，可在 API 请求中使用。
name	string	来源提供的公司名称，可能含中文字或星号。请使用公司列表中的数字识别码查询赔率走势。
nameEn	string	英文显示名称。
isAggregate	boolean	true 表示最低／最高值的汇总列，并非真正的博彩公司。

返回状态 200, 401, 403, 429

前往试用

由免费方案开始

一个 API 密钥，每个账户每日 30 次请求，另加每日 50 次免费赛程列表请求。真实数据，无需信用卡。

获取免费 API 密钥价格

这页有帮助吗？

不太有

联系支持 →