What is a same game parlay quote?
A same game parlay (SGP), called a bet builder at European bookmakers such as Bwin, combines two or more bets from the same event into one bet, for example the home team to win and the total to go over 221.5. The legs depend on each other, so a bookmaker does not multiply the single prices. It prices the combination itself, and the result is usually lower than the product of the single prices. The SGP endpoints return that price. You choose the event, the bookmakers and the legs, and each bookmaker answers with its own parlay price or with a status that tells you what to do next. Prices come from each bookmaker’s own same game parlay pricing. Three endpoints:GET /v3/bookmakers also marks these bookmakers with "features": ["sgp"]. That list is fixed and does not change when quotes are paused. Check status on /v3/sgp/bookmakers for whether a bookmaker is quoting right now.
Same game parlay quotes are pre-match only. A live or finished event returns 400.
Supported bookmakers
More bookmakers are being added. The current list, with each bookmaker’s status, is always/v3/sgp/bookmakers. At the time of writing:
jurisdiction is the region the bookmaker prices for. Prices can differ between regions of the same bookmaker: Hard Rock quotes the Florida (US-FL) price, which can sit slightly apart from its prices in other states.
A quote can take up to 8 seconds, so give /v3/sgp/quote a client timeout of at least 10 seconds.
The two-step flow
- Call
/v3/sgp/legsfor an event. Pick legs and copy theirlegId. - Call
/v3/sgp/quotewith the event, the bookmakers and thelegIdvalues. Read one entry per bookmaker.
market, hdp, label and side as /v3/odds. Player props use label as Name (Stat), like in /v3/odds. A legId is the event id, market, line, label and side joined with |, for example 61234567|Totals|221.5||over. Copy it from /v3/sgp/legs and do not build it by hand.
Query Parameters
GET /v3/sgp/bookmakers
Each bookmaker has
name, sports, maxLegs, jurisdiction and status. jurisdiction is the region the parlay price applies to. status is live, paused (quotes are switched off for now) or degraded (the status cannot be checked right now).
GET /v3/sgp/legs
Each leg has
legId, market, hdp (when the market has a line), label (when it has one), side and bookmakers. For each requested bookmaker, bookmakers holds:
The response also has
bookmakers, one entry per requested bookmaker in request order, and hasMore. When hasMore is true, call again with a higher skip.
Each bookmakers entry has bookmaker and status. When status is not ok, it also has retryable, nextAction and reason:
POST /v3/sgp/quote
Send a JSON body of at most 64 KB.apiKey is a query parameter.
Each leg is either
{ "legId": "..." } or { "market", "hdp", "label", "side" } exactly as served on /v3/odds. Do not send both forms in one leg. hdp has at most 4 decimals, like the lines on /v3/sgp/legs. side is one of home, away, draw, over, under, yes, no. A leg may also carry expectedPrice, the single price you saw, as a decimal string such as "1.91". The leg is flagged priceMoved when the current price differs.
A parlay cannot repeat a leg or hold two sides of the same line, for example over and under 221.5. Both return 400. A leg must be one /v3/sgp/legs lists for you at one of the requested bookmakers; any other leg returns 400. When the event offers the same market and side on another line, the message names the nearest offered legId.
Quoting a Parlay
Response Format
POST /v3/sgp/quote returns one entry in quotes for every requested bookmaker, in request order:
price, legsMultiplied, priceAdjustmentPct and links are only present when the status is ok. An ok quote carries reason and legIds only when the reason is redundant_leg. A quote with another status carries retryable, nextAction and reason instead, and some also carry legIds or retryAfter. Apart from redundant_leg, reason is a readable sentence for display, for example “The bookmaker does not allow these legs together.” Its wording can change, so branch on status and nextAction, not on reason.
Identical quotes (same bookmaker, event and legs, in any order) are cached for 10 seconds.
A betslip link opens the bookmaker’s betslip with the legs. The bookmaker prices the slip again when the bet is placed, so the price on the slip can differ from the quote.
Statuses and Next Actions
One bookmaker failing does not fail the request. Each bookmaker is answered on its own, so read
status for every entry.
Units and Limits
- Odds are decimal strings, like
/v3/odds. Quote prices have two decimals. - 2 to 10 legs per parlay. A bookmaker may allow fewer: see
maxLegsin/v3/sgp/bookmakers. A bookmaker may also accept fewer legs on some sports: BetMGM takes football (soccer) parlays of 2 legs, and a longer slip returnsnot_combinable. - 1 event and up to 8 bookmakers per request.
- Pre-match events only.
- Up to 2 quotes in progress per account at the same time. A third returns
429with aRetry-Afterheader. A quote counts until the bookmaker has answered, even when your client stopped waiting. - A request body is at most 64 KB.
Plan Access
Same game parlay quotes are included in every paid plan at no extra cost. On a free key, all three endpoints return403:
/v3/odds: same game parlays do not add bookmakers to your plan, so quote the bookmakers in your selection.
Errors are always { "error": "..." }:
FAQ
Is the SGP API included in my plan?
Is the SGP API included in my plan?
Yes. Same game parlay quotes are included in every paid plan at no extra cost. You can quote the bookmakers in your plan’s selection, the same as on
/v3/odds.Can I quote live games?
Can I quote live games?
No. Same game parlay quotes are pre-match only. A live or finished event returns
400.Why is the parlay price lower than the legs multiplied?
Why is the parlay price lower than the legs multiplied?
The legs of a same game parlay depend on each other, so the bookmaker prices the slip as one bet.
priceAdjustmentPct is how far the parlay price sits from the legs multiplied, the correlation the bookmaker has priced in. Each bookmaker sets it differently, so the same slip can pay a different price at each one.What does nextAction mean?
What does nextAction mean?
Every quote that is not
ok carries a fixed nextAction: change_legs, remove_leg, refresh_legs, retry, retry_later or choose_other_bookmaker. Code and AI agents can branch on it without reading the reason text.Is a bet builder the same as a same game parlay?
Is a bet builder the same as a same game parlay?
Yes. European bookmakers call it a bet builder, Australian bookmakers a same game multi. The endpoints work the same way for all of them.
Next Steps
How Sportsbooks Price Same Game Parlays
Real quotes for one slip across bookmakers, and how correlation pricing differs
Same Game Parlay API
Overview of the SGP API, launch bookmakers and AI agent support
Fetching Odds
Markets, hdp, label and side as served on /v3/odds
Bet Settlement
Grade the legs of a parlay from final results