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

# Avvio rapido

> La tua prima richiesta in un minuto.

## 1. Ottieni la tua chiave API

Crea un account su [apinn.io](https://www.apinn.io/signup) — la prova gratuita include **5.000 richieste / ora**. La tua chiave (`pnk_…`) viene mostrata nella tua [area cliente](https://www.apinn.io/account).

## 2. Effettua la tua prima richiesta

Passa la chiave nell'header `X-API-Key` su ogni chiamata.

<CodeGroup>
  ```bash curl theme={null}
  # Storico completo delle quote di un evento
  curl https://api.apinn.io/api/odds \
    -H "X-API-Key: TUA_CHIAVE" \
    -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": "TUA_CHIAVE"}

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

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

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

## 3. Esplora il book

```bash theme={null}
# Elencare gli sport
curl https://api.apinn.io/api/sports -H "X-API-Key: TUA_CHIAVE"

# I match live di uno sport (29 = Soccer)
curl "https://api.apinn.io/api/fixtures?sport_id=29&live=1" -H "X-API-Key: TUA_CHIAVE"

# Le quote principali di un match
curl "https://api.apinn.io/api/odds?event_id=1608247913&main_lines_only=1" -H "X-API-Key: TUA_CHIAVE"
```

<Tip>
  Ogni risposta restituisce header di quota: `X-Quota-Limit`, `X-Quota-Remaining`, `X-Quota-Cost`. Vedi [Quote & limiti](/it/rate-limits).
</Tip>

## Prossimi passi

<CardGroup cols={2}>
  <Card title="Riferimento API" icon="code" href="/it/api-reference/introduction">
    Tutti gli endpoint e i parametri.
  </Card>

  <Card title="Flusso in tempo reale" icon="bolt" href="/it/concepts/streaming">
    Ricevi i delta inviati in SSE.
  </Card>
</CardGroup>