todds1 / todds0 / todds2 sont des cotes décimales justes, après retrait de la marge avec le modèle sélectionné. Ce ne sont pas des probabilités : la probabilité correspondante vaut 1/todds.
Elles sont présentes sur chaque snapshot de /api/odds (pas seulement ouverture/clôture), ce qui permet de suivre l’évolution de l’edge dans le temps.
Choisir le modèle de devig
Par défaut, lestodds utilisent le modèle MPTO (marge proportionnelle aux cotes). Cinq modèles sont disponibles — choisissez-le par requête avec ?model=, ou définissez votre préférence de compte dans le dashboard.
Noms, alias et formules
Les noms canoniques suivent le calculateur WinnerOdds. Les paramètres sont insensibles à la casse. Les alias historiques restent acceptés :multiplicative = EM, additive = MPTO, power = LOG.
Notation :
oᵢ = cote décimale brute, qᵢ = 1/oᵢ, S = Σqᵢ, m = S − 1, n = nombre d’issues mutuellement exclusives couvrant le marché. pᵢ est la probabilité juste ; la cote juste vaut 1/pᵢ. Pour SHIN, OR et LOG, le paramètre est résolu numériquement pour obtenir Σpᵢ = 1.
MPTO est notre modèle par défaut. Il retire
m/n à chaque probabilité implicite : pᵢ = 1/oᵢ − m/n. Cela équivaut à cote juste = n × oᵢ / (n − m × oᵢ). Il ne faut pas le confondre avec EM, qui multiplie chaque cote par S.
?model= (override par requête) > préférence du compte > MPTO. Le modèle s’applique à tous les endpoints portant des todds : /api/snapshot, /api/updated, /api/odds, /api/opening, /api/closing, /api/specials/odds et le flux /api/stream/event.
Sur le flux
/api/stream/odds, ?model= n’a pas d’effet : la trame est sérialisée une seule
fois pour tous les abonnés, ce qui interdit un modèle par client. Chaque ligne y porte donc
true_odds_by_model, avec les cinq modèles — vous choisissez à la lecture.Snapshot et mises à jour
Sur/api/snapshot et /api/updated, les todds sont recalculées à partir des cotes brutes pour chaque requête. Priorité : modèle valide dans ?model= > préférence valide du compte > MPTO. Une valeur inconnue retombe sur cette préférence ou le défaut.
Le token conserve le périmètre et le curseur, pas le modèle. Répétez model=MPTO à chaque appel /api/updated. Pour changer de modèle, rechargez /api/snapshot : un delta ne renvoie que les lignes modifiées, pas toutes les anciennes cotes à recalculer.
Exemple à trois issues
Pour les cotes brutes2.09 / 3.59 / 3.77, voici les résultats de notre implémentation, arrondis à quatre décimales.
SHIN / MPTO
SHIN et MPTO coïncident mathématiquement sur un marché complet à deux issues avec une marge positive. À trois issues ou plus, ils peuvent diverger ; EM et LOG restent des méthodes distinctes. Des valeurs identiques après arrondi ne suffisent donc pas à démontrer qu’un paramètre est ignoré.Détecter de la value (+EV)
Comparez les cotes d’un bookmaker auxtodds. Si un book offre une cote supérieure au todds correspondant, c’est une opportunité à valeur espérée positive.
Pinnacle étant le book le plus sharp, ses cotes devig sont votre OTB (Odds To Beat) — la référence pour identifier la value et calculer le CLV.
Specials & outrights
/api/specials/odds inclut aussi un champ todds sur chaque ligne. Tous les contestants d’un special sont devig ensemble (2‑way ou marché à N issues).
CLV
Le CLV compare votre prix de pari au prix de clôture. Récupérez la clôture avec/api/closing, puis appliquez la formule :
CLV% = (prix_pari / prix_clôture − 1) × 100 — un pari à 3,50 contre une clôture à 3,11 donne +12,5 %. Comparez de préférence les prix devig (todds) : la marge fausse le calcul.