Pinnacleのマージン（オーバーラウンド）をマーケット単位で取得

回答： /v1/odds、/v1/events/{id}、WebSocketのすべてのマーケットに margin が含まれます。これはオーバーラウンドで、マーケット内の各結果の 1/decimal を合計して1を引いた値です。margin が 0.025 なら、オッズのインプライド確率の合計は102.5%です。同じ計算から、各結果のマージン抜きフェアオッズ fair と fairProb（比例法）も得られます。全プランで利用できます。

自分で検証する#

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は margin と fairProb を小数第5位、fair を第4位に丸めています。

マージン順に並べる#

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]}")

マージンは通常、マーケットの種類、リーグ、試合開始までの時間によって変わります。決まった数字を仮定せず、ご自身のサンプルで測定してください。

何に使えるか#

• ブックメーカーの比較。 オーバーラウンドが低いほど、オッズはフェアなラインに近くなります。
• フェアオッズ。 fair = 1 / fairProb、fairProb = (1/decimal) / (1 + margin)。詳しくはマージン抜きフェアオッズとインプライド確率。
• 流動性。 margin と maxStake を組み合わせると、その価格でPinnacleがどれだけ受け付けるかが分かります。

プラン#

margin、fair、fairProb は全プランに含まれます。Builder（月額99ユーロ）ではWebSocketプッシュとクロージング履歴が加わります。3日間のトライアルにはカード登録が必要で、解約しない場合は3日目の後に課金されます。 無料キー。

18歳以上の方を対象とした教育目的のコンテンツです。技術ドキュメントであり、予想や利益の約束ではありません。日本では刑法により賭博は原則として禁止されています。

よくある質問#

marginがnullになるのはなぜですか？#

マーケット内に有効な価格のない結果がある場合、マージンとフェアオッズは推測せずに省略されます。

「ビッグ（vig）」や「ジュース」と同じですか？#

はい。オーバーラウンド、vig、juiceはいずれも同じ組み込みマージンを指します。PinnFeedでは小数（0.025 = 2.5%）で表します。

どの方法でマージンを除いていますか？#

比例法（乗法）です。別の方法を使いたい場合は decimal から再計算してください。