Same Game Parlay API
Odds-API.io的同场串关(SGP) API,针对同一场赛前赛事中2到10个选项组成的投注单,返回每家博彩公司自己的投注构建器给出的价格。选项只需提交一次,您指定的每家博彩公司都会各自报价。
所有付费套餐均包含。支持NFL、NBA、MLB、NHL和足球的赛前赛事。
- 每张投注单的选项数
- 2-10
- 体育项目
- 5
- 端点
- 3
- MCP工具
- 3
同一张投注单,各家价格不同
2026年11月19日,我们在孟菲斯灰熊对金州勇士的比赛中为一张投注单报价:灰熊获胜且总分大于226.5分。同样的两个选项,Hard Rock给出2.35,Fanatics给出2.50。
| 博彩公司 | SGP价格 | 选项连乘 | 调整 |
|---|---|---|---|
| DraftKings | 2.44 | 2.54 | -3.9% |
| BetMGM | 2.45 | 2.47 | -0.9% |
| Fanatics | 2.50 | 2.53 | -1.0% |
| Hard Rock | 2.35 | 2.54 | -7.7% |
价格为小数赔率。同场串关按一笔投注整体定价,因此价格通常低于各选项赔率相乘的结果,差距由每家博彩公司自行决定。priceAdjustmentPct 就是这个差距,即博彩公司计入的相关性。
SGP API如何运作:先取选项,再报价
三个端点。先列出一场赛事的选项,再让您想询价的每家博彩公司为选中的选项报价。
- 1
找到提供报价的博彩公司
GET /v3/sgp/bookmakers 按体育项目返回提供同场串关报价的博彩公司,以及各自的最大选项数和当前是否在报价。
- 2
列出选项
GET /v3/sgp/legs 返回一场赛前赛事中所有可加入串关的选项,每个都带有 legId,并按博彩公司标明能否组合及其单关价格。
- 3
为投注单报价
向 /v3/sgp/quote POST 2到10个 legIds。每家博彩公司各自返回串关价格、选项连乘值、priceAdjustmentPct 和投注单链接,或返回一个说明下一步该做什么的状态。
curl "https://api.odds-api.io/v3/sgp/legs?apiKey=YOUR_API_KEY\
&eventId=61234567&bookmakers=DraftKings,BetMGM&markets=ML,Totals"curl -X POST "https://api.odds-api.io/v3/sgp/quote?apiKey=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"eventId": 61234567,
"bookmakers": "DraftKings,BetMGM",
"legs": [
{ "legId": "61234567|ML|||home" },
{ "legId": "61234567|Totals|221.5||over" }
]
}'{
"eventId": 61234567,
"quotes": [
{
"bookmaker": "DraftKings",
"status": "ok",
"price": "3.38",
"legsMultiplied": "3.50",
"priceAdjustmentPct": "-3.3",
"legs": [
{ "legId": "61234567|ML|||home", "price": "1.83" },
{ "legId": "61234567|Totals|221.5||over", "price": "1.91", "hdp": 221.5 }
],
"links": { "desktop": "https://sportsbook.draftkings.com/...", "mobile": "https://sportsbook.draftkings.com/..." },
"jurisdiction": "US-WV",
"quotedAt": "2026-11-12T18:04:11.230Z",
"cached": false
},
{
"bookmaker": "BetMGM",
"status": "not_combinable",
"retryable": false,
"nextAction": "change_legs",
"reason": "The bookmaker does not allow these legs together."
}
]
}首批博彩公司
以下博彩公司在上线时即提供同场串关报价,更多博彩公司正在接入。GET /v3/sgp/bookmakers 始终返回最新列表,包含每家的体育项目、最大选项数和状态。
DraftKings
美式橄榄球, 篮球, 棒球, 冰球
定价地区
US-WVBetMGM
美式橄榄球, 篮球, 棒球, 冰球, 足球
定价地区
US-NJFanatics
美式橄榄球, 篮球, 棒球, 冰球, 足球
定价地区
US-NJHard Rock
美式橄榄球, 篮球, 棒球, 冰球, 足球
定价地区
US-FLBetRivers
美式橄榄球, 篮球, 棒球, 冰球, 足球
定价地区
US-MIBetParx
美式橄榄球, 篮球, 棒球, 冰球, 足球
定价地区
US-NJBally Bet
美式橄榄球, 篮球, 棒球, 冰球, 足球
定价地区
US-NJBwin
美式橄榄球, 篮球, 棒球, 冰球, 足球
定价地区
AT
同一家博彩公司在不同州对投注单的定价可能略有不同,因此每个报价都带有其适用的 jurisdiction。Bwin 按奥地利定价。
报价返回的内容
每家博彩公司一条,按请求顺序排列。一家博彩公司失败不会导致整个请求失败。
- price
- 博彩公司的串关价格,小数字符串
- legsMultiplied
- 各选项当前单关价格相乘的结果
- priceAdjustmentPct
- 价格与选项连乘值相差多少,以百分比表示。-3.9表示串关赔付少3.9%
- legs
- 每个选项及该博彩公司当前的单关价格,若与您提交的 expectedPrice 不同则标记 priceMoved
- links
- 打开博彩公司并带入投注单的桌面端和移动端链接
- jurisdiction
- 价格适用的地区,例如 US-NJ 或 US-FL
- quotedAt
- 博彩公司为投注单定价的时间
为AI智能体设计的状态
每个非 ok 的报价都带有固定的 nextAction,代码和AI智能体无需阅读文字即可据此分支处理。reason 则供人阅读。
- change_legs
- 该博彩公司不允许这些选项组合。请替换其中一个
- remove_leg
- 移除 legIds 中的选项,或将投注单缩减到该博彩公司的 maxLegs 以内
- refresh_legs
- 盘口线可能已变动。请重新调用 /v3/sgp/legs
- retry
- 博彩公司未及时响应。请重试
- retry_later
- 等待 retryAfter 秒后重试
- choose_other_bookmaker
- 该博彩公司不为此赛事或体育项目报价。请换一家
所有付费套餐均包含
无需附加组件
SGP报价与450+家博彩公司的赔率使用同一个API密钥,不额外收费。
您的博彩公司
与 /v3/odds 相同,您可以为套餐所选的博彩公司报价。同场串关不会增加博彩公司。
限制
每个账户同时最多进行2个报价,同一博彩公司的同一投注单会缓存10秒。
同场串关API常见问题
什么是同场串关API?
它是一个API,返回博彩公司对同一场比赛多个选项组成的串关所给出的价格。这些选项相互关联,因此博彩公司会对整张投注单自行定价,无法从单关价格推算出来。Odds-API.io通过 POST /v3/sgp/quote 按博彩公司返回该价格。
它和投注构建器API是一回事吗?
是的。欧洲博彩公司把同场串关称为投注构建器(bet builder),澳大利亚博彩公司称之为 same game multi。例如 Bwin 通过其投注构建器报价,API 会以与美国博彩公司相同的格式返回价格。
SGP API覆盖哪些博彩公司?
首批包括 DraftKings、BetMGM、Fanatics、Hard Rock、BetRivers、BetParx、Bally Bet 和 Bwin,更多博彩公司正在接入。GET /v3/sgp/bookmakers 返回最新列表,包含每家的体育项目、最大选项数和状态。
可以为哪些体育项目报价?
美式橄榄球、篮球、棒球和冰球在所有首批博彩公司均可报价,足球则除 DraftKings 外均可。部分博彩公司在某些项目上允许的选项数较少,/v3/sgp/bookmakers 中的 maxLegs 会说明具体数量。
价格是真实的还是模型估算的?
是真实价格。每个价格都是博彩公司自己的投注构建器在 quotedAt 时间为该投注单返回的价格。我们从不根据单关价格估算串关价格。
可以为滚球比赛报价吗?
暂不支持。同场串关报价仅限赛前,滚球中或已结束的赛事会返回400。
SGP API包含在我的套餐中吗?
是的。所有付费套餐均包含,不额外收费。与 /v3/odds 相同,您报价的每家博彩公司都必须在套餐所选的博彩公司中。