> ## 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.

# Démarrage rapide

> Votre première requête en une minute.

## 1. Récupérez votre clé API

Créez un compte sur [apinn.io](https://www.apinn.io/signup) — l'essai gratuit inclut **5 000 requêtes / heure**. Votre clé (`pnk_…`) s'affiche dans votre [espace client](https://www.apinn.io/account).

## 2. Faites votre première requête

Passez la clé dans le header `X-API-Key` sur chaque appel.

<CodeGroup>
  ```bash curl theme={null}
  # Historique complet des cotes d'un événement
  curl https://api.apinn.io/api/odds \
    -H "X-API-Key: VOTRE_CLE" \
    -G --data-urlencode "event_id=1608247913" \
       --data-urlencode "full_history=1"
  ```

  ```python Python theme={null}
  import requests

  BASE = "https://api.apinn.io"
  H = {"X-API-Key": "VOTRE_CLE"}

  r = requests.get(f"{BASE}/api/odds",
      params={"event_id": 1608247913, "full_history": 1}, headers=H)
  odds = r.json()
  print(f"{len(odds)} mouvements de cote")
  ```

  ```javascript Node.js theme={null}
  const BASE = "https://api.apinn.io";
  const H = { "X-API-Key": "VOTRE_CLE" };

  const r = await fetch(`${BASE}/api/odds?event_id=1608247913&full_history=1`, { headers: H });
  const odds = await r.json();
  console.log(`${odds.length} mouvements de cote`);
  ```
</CodeGroup>

## 3. Explorez le book

```bash theme={null}
# Lister les sports
curl https://api.apinn.io/api/sports -H "X-API-Key: VOTRE_CLE"

# Les matchs live d'un sport (29 = Soccer)
curl "https://api.apinn.io/api/fixtures?sport_id=29&live=1" -H "X-API-Key: VOTRE_CLE"

# Les cotes principales d'un match
curl "https://api.apinn.io/api/odds?event_id=1608247913&main_lines_only=1" -H "X-API-Key: VOTRE_CLE"
```

<Tip>
  Chaque réponse renvoie des headers de quota : `X-Quota-Limit`, `X-Quota-Remaining`, `X-Quota-Cost`. Voir [Quotas & limites](/rate-limits).
</Tip>

## Prochaines étapes

<CardGroup cols={2}>
  <Card title="Référence API" icon="code" href="/api-reference/introduction">
    Tous les endpoints et paramètres.
  </Card>

  <Card title="Flux temps réel" icon="bolt" href="/concepts/streaming">
    Recevez les deltas poussés en SSE.
  </Card>
</CardGroup>