- 盘口
- 137
- 赛前
- 136
- 滚球
- 108
- 时段
- 3
请求足球盘口
请完全按照列表使用名称。此请求会为一场赛事返回三个足球盘口。
GET https://api.odds-api.io/v3/odds?apiKey=YOUR_API_KEY&eventId=EVENT_ID&bookmakers=Bet365&markets=ML,Spread,Totals全部 137 个足球盘口
按时段分组。每一行都有自己的锚点，可以直接链接到单个盘口。
全场及其他 100
上半场 23
下半场 14
赔率数据的格式
每个盘口都有一种格式，说明如何读取它的赔率行。以下是赔率接口返回的示例行。
moneyline
一行包含每一方的赔率：home 和 away，三项盘口另有 draw。
足球: ML, Draw No Bet, ML HT, Draw No Bet 2H
JSON响应中的盘口[ { "name": "ML", "odds": [ { "home": "2.10", "draw": "3.40", "away": "3.20" } ] }, { "name": "ML 1st Set", "odds": [ { "home": "1.62", "away": "2.25" } ] } ]line
每条盘口线一行。hdp 是让分值或总数，让分盘为 home/away 赔率，大小盘为 over/under 赔率。
足球: Spread, Totals, Goals Over/Under, Spread HT
JSON响应中的盘口[ { "name": "Spread", "odds": [ { "hdp": -0.5, "home": "1.95", "away": "1.85" }, { "hdp": -1.5, "home": "3.10", "away": "1.36" } ] }, { "name": "Totals", "odds": [ { "hdp": 2.5, "over": "1.90", "under": "1.90" } ] } ]outcomes
一行中的固定命名结果：Double Chance 的 1X、12 和 X2，odd 和 even，或 home、away 以及双方都不得分时的 none。
足球: Double Chance, First Team To Score, Odd/Even, Corners Race
JSON响应中的盘口[ { "name": "Double Chance", "odds": [ { "1X": "1.28", "12": "1.30", "X2": "1.70" } ] }, { "name": "First Team To Score", "odds": [ { "home": "3.20", "away": "2.63", "none": "2.49" } ] } ]yesno
一行包含 yes 和 no 两个赔率。
足球: Both Teams To Score, Away Win to Nil, Both Teams To Score 2H, Both Teams To Score HT
JSON响应中的盘口[ { "name": "Both Teams To Score", "odds": [ { "yes": "1.80", "no": "2.00" } ] } ]labelled
每个选项一行。label 表示选项，例如准确比分或球员，odds 为赔率。Player Props 的行另有一条带 over 和 under 的盘口线。
足球: Half Time / Full Time, Anytime Goalscorer, First Goalscorer, Last Goalscorer
JSON响应中的盘口[ { "name": "Correct Score", "odds": [ { "label": "1-0", "odds": "7.50" }, { "label": "2-1", "odds": "9.00" } ] }, { "name": "Player Props", "odds": [ { "label": "Arike Ogunbowale (Assists)", "hdp": 5.5, "over": "1.87", "under": "1.95" } ] } ]
名称说明
- 所有博彩公司使用相同名称，markets 参数匹配时不区分大小写。没有 Match Winner（请用 ML），也没有单独的 Over/Under 或 Asian Handicap。
- Corners、Alternative Corners 和 1st Half Corners 是整数盘口线上的三项大小盘。某一行可能包含 exactly：当数量正好等于盘口线时，over 和 under 都输。
- 赛前为“无”的盘口只在赛事开始后提供。
足球盘口常见问题
API 有多少个足球盘口？
目前有 137 个，其中 136 个提供赛前赔率，108 个提供滚球赔率。列表随博彩公司提供的盘口变化，GET /v3/markets?sport=football 无需 API 密钥即可返回当前列表。
如何只获取部分足球盘口？
在 /v3/odds、/v3/odds/multi 或 WebSocket 中加入 markets，用逗号分隔名称，例如 markets=ML,Spread,Totals。不区分大小写，但需要完整名称。
ML 是什么意思？
ML 即独赢盘，也就是比赛的胜者。比赛结果请使用 ML，没有名为 Match Winner 的盘口。
数据与引用
同一列表的 JSON 版本，无需 API 密钥：https://api.odds-api.io/v3/markets?sport=football
最后更新：2026年11月12日
本页链接：https://odds-api.io/zh/markets/football