Pinnacle margin (overround) per market

Answer: every market in /v1/odds, /v1/events/{id} and the WebSocket carries margin. It is the overround: the sum of 1/decimal over the market's outcomes, minus 1. A margin of 0.025 means the prices add up to 102.5% implied probability. The same calculation gives each outcome's no-vig fair price and fairProb (proportional method). Available on every plan.

Check it yourself#

def margin(decimals):
    return sum(1 / d for d in decimals) - 1

# moneyline outcomes from one market
prices = [2.10, 3.45, 3.60]
print(round(margin(prices), 5))   # compare with market["margin"]

PinnFeed rounds margin to 5 decimals and fairProb to 5 decimals, fair to 4.

Rank markets by margin#

import os, requests
r = requests.get("https://pinnfeed.io/v1/odds",
    params={"sport": "soccer", "market": "moneyline", "main": "true", "limit": 200},
    headers={"x-api-key": os.environ["PINNFEED_KEY"]}, timeout=10)
rows = [(m["margin"], e["league"]["name"], e["home"], e["away"])
        for e in r.json()["events"] for m in e["markets"] if m["margin"] is not None]
for row in sorted(rows)[:10]:
    print(f"{row[0]:.2%}  {row[1]}: {row[2]} v {row[3]}")

Margins usually differ by market type, league and time to kick-off, so measure them on your own sample rather than assuming one number.

Why it matters#

• Comparing books. A lower overround means prices closer to the fair line. Pinnacle is widely used as a reference for that reason.
• Fair odds. fair = 1 / fairProb, with fairProb = (1/decimal) / (1 + margin). More: no-vig fair odds, implied probability.
• Liquidity. Pair margin with maxStake to see how much Pinnacle accepts at that price: max stake.

Plans#

margin, fair and fairProb are on every plan. Builder (€99/mo) adds WebSocket push and closing history. 3-day trial; a card is required and it is charged after day 3 unless you cancel. Free key.

Educational content for adults (18+). No tips, no guaranteed profit.

Related: Pinnacle margin calculator.

Questions people ask#

Why is margin null sometimes?#

When a market has an outcome without a valid price, margin and fair odds are left out instead of guessed.

Is this the same as "vig" or "juice"?#

Yes, overround, vig and juice describe the same built-in margin; PinnFeed reports it as a fraction (0.025 = 2.5%).

Which devig method is used?#

Proportional (multiplicative): each implied probability divided by their sum. If you prefer another method, recompute from decimal.