> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Construire avec Claude

> Branchez Claude sur apinn et construisez un détecteur de dropping odds en langage naturel.

apinn expose un [serveur MCP](/mcp-server) : **Claude appelle directement l'API** (sports, matchs, cotes, historique) en langage naturel. Copiez le prompt ci‑dessous et Claude vous construit un système de **dropping odds** (repérage des cotes qui chutent — signe d'argent « sharp »).

## 1. Connectez Claude à apinn

<CodeGroup>
  ```bash Claude Code theme={null}
  claude mcp add --transport http apinn https://docs.apinn.io/mcp
  ```

  ```json Claude Desktop / Cursor theme={null}
  {
    "mcpServers": {
      "apinn": { "url": "https://docs.apinn.io/mcp" }
    }
  }
  ```
</CodeGroup>

Quand Claude appelle l'API, fournissez votre **clé** (`pnk_…`, dans votre [espace client](https://www.apinn.io/account)). Pas de MCP ? Le prompt marche aussi en donnant à Claude l'accès HTTP : base `https://api.apinn.io`, header `X-API-Key`.

## 2. Le prompt « dropping odds »

<Info>
  Une **dropping odd** = une issue dont la cote décimale **baisse** nettement dans le temps (ex. 2,50 → 2,10). La cote qui raccourcit = la probabilité implicite qui monte = de l'argent qui arrive sur ce côté. C'est un signal de *steam move* / d'action informée.
</Info>

Copiez‑collez tel quel dans Claude (adaptez la clé et les paramètres en tête) :

```text Prompt theme={null}
Tu as accès à l'API apinn (cotes Pinnacle en temps réel) via les outils MCP « apinn »
(ou en HTTP : base https://api.apinn.io, header  X-API-Key: MA_CLE ).

OBJECTIF — Construis‑moi un moniteur de « DROPPING ODDS ».
Une dropping odd = une issue dont la cote décimale a BAISSÉ (raccourci) de façon
significative dans le temps → signe d'argent sharp / steam move.

PARAMÈTRES (modifie‑les si besoin) :
- sport            = 29        # 29=foot, 33=tennis, 4=basket
- marché           = moneyline # moneyline | spread | totals
- seuil_baisse     = 8         # % de baisse minimum pour signaler
- cote_min/max     = 1.30 / 6.00   # ignore les extrêmes
- rafraîchissement = 60        # secondes entre deux passes

MÉTHODE :
1. Récupère les matchs en cours :
   GET /api/fixtures?sport_id={sport}&live=1
2. Pour chaque event, récupère l'historique complet des cotes :
   GET /api/odds?event_id={id}&full_history=1&main_lines_only=1&market={marché}
   (chaque ligne a un timestamp + odds1=domicile, odds0=nul, odds2=extérieur ;
    todds1/0/2 = mêmes cotes SANS la marge — utilise-les pour un signal plus « juste »).
3. Pour chaque issue, prends la cote D'OUVERTURE (1er snapshot) et la cote ACTUELLE
   (dernier snapshot). Calcule  baisse% = (ouverture − actuelle) / ouverture × 100.
4. Garde les issues où  baisse% ≥ seuil_baisse  ET  cote_min ≤ actuelle ≤ cote_max.
5. Trie par baisse% décroissante.
6. Affiche un tableau : match | marché | issue | ouverture → actuelle | baisse% | minutes depuis l'ouverture.
7. Relance toutes les {rafraîchissement} s ; n'alerte que sur les baisses NOUVELLES ou qui s'accentuent.

Chaque réponse renvoie les headers de quota (X-Quota-Remaining) — respecte la limite (5 000 req/h).
Commence maintenant : liste les dropping odds actuelles.
```

## 3. Aller plus loin

<CardGroup cols={2}>
  <Card title="Un script autonome" icon="python">
    Demandez à Claude : *« transforme ça en script Python autonome qui tourne en boucle et m'envoie une alerte (print/Telegram) à chaque nouvelle dropping odd »*.
  </Card>

  <Card title="En temps réel" icon="bolt" href="/concepts/streaming">
    Pour du sous‑seconde, faites lire à Claude le flux SSE `/api/stream` au lieu de poller.
  </Card>
</CardGroup>

<Tip>
  Variantes utiles à demander à Claude : **rising odds** (cotes qui montent = argent qui part), comparer **ouverture vs clôture** (CLV), ne suivre que certaines **ligues**, ou fenêtrer sur les **N dernières minutes** plutôt que depuis l'ouverture.
</Tip>