{"id":3139,"date":"2026-07-24T10:00:00","date_gmt":"2026-07-24T10:00:00","guid":{"rendered":"https:\/\/oddspapi.io\/blog\/?p=3139"},"modified":"2026-07-17T18:16:26","modified_gmt":"2026-07-17T18:16:26","slug":"asian-handicap-calculator-python","status":"publish","type":"post","link":"https:\/\/oddspapi.io\/blog\/asian-handicap-calculator-python\/","title":{"rendered":"Asian Handicap Calculator in Python: Settle Quarter Lines & Fair Odds"},"content":{"rendered":"

You back the home team at a -0.75 Asian handicap<\/strong>. They win 1-0. Did you win your bet, or half of it? Most bettors guess, and most consumer calculators either skip quarter lines or settle them wrong. This guide fixes that. You will build an Asian handicap calculator in Python that settles every line type correctly, strips the bookmaker margin to reveal the fair price, and shops each line across 350+ books using the free OddsPapi odds API<\/a>.<\/p>\n

Every number below comes from one live Pinnacle ladder pulled from the API: FCSB vs ACS Champions Arge\u0219<\/strong> in the Romanian Superliga. No invented odds.<\/p>\n

Why Asian handicaps trip up calculators<\/h2>\n

A standard handicap moves the goal margin by a whole or half a goal. Asian handicaps add quarter lines<\/strong> (-0.25, -0.75, +1.25) that split your stake across the two neighbouring lines. A -0.75 bet is really two half-stakes: one at -0.5 and one at -1.0. Win by one goal and the -0.5 half wins while the -1.0 half pushes, so you collect half your winnings and half your stake back. That single rule is what generic tools get wrong.<\/p>\n

The other half of the problem is the price. Bookmakers bake a margin into both sides of the handicap. Back a line blind and you cannot tell whether 1.86 is generous or a rip-off. De-vig the two prices and you get the sharp market’s true probability, which is the only benchmark worth measuring your bet against. Both problems are solved with about forty lines of Python.<\/p>\n

The Asian handicap lines, decoded<\/h2>\n

Read every line from the home team’s side. margin<\/code> is home goals minus away goals at full time. This is the settlement matrix your calculator has to reproduce:<\/p>\n

\n\n\n\n\n\n\n\n\n\n\n\n
Line<\/th>\nFull win<\/th>\nHalf win<\/th>\nPush (stake back)<\/th>\nHalf loss<\/th>\nFull loss<\/th>\n<\/tr>\n<\/thead>\n
-1.0<\/td>\nmargin \u2265 2<\/td>\n\u2014<\/td>\nmargin = 1<\/td>\n\u2014<\/td>\nmargin \u2264 0<\/td>\n<\/tr>\n
-0.75<\/td>\nmargin \u2265 2<\/td>\nmargin = 1<\/td>\n\u2014<\/td>\n\u2014<\/td>\nmargin \u2264 0<\/td>\n<\/tr>\n
-0.5<\/td>\nmargin \u2265 1<\/td>\n\u2014<\/td>\n\u2014<\/td>\n\u2014<\/td>\nmargin \u2264 0<\/td>\n<\/tr>\n
-0.25<\/td>\nmargin \u2265 1<\/td>\n\u2014<\/td>\n\u2014<\/td>\nmargin = 0<\/td>\nmargin \u2264 -1<\/td>\n<\/tr>\n
0 (Draw No Bet)<\/td>\nmargin \u2265 1<\/td>\n\u2014<\/td>\nmargin = 0<\/td>\n\u2014<\/td>\nmargin \u2264 -1<\/td>\n<\/tr>\n
+0.25<\/td>\nmargin \u2265 1<\/td>\nmargin = 0<\/td>\n\u2014<\/td>\n\u2014<\/td>\nmargin \u2264 -1<\/td>\n<\/tr>\n
+0.5<\/td>\nmargin \u2265 0<\/td>\n\u2014<\/td>\n\u2014<\/td>\n\u2014<\/td>\nmargin \u2264 -1<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n

The two quarter lines carry the tricky cases: -0.75 pays a half win when the favourite squeaks home by one, and -0.25 costs you a half loss when the match ends level. Encode the matrix once and you never eyeball a settlement again.<\/p>\n

The old way vs OddsPapi<\/h2>\n
\n\n\n\n\n\n\n\n\n
The old way<\/th>\nWith OddsPapi<\/th>\n<\/tr>\n<\/thead>\n
Paste odds into a web calculator that ignores quarter lines<\/td>\nOne \/odds<\/code> call returns the full -1.0 to +0.5 ladder as JSON<\/td>\n<\/tr>\n
Guess whether the price is fair<\/td>\nDe-vig the two sides to the sharp market’s true probability<\/td>\n<\/tr>\n
Check one bookmaker’s handicap<\/td>\nCompare the same line across 350+ books including Pinnacle, SBOBet and Betfair<\/td>\n<\/tr>\n
Screenshot lines to backtest by hand<\/td>\nPull free historical AH snapshots and settle them in a loop<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n

Build the calculator<\/h2>\n

Step 1: Authenticate and pull the AH ladder<\/h3>\n

The API key goes in as a query parameter, never a header. Point \/odds<\/code> at a fixture ID and read the bookmakerOdds<\/code> block. Asian handicap sits in soccer market IDs 1064 through 1076, one market per line.<\/p>\n

import requests\n\nAPI_KEY = \"YOUR_API_KEY\"\nBASE_URL = \"https:\/\/api.oddspapi.io\/v4\"\nFIXTURE = \"id1000015272387856\"  # FCSB vs ACS Champions Arges, Superliga\n\nresp = requests.get(f\"{BASE_URL}\/odds\",\n                    params={\"apiKey\": API_KEY, \"fixtureId\": FIXTURE})\nbooks = resp.json()[\"bookmakerOdds\"]\nprint(sorted(books))\n# ['ballybet', 'bet365', 'betmgm', 'betparx', 'betrivers', 'borgata',\n#  'draftkings', 'fanduel', 'fourwinds', 'pinnacle', 'pointsbet.com.au',\n#  'sbobet']\n<\/code><\/pre>\n
Step 2: Parse the nested ladder<\/h3>\n
Do not hardcode market IDs. Query \/markets<\/code> once, keep every full-time Asian handicap market with its handicap<\/code> value, and use the outcome names (\"1\"<\/code> for home, \"2\"<\/code> for away) to resolve each side. That way the code survives when the catalog shifts.<\/p>\n
def ah_market_map(sport_id=10):\n    r = requests.get(f\"{BASE_URL}\/markets\",\n                     params={\"apiKey\": API_KEY, \"sportId\": sport_id})\n    out = {}\n    for m in r.json():\n        if m[\"marketName\"] == \"Asian Handicap\" and m[\"period\"] == \"fulltime\":\n            home = next(o[\"outcomeId\"] for o in m[\"outcomes\"] if o[\"outcomeName\"] == \"1\")\n            away = next(o[\"outcomeId\"] for o in m[\"outcomes\"] if o[\"outcomeName\"] == \"2\")\n            out[str(m[\"marketId\"])] = {\"line\": float(m[\"handicap\"]),\n                                       \"home\": str(home), \"away\": str(away)}\n    return out\n\n\ndef read_ladder(book_markets, ah_map):\n    \"\"\"Return {home_line: {'home': price, 'away': price}} for one book.\"\"\"\n    ladder = {}\n    for mid, meta in ah_map.items():\n        market = book_markets.get(mid)\n        if not market:\n            continue\n        outs = market[\"outcomes\"]\n        row = {}\n        for side in (\"home\", \"away\"):\n            od = outs.get(meta[side])\n            player = od and od[\"players\"].get(\"0\")\n            if isinstance(player, dict) and od.get(\"active\", True):\n                row[side] = player[\"price\"]\n        if len(row) == 2:\n            ladder[meta[\"line\"]] = row\n    return dict(sorted(ladder.items()))\n\n\nah_map = ah_market_map()\npinnacle = read_ladder(books[\"pinnacle\"][\"markets\"], ah_map)\nfor line, row in pinnacle.items():\n    print(f\"{line:+.2f}   home {row['home']:<6}  away {row['away']}\")\n<\/code><\/pre>\n
That prints Pinnacle's live ladder for the fixture:<\/p>\n
-1.00   home 2.2     away 1.709\n-0.75   home 1.862   away 2.01\n-0.50   home 1.657   away 2.29\n-0.25   home 1.454   away 2.83\n+0.00   home 1.25    away 4.08\n+0.25   home 1.203   away 4.71\n<\/code><\/pre>\n
Step 3: The settlement engine<\/h3>\n
This is the function generic calculators miss. Split any quarter line into its two half-stakes, apply the handicap to the final margin, and settle each half on its own. Whole and half lines run both halves on the same line.<\/p>\n
def settle_ah(handicap, stake, price, margin):\n    \"\"\"Net profit on a HOME Asian handicap bet.\n\n    handicap: home line, e.g. -0.75, -0.25, 0, +0.5\n    price   : decimal odds you took\n    margin  : final home_goals - away_goals\n    \"\"\"\n    # A quarter line (.25 or .75) splits across the two neighbouring lines.\n    if (handicap * 2) % 1:\n        legs = (handicap - 0.25, handicap + 0.25)\n    else:\n        legs = (handicap, handicap)\n\n    profit = 0.0\n    for line in legs:\n        adjusted = margin + line\n        if adjusted > 0:                 # this half covers\n            profit += (stake \/ 2) * (price - 1)\n        elif adjusted < 0:               # this half loses\n            profit -= stake \/ 2\n        # adjusted == 0 -> push, that half stake is refunded\n    return round(profit, 2)\n<\/code><\/pre>\n
Run it against the real Pinnacle prices with a \u00a3100 stake:<\/p>\n
# Home -0.25 @ 1.454 (the quarter-loss line)\nsettle_ah(-0.25, 100, 1.454, margin=1)   # FCSB win by 1  -> +45.40\nsettle_ah(-0.25, 100, 1.454, margin=0)   # draw           -> -50.00\nsettle_ah(-0.25, 100, 1.454, margin=-1)  # FCSB lose by 1 -> -100.00\n\n# Home -0.75 @ 1.862 (the quarter-win line)\nsettle_ah(-0.75, 100, 1.862, margin=2)   # win by 2 -> +86.20\nsettle_ah(-0.75, 100, 1.862, margin=1)   # win by 1 -> +43.10  (half win)\nsettle_ah(-0.75, 100, 1.862, margin=0)   # draw     -> -100.00\n\n# Home -1.0 @ 2.20 (whole line -> push on exactly 1)\nsettle_ah(-1.0, 100, 2.2, margin=2)      # win by 2      -> +120.00\nsettle_ah(-1.0, 100, 2.2, margin=1)      # win by 1      -> 0.00  (push)\nsettle_ah(-1.0, 100, 2.2, margin=0)      # draw          -> -100.00\n<\/code><\/pre>\n
The -0.75 line paying +43.10 on a one-goal win is the answer to the question at the top. Half your stake settled at -0.5 and won; the other half settled at -1.0 and pushed.<\/p>\n
Step 4: De-vig to the fair price<\/h3>\n
A two-way Asian handicap is a clean de-vig target. Take the reciprocal of each price, add them to get the overround, then rescale so the two probabilities sum to one. The result is the sharp book's honest read on the game.<\/p>\n
def devig_two_way(home_price, away_price):\n    ih, ia = 1 \/ home_price, 1 \/ away_price\n    overround = ih + ia\n    return {\n        \"vig_pct\": round((overround - 1) * 100, 2),\n        \"fair_home_prob\": round(ih \/ overround, 4),\n        \"fair_home_odds\": round(overround \/ ih, 3),\n        \"fair_away_odds\": round(overround \/ ia, 3),\n    }\n\nrow = pinnacle[-0.5]\nprint(devig_two_way(row[\"home\"], row[\"away\"]))\n# {'vig_pct': 4.02, 'fair_home_prob': 0.5802,\n#  'fair_home_odds': 1.724, 'fair_away_odds': 2.382}\n<\/code><\/pre>\n
Pinnacle's -0.5 line prices FCSB at 1.657 and Arge\u0219 at 2.29. That is a 4.02% margin. Strip it and the fair line is 1.724 \/ 2.382, with FCSB at 58.0% to win by one or more. Now you have a benchmark: any book offering better than 1.724 on FCSB -0.5 is beating the sharp fair price. For three ways to remove the margin, see the no-vig odds guide<\/a>, and to measure margins across a whole card use the vig calculator<\/a>.<\/p>\n
Step 5: Line-shop the handicap across 350+ books<\/h3>\n
The same handicap prices differently at every book, and the best price flips by side. Loop the ladder-reader over every book on the fixture and keep the top price for each side.<\/p>\n
def best_ah_price(books, ah_map, target_line):\n    best = {\"home\": (0, None), \"away\": (0, None)}\n    for slug, data in books.items():\n        ladder = read_ladder(data[\"markets\"], ah_map)\n        row = ladder.get(target_line)\n        if not row:\n            continue\n        for side in (\"home\", \"away\"):\n            if row[side] > best[side][0]:\n                best[side] = (row[side], slug)\n    return best\n\nprint(best_ah_price(books, ah_map, -0.5))\n# {'home': (1.657, 'pinnacle'), 'away': (2.35, 'sbobet')}\n<\/code><\/pre>\n
On the -0.5 line, the sharp book Pinnacle holds the best price to back FCSB at 1.657, while SBOBet pays the most on Arge\u0219 +0.5 at 2.35 against Pinnacle's 2.29 and DraftKings' 2.30. Taking each side at its best book instead of settling for one sportsbook is the difference between a fair bet and a leaking one. The same pattern runs across every market; the line-shopping tutorial<\/a> generalises it to moneylines and totals.<\/p>\n
One guardrail: always keep the active<\/code> check from Step 2. A book can leave a stale or suspended handicap in the feed at a wild price, and an unfiltered \"best price\" scan will happily point you at it.<\/p>\n
Where the Asian handicap data comes from<\/h2>\n
Asian handicaps are a first-class market in the feed, not a bolt-on. The sharp Asian books that set these lines are all covered: Pinnacle, SBOBet, and Singbet, whose quarter-ball pricing is the reference the soft books follow. For the raw AH odds across every book on a fixture, the cross-book Asian handicap API guide<\/a> covers the discovery side, and the Singbet guide<\/a> digs into Crown's Asian lines. Free historical odds let you replay any line and settle it with the same settle_ah<\/code> function to backtest a handicap model.<\/p>\n
FAQ<\/h2>\n
How does a -0.75 Asian handicap settle?<\/h3>\n
It splits into two half-stakes, one at -0.5 and one at -1.0. Win by two or more and both halves win. Win by exactly one and the -0.5 half wins while the -1.0 half pushes, so you collect a half win. Draw or lose and both halves lose.<\/p>\n
What is the difference between -0.25 and -0.5?<\/h3>\n
A -0.5 line has no push: the favourite wins the bet or loses it. A -0.25 line splits between 0 (Draw No Bet) and -0.5, so a draw costs you a half loss instead of the full stake. The quarter line is the safer, lower-paying version.<\/p>\n
Can I calculate the fair Asian handicap price myself?<\/h3>\n
Yes. A two-way AH market de-vigs cleanly: invert both decimal prices, sum them for the overround, and rescale to probabilities that add to one. On Pinnacle's -0.5 line for this fixture that turns 1.657 \/ 2.29 into a fair 1.724 \/ 2.382 after removing a 4.02% margin.<\/p>\n
Which bookmakers set the sharpest Asian handicap lines?<\/h3>\n
Pinnacle, SBOBet, and Singbet (Crown) are the reference Asian books. They run low margins and high limits, so their de-vigged handicap is the closest thing to a true price. OddsPapi carries all three plus 350+ other books on one endpoint.<\/p>\n
Is the OddsPapi API free for Asian handicap odds?<\/h3>\n
Yes. The free tier returns live Asian handicap ladders and free historical snapshots. You authenticate with a key passed as a query parameter and read the AH markets straight out of the JSON.<\/p>\n
Stop guessing at quarter lines<\/h2>\n
You now have a settlement engine that handles every AH line, a de-vig function that exposes the fair price, and a scanner that finds the best handicap across 350+ books. Point them at any fixture and the guesswork is gone. Grab a free OddsPapi API key<\/a> and pull your first Asian handicap ladder in the next five minutes.<\/p>\n