直接给出结果的投注结算API
您手上有一批投注，想知道哪些赢了。提交赛事、盘口、盘口线和投注方向，即可获得赢、输、作废、赢一半或输一半的结果，覆盖21种体育项目的172个盘口，全部依据最终比分判定。
- 盘口
- 172
- 体育项目
- 21
- 每次请求的投注数
- 50
- 端点
- 2
一次请求结算三笔投注
这场比赛90分钟时比分为3-2，加时赛后为3-3。足球按90分钟结算，因此主队独赢获胜，basis 显示判定所用的比分。
curl -X POST "https://api.odds-api.io/v3/settlements/grade?apiKey=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"selections": [
{ "ref": "bet-1", "eventId": 74919888, "market": "ML", "side": "home" },
{ "ref": "bet-2", "eventId": 74919888, "market": "Spread", "hdp": -0.75, "side": "home" },
{ "ref": "bet-3", "eventId": 74919888, "market": "Totals", "hdp": 5.5, "side": "over" }
]
}'{
"grades": [
{ "ref": "bet-1", "eventId": 74919888, "result": "won", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } },
{ "ref": "bet-2", "eventId": 74919888, "result": "half_won", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } },
{ "ref": "bet-3", "eventId": 74919888, "result": "lost", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } }
]
}投注结算如何运作
两个端点。GET /v3/settlements 告诉您最多50场赛事的结果。POST /v3/settlements/grade 告诉您投注是否赢了。
- 1
保存投注
投注下单时，保存赛事ID、盘口、盘口线和投注方向。这正是您从 /v3/odds 获取的同样四个字段，无需任何映射。
- 2
提交判定
比赛结束后，向 /v3/settlements/grade POST最多50个选项。每个选项都会返回 won、lost、void、half_won 或 half_lost。大多数比分类盘口还会返回判定所依据的比分。
- 3
结果确定后再结算
每个结果都带有 final 标记。保留 final 为 false 的选项，稍后再次提交。最多每分钟提交一次就足够了。
七种可能的结果
只有当已存储的赛果能够证明结论时，我们才会判定投注。如果数据缺失或对不上，您会收到附带原因的 ungradeable，绝不靠猜测。
- won
- 投注赢
- lost
- 投注输
- half_won
- 四分之一盘：一半本金赢，另一半退回
- half_lost
- 四分之一盘：一半本金输，另一半退回
- void
- 本金退回。原因为 push 或 event_cancelled
- pending
- 尚未确定。原因说明我们在等待什么
- ungradeable
- 无法证明结论。原因说明具体缘由
清晰可读的结算规则
规则遵循博彩公司的通行做法。各家博彩公司在细节上有所不同，请与您自己的条款核对。
足球按90分钟结算
足球、五人制足球、手球和橄榄球盘口按常规时间结算。即使比赛比分包含加时赛和点球大战，也一律不计入。
博彩公司计入加时的项目包含加时
在篮球、美式橄榄球、棒球和冰球中，独赢、让分和大小盘包含加时赛和延长局。3-Way Result、Double Chance、Draw No Bet 以及 Regulation 大小盘和让分盘按常规时间结算。
四分之一盘拆分本金
亚洲让球-0.75即一半投注-0.5、一半投注-1。主队赢一球时，结果为 half_won。整数盘口恰好打平时为 void，原因为 push。
取消的比赛作废
已取消赛事上的所有投注都会以 void 返回，原因为 event_cancelled。如果比赛之后重新安排，该赛事会以相同ID回到 pending。
角球和罚牌依据比赛统计
足球的角球、罚牌和首个进球球队依据赛后统计判定，约在全场结束后30分钟。在此之前，结果为 pending，原因为 awaiting_stats。
球员数据盘依据技术统计
球员数据盘支持篮球、棒球、冰球和美式橄榄球。我们按姓名匹配球员，若该姓名可能对应两名球员则拒绝判定。
21种体育项目的172个盘口
盘口名称与 /v3/odds 返回的一致。结算指南按体育项目列出了全部盘口。
主要盘口
ML、3-Way Result、Spread 和亚洲让球、Totals、Team Totals、European Handicap、Double Chance、Draw No Bet、Both Teams To Score、Odd/Even
半场、节和局
主要盘口的上半场和下半场版本、Half Time / Full Time、篮球和美式橄榄球的每一节、冰球的每一局，以及棒球的 First 5 Innings 和 1st Inning 盘口
网球和电竞
网球、排球和乒乓球的局数让分、总局数和球员局数、盘数投注、盘数让分、每盘胜者、每盘大小和盘比分。电竞的 Map Handicap、Total Maps、地图胜者以及每张地图的回合和击杀盘口，斯诺克的局数盘口
足球统计
角球、罚牌、罚牌总数、射正、射门、门将扑救、越位、犯规和抢断、角球竞赛、首个和最后一个角球、首个、最后一个及第2至第5个进球球队、正确比分、净胜球、准确进球数和球队进球数、零封获胜、零封
球员数据盘
篮球、棒球、冰球和美式橄榄球中依据官方技术统计的大小盘
暂不支持判定
进球球员盘口、足球球员数据盘、飞镖盘口、板球和冠军盘。它们会以 unsupported_market 返回
投注被判定的比例
我们将自有投注追踪器在截至2026年10月12日的30天内结算的22,903笔投注通过此API进行判定。下表是返回判定结果的比例。
- 棒球，比分类盘口
- 99.6%
- 冰球，比分类盘口
- 99.2%
- 篮球，比分类盘口
- 99.1%
- 美式橄榄球，比分类盘口
- 98.5%
- 足球，比分类盘口
- 98.0%
- 足球罚牌
- 88.3%
- 足球角球
- 82.4%
请将这些数字作为参考。它们来自单一产品一个月的投注，主要是足球主要盘口，且赛事都已结算过一次。其余投注以附带原因的 ungradeable 返回。
投注结算API常见问题
如何通过API自动结算投注？
投注下单时保存赛事ID、盘口、盘口线和投注方向。比赛结束后，将它们提交到Odds-API.io v3 API的 POST /v3/settlements/grade。响应会为每笔投注给出 won、lost、void、half_won 或 half_lost，final 标记会告诉您结果何时已确认。
什么是投注结算API？
投注结算API接收您持有的投注，并告诉您结果如何。您提交赛事、盘口、盘口线和投注方向，它会根据最终比分返回结果。投注追踪工具、推荐平台、竞猜游戏和体育博彩后台都会使用它，从而不必为每个盘口和体育项目编写判定规则。
API可以判定哪些盘口和体育项目？
21种体育项目的172个盘口：独赢、让分和亚洲让球、大小盘、双方进球、双重机会、平局退款、半场盘口、网球局数和盘数、电竞地图、足球角球、罚牌和进球顺序，以及篮球、棒球、冰球和美式橄榄球的球员数据盘。
能结算四分之一盘的亚洲让球投注吗？
可以。以 Spread 提交，并将盘口线放在 hdp 中。让球始终以主队为准。-0.75等四分之一盘在一半本金退回时返回 half_won 或 half_lost，整数盘口恰好打平时返回 void，原因为 push。
足球投注按90分钟结算还是加时赛后结算？
按90分钟加补时结算。足球、五人制足球、手球和橄榄球投注按常规时间结算，即使比赛进入加时赛或点球大战也是如此。大多数比分类盘口的判定结果会附带所依据的比分，方便您展示给用户。Half Time / Full Time、角球、罚牌和球员数据盘只返回判定结果。
比赛延期或取消时会怎样？
大多数情况下，赛事状态会变为 cancelled，其上的所有投注都判定为 void，原因为 event_cancelled。如果比赛之后重新安排，该赛事会以相同ID回到 pending。始终没有赛果的比赛会在开球72小时后变为 ungradeable，原因为 result_unavailable。
比赛结束后多久可以结算投注？
比分类盘口通常在终场哨响几分钟后即可判定。角球、罚牌和球员数据盘约需30分钟。在此之前结果为 pending。当赛果与官方结果核对一致后，或比赛结束48小时后，final 标记会变为 true。
哪些套餐包含结算API？
两个结算端点在所有付费套餐中均可使用，每次调用计为一次请求。GET /v3/settlements 最多接受50个赛事ID，POST /v3/settlements/grade 最多接受50个选项。