# apinn

> L'API des cotes Pinnacle en temps réel — prématch et live, tout le book, au format Pinnacle Data API.

## Docs

- [Board — tous les matchs + cotes principales](https://docs.apinn.io/api-reference/board-—-tous-les-matchs-+-cotes-principales.md): Un match par ligne avec ses cotes principales (moneyline/spread/totals) — permet d'afficher tout le board en une réponse, sans N appels /api/odds.
- [Catalogue des specials / outrights](https://docs.apinn.io/api-reference/catalogue-des-specials-outrights.md): Une ligne par marché × contestant (props, futures) avec métadonnées, sans cotes.
- [CLV (closing line value)](https://docs.apinn.io/api-reference/clv-closing-line-value.md): Compare votre prix de pari au prix de clôture et renvoie le CLV en %.
- [CLV d'un special](https://docs.apinn.io/api-reference/clv-dun-special.md): Compare votre prix de pari au prix de clôture d'un contestant de special et renvoie le CLV.
- [Clôture d'un special](https://docs.apinn.io/api-reference/clôture-dun-special.md)
- [Compteurs globaux](https://docs.apinn.io/api-reference/compteurs-globaux.md): Nombre d'events, de lignes de cotes et de matchs live.
- [Cotes de clôture](https://docs.apinn.io/api-reference/cotes-de-clôture.md): Dernière observation par ligne (au coup d'envoi), avec true odds.
- [Cotes d'ouverture](https://docs.apinn.io/api-reference/cotes-douverture.md): Première observation par ligne, avec true odds.
- [Cotes d'un special](https://docs.apinn.io/api-reference/cotes-dun-special.md): Interrogeable par event_id OU special_id (les futures ont event_id null). full_history=1 pour la timeline.
- [Cotes d'un événement](https://docs.apinn.io/api-reference/cotes-dun-événement.md): Cotes courantes, ou timeline complète avec `full_history=1`. Inclut les true odds (`todds*`), les scores live et les cartons.
- [Couverture par sport](https://docs.apinn.io/api-reference/couverture-par-sport.md): Nombre d'events par sport actuellement dans le book.
- [Flux temps réel du board (SSE)](https://docs.apinn.io/api-reference/flux-temps-réel-du-board-sse.md): Server-Sent Events : snapshot initial du board puis deltas poussés (events: snapshot / update / remove). EventSource ne permettant pas de header, passez la clé en query ?key=. Voir le guide Flux temps réel.
- [Flux temps réel d'un événement (SSE)](https://docs.apinn.io/api-reference/flux-temps-réel-dun-événement-sse.md): SSE ciblé sur un event : snapshot puis mises à jour de ses cotes.
- [Lister les fixtures](https://docs.apinn.io/api-reference/lister-les-fixtures.md): Événements (prématch, live, variantes). Filtrable ; `parent_id` renvoie les enfants d'un match.
- [Lister les ligues](https://docs.apinn.io/api-reference/lister-les-ligues.md): Catalogue des ligues, filtrable par sport.
- [Lister les périodes](https://docs.apinn.io/api-reference/lister-les-périodes.md)
- [Lister les sports](https://docs.apinn.io/api-reference/lister-les-sports.md): Catalogue complet des sports, avec drapeau d'offre et compteurs de specials.
- [Marchés outright avec contestants & cotes](https://docs.apinn.io/api-reference/marchés-outright-avec-contestants-&-cotes.md): Marchés outright/futures regroupés, avec la liste des contestants et leurs cotes (odds + true odds). Filtrable par sport et nombre minimum de contestants.
- [Mouvement complet (ouverture + clôture + timeline)](https://docs.apinn.io/api-reference/mouvement-complet-ouverture-+-clôture-+-timeline.md): Combine ouverture, clôture et la timeline complète d'un événement en une réponse — pratique pour tracer le graphe de mouvement.
- [Ouverture d'un special](https://docs.apinn.io/api-reference/ouverture-dun-special.md)
- [Résultat & settlement](https://docs.apinn.io/api-reference/résultat-&-settlement.md): Score final, statut et règlement par ligne (win/loss/push).
- [Résultats des specials](https://docs.apinn.io/api-reference/résultats-des-specials.md): Settlement des outrights de tournoi. Nécessite les résultats de tournoi (hors périmètre live pour l'instant) — renvoie un tableau vide.
- [Specials d'un événement](https://docs.apinn.io/api-reference/specials-dun-événement.md)
- [Statut du service](https://docs.apinn.io/api-reference/statut-du-service.md): Endpoint public (sans clé) — indique que l'API répond.
- [Authentification](https://docs.apinn.io/authentication.md): Chaque requête est authentifiée par une clé API dans le header X-API-Key.
- [Prématch & live](https://docs.apinn.io/concepts/live-and-prematch.md): Comment prématch et in‑play sont modélisés, et le lien parent_id.
- [Marchés & lignes](https://docs.apinn.io/concepts/markets.md): moneyline, handicap, totals, team totals — par période, avec alt‑lines.
- [Résultats & settlements](https://docs.apinn.io/concepts/settlement.md): Scores finaux et règlement par ligne (win / loss / push).
- [Specials & outrights](https://docs.apinn.io/concepts/specials.md): Props, buteurs et vainqueurs de tournoi — catalogue et cotes.
- [Flux temps réel (SSE)](https://docs.apinn.io/concepts/streaming.md): Recevez les mouvements de cote poussés en Server‑Sent Events, sans polling.
- [True odds (devig)](https://docs.apinn.io/concepts/true-odds.md): Les probabilités justes, marge retirée — votre référence pour la value et le CLV.
- [Introduction](https://docs.apinn.io/index.md): L'API des cotes Pinnacle en temps réel — prématch et live, tout le book, au format Pinnacle Data API.
- [Serveur MCP](https://docs.apinn.io/mcp-server.md): Branchez apinn à votre assistant IA (Claude, Cursor…) via le serveur MCP.
- [Démarrage rapide](https://docs.apinn.io/quickstart.md): Votre première requête en une minute.
- [Quotas & limites](https://docs.apinn.io/rate-limits.md): 5 000 requêtes par heure, remises à zéro en haut de chaque heure UTC.

## OpenAPI Specs

- [openapi](https://docs.apinn.io/api-reference/openapi.json)