Les cotes des bookmakers ADM italiens, étrangers et des exchanges dans une seule API.

GET /api/v1/mock/odds sans clé

Chaque endpoint a un jumeau sous /api/v1/mock/ qui répond tout de suite, sans inscription et sans consommer de quota : même forme de réponse, mêmes paramètres, même validation stricte que le flux réel. Les cotes sont synthétiques — mock: true, en-tête X-Odss-Mock: 1, ids préfixés mock_ — elles servent à écrire et tester votre code, pas à parier.

curl "https://odss-api.com/api/v1/mock/odds?sport=calcio&limit=3"

Disponibles : /mock/odds · /mock/odds/history · /mock/sports · /mock/bookmakers · /mock/leagues · /mock/status · /mock/stream (SSE) · /mock/ticker (une trame de cotes 1X2 d'exemple toutes les 5 s, sans paramètres). Le paramètre seed rend la réponse reproductible : utilisez-le en CI plutôt que de brûler du quota à chaque exécution.

Sur le flux RÉEL, sont aussi publics sans clé /api/v1/leagues, /api/v1/coverage, /api/v1/status et /api/v1/pulse.

Premier appel en 3 étapes

1. Créez la clé Inscrivez-vous et générez une clé dans le tableau de bord. Le plan Free est permanent.
2. Listez les sports Vérifiez la clé avec un appel à /sports.
3. Demandez les cotes Appelez /odds avec sport et marché : vous obtenez les cotes cross-book.

GET /api/v1/odds exemple

curl "https://odss-api.com/api/v1/odds?sport=calcio&league=serie%20a&limit=5" \
  -H "x-api-key: odss_live_..."

const r = await fetch(
  "https://odss-api.com/api/v1/odds?sport=calcio&league=serie%20a&limit=5",
  { headers: { "x-api-key": "odss_live_..." } }
);
const { count, odds } = await r.json();

import requests
r = requests.get(
    "https://odss-api.com/api/v1/odds",
    params={"sport": "calcio", "league": "serie a", "limit": 5},
    headers={"x-api-key": "odss_live_..."},
)
data = r.json()  # { count, offset, returned, state, odds: [...] }

GET /api/v1/odds

Les cotes cross-book actuelles, regroupées par événement, marché et ligne. Chaque enregistrement liste les bookmakers avec leurs issues et l'horodatage de leur dernière mise à jour.

Paramètres

Champs de la réponse

Pagination

Répétez l'appel en augmentant offset de returned, tant que offset + returned < count. Le programme est vivant : count peut varier légèrement entre les pages.

GET /api/v1/odds?sport=calcio&limit=1000&offset=0
GET /api/v1/odds?sport=calcio&limit=1000&offset=1000
# … tant que offset + returned < count

GET /api/v1/sports

Les sports disponibles en ce moment dans le flux (les valeurs du paramètre sport).

GET /api/v1/bookmakers

Les bookmakers actifs dans le flux, chacun avec ces champs.

GET /api/v1/leagues public, sans clé

Le programme actuel agrégé : pour chaque sport, les ligues cotées, avec nombre d'événements et de bookmakers. Utile pour découvrir les valeurs du filtre league.

GET /api/v1/stream Pro et Enterprise

Server-Sent Events : n'arrivent que les enregistrements modifiés et supprimés, pas de polling. Avec state=live, le live arrive en général en 10 à 30 secondes (médiane mesurée, environ 15 s). Limite actuelle, mesurée le 8 octobre 2026 : avec state=all un tour d'avant-match complet pèse des centaines de Mo et la connexion tombe avant de le recevoir ; le flux est resté sans changement 79 % du temps, avec un resync toutes les 12 minutes environ. L'avant-match n'arrive qu'avec des filtres étroits (sport, marché, ligue), par vagues, quand l'instantané servi se renouvelle. Nous réécrivons la livraison en petites pages avec contre-pression ; d'ici là, pour tout l'avant-match, utilisez l'instantané paginé de /odds.

GET /api/v1/odds/history

Pas encore actif. La capture est éteinte aujourd'hui : chaque appel répond 200 avec count: 0 et history_enabled: false, et compte dans le quota. Une fois actif : historique des variations de cote d'un événement, une ligne à chaque fois qu'un bookmaker bouge un prix sur un groupe. Filtres event_id (obligatoire), book, market, from/to (ISO), limit. Du plus récent : pour un événement commencé, la première ligne est sa clôture. Respecte la portée de la clé.

curl "https://odss-api.com/api/v1/odds/history?event_id=a3f9c1e07b2d4865&book=snai" \
  -H "x-api-key: odss_live_..."

GET /api/v1/middles

Middles Over/Under calculés sur le flux courant : OVER sur une ligne basse chez un book, UNDER sur une ligne haute chez un autre. Si le total tombe dans la fenêtre, les deux paris gagnent. Champs middle_window, hit_return_pct, miss_return_pct, safe (aucune perte même à côté). Filtres : sport, min_return, safe, limit.

Règle de fraîcheur : une cote figée depuis plus de stale_after_seconds (900s par défaut) reste dans les réponses de /odds avec son last_update, mais n'est jamais appariée dans un middle : une jambe périmée n'existe probablement plus chez le bookmaker. Le seuil appliqué et les jambes écartées figurent dans la réponse.

Limites de safe, aujourd'hui : certaines familles de marché ne sont pas encore séparées par unité (au tennis et au volley un total de sets peut côtoyer un total de jeux ou de points), certains pseudo-événements « Home - Away » d'une plateforme sont servis comme des matchs, et deux matchs homonymes peuvent partager un event_id. Dans ces cas safe: true n'est pas un vrai middle : avant d'agir, vérifiez que les deux jambes sont le même match, la même unité et le même horaire. La réponse le rappelle dans le champ safe_note.

curl "https://odss-api.com/api/v1/middles?sport=calcio&safe=true" \
  -H "x-api-key: odss_live_..."

GET /api/v1/coverage public, sans clé

Combien de marques de bookmakers ont une cote valide dans le flux actuel, par région (Italie, USA, UK, monde). Correspond aux entrées de /api/v1/bookmakers : les deux comptent un opérateur une seule fois, avec ses lignes de marché dédiées (ex. <marque>-corners) sous la marque ; dans /bookmakers les clés de ses cotes sont dans feed_keys.

GET /api/v1/coverage/matrix public, sans clé

Pour chaque bookmaker, sport par sport : les marchés normalisés qu'il cote en ce moment, avec les lignes vues. Cela sert à distinguer trois choses qu'une liste plate confond.

Un marché non listé sous un opérateur attivo est une absence structurelle : il ne le cote pas, et demain ce sera pareil. Les bookmakers dans live_only_bookmakers ont des lignes mais pas en pré-match, donc sur leurs marchés pré-match cette réponse ne dit rien ; si un couloir du flux n'a pas répondu, incomplete_lanes le nomme et la couverture est partielle, pas absente.

Et un marché que le moteur ne sait pas mapper avec certitude n'est jamais deviné : il sort en other:<étiquette> et n'est ici que compté (other_markets), car deux books l'appellent différemment et comparer ces étiquettes serait faux — celles que beaucoup de books écrivent à l'identique sont dans other_markets_common. Portée prematch, recalculée au maximum toutes les 10 minutes (generated_at).

GET /api/v1/pulse public, sans clé

Le battement du flux, uniquement des nombres agrégés (ni prix, ni noms de books) : c'est ce que les pages de ce site interrogent d'elles-mêmes. Aucun paramètre, Cache-Control: public, max-age=5, limite par IP à part (60 par minute).

POST /api/mcp MCP

Serveur MCP (JSON-RPC 2.0) pour agents IA et connecteurs (Claude, ChatGPT…). Auth avec la même clé (Authorization: Bearer odss_live_… ou x-api-key). Outils : get_odds (avec state=live), list_sports, list_bookmakers, list_leagues. Seul tools/call consomme du quota ; le handshake est gratuit. Stateless.

curl -X POST https://odss-api.com/api/mcp \
  -H "Authorization: Bearer odss_live_..." -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_odds","arguments":{"sport":"calcio","state":"live","limit":5}}}'

Webhook Enterprise

Enregistrez une URL https et recevez les changements de cotes par POST, avec le même payload {changed, removed} que le flux.

Limites, en-têtes et erreurs

Chaque réponse authentifiée inclut X-RateLimit-Limit (quota mensuel du plan), X-RateLimit-Remaining et X-RateLimit-Reset (temps unix en secondes où la fenêtre se rouvre ; sur le 429 de quota la même date est dans le corps comme retry_at). Le quota vaut pour une fenêtre de 30 jours qui commence à la première requête de la période : à son terme, le compteur repart de zéro avec la requête suivante.

curl "https://odss-api.com/api/v1/odds?bookmaker=snai" -H "x-api-key: odss_live_..."

HTTP/1.1 400 Bad Request
{
  "error": "Parametro sconosciuto: \"bookmaker\" (forse intendevi \"bookmakers\"?). Ammessi su questo endpoint: after, bookmakers, changed_since, commence_from, commence_to, content, country, event_id, format, league, limit, market, offset, playable_it, player, sport, state"
}

Ressources pour machines et agents

Pour générer des clients, SDK ou utiliser l'API depuis un agent IA : le contrat OpenAPI 3.1 et un guide concis pour LLM sont publics et toujours synchronisés.

Licence d'utilisation

L'usage interne (modèles, bots, analyses, backtests) est inclus dans tous les plans. Redistribuer les données — p. ex. les afficher aux utilisateurs finaux de votre produit — exige la licence de Redistribution Display (option Enterprise, +120 €/mois), qui ne couvre que l'affichage. Créer, alimenter ou commercialiser des services de surebet/arbitrage, de value betting ou équivalents exige en revanche la Surebet API, le plan qui comprend la licence pour revendre les surebets calculées : 950 €/mois + TVA. Redistribuer l'API ou les données brutes reste hors de tout plan : pour cela, écrivez à [email protected].