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

# Costruire con Claude

> Collega Claude ad apinn e crea un rilevatore di dropping odds in linguaggio naturale.

apinn offre un [server MCP](/it/mcp-server): **Claude chiama l'API direttamente** (sport, partite, quote, storico) in linguaggio naturale. Copia il prompt qui sotto e Claude ti costruisce un sistema di **dropping odds** (individuare quote che scendono — segnale di denaro *sharp*).

## 1. Collega Claude ad 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>

Quando Claude chiama l'API, forniscigli la tua **chiave** (`pnk_…`, nella tua [dashboard](https://www.apinn.io/account)). Niente MCP? Il prompt funziona anche dando a Claude l'accesso HTTP: base `https://api.apinn.io`, header `X-API-Key`.

## 2. Il prompt "dropping odds"

<Info>
  Una **dropping odd** = un esito la cui quota decimale **scende** (si accorcia) in modo netto nel tempo (es. 2,50 → 2,10). Quota più corta = probabilità implicita che sale = denaro che entra su quel lato. È un segnale di *steam move* / azione informata.
</Info>

Incolla questo in Claude così com'è (adatta chiave e parametri in alto):

```text Prompt theme={null}
Hai accesso all'API di apinn (quote Pinnacle in tempo reale) tramite gli strumenti MCP "apinn"
(o via HTTP: base https://api.apinn.io, header  X-API-Key: LA_MIA_CHIAVE ).

OBIETTIVO — Costruiscimi un monitor di "DROPPING ODDS".
Una dropping odd = un esito la cui quota decimale è SCESA (accorciata)
in modo significativo nel tempo → segnale di denaro sharp / steam move.

PARAMETRI (modificali se vuoi):
- sport       = 29         # 29=calcio, 33=tennis, 4=basket
- mercato     = moneyline  # moneyline | spread | totals
- calo_pct    = 8          # % di calo minima per segnalare
- quota_min/max= 1.30 / 6.00   # ignora gli estremi
- refresh     = 60         # secondi tra un passaggio e l'altro

METODO:
1. Prendi le partite live:
   GET /api/fixtures?sport_id={sport}&live=1
2. Per ogni evento, prendi lo storico completo delle quote:
   GET /api/odds?event_id={id}&full_history=1&main_lines_only=1&market={mercato}
   (ogni riga ha un timestamp + odds1=casa, odds0=pareggio, odds2=trasferta ;
    todds1/0/2 = le stesse quote SENZA il margine — usale per un segnale più pulito).
3. Per ogni esito, prendi la quota di APERTURA (primo snapshot) e quella ATTUALE
   (ultimo snapshot). Calcola  calo% = (apertura − attuale) / apertura × 100.
4. Tieni gli esiti con  calo% ≥ calo_pct  E  quota_min ≤ attuale ≤ quota_max.
5. Ordina per calo% decrescente.
6. Stampa una tabella: partita | mercato | esito | apertura → attuale | calo% | minuti dall'apertura.
7. Ripeti ogni {refresh}s ; segnala solo i cali NUOVI o che aumentano.

Ogni risposta restituisce header di quota (X-Quota-Remaining) — rispetta il limite (5.000 req/h).
Inizia ora: elenca le dropping odds attuali.
```

## 3. Andare oltre

<CardGroup cols={2}>
  <Card title="Uno script autonomo" icon="python">
    Chiedi a Claude: *"trasformalo in uno script Python autonomo che gira in loop e mi avvisa (print/Telegram) a ogni nuova dropping odd"*.
  </Card>

  <Card title="In tempo reale" icon="bolt" href="/it/concepts/streaming">
    Per il sub‑secondo, fai leggere a Claude il flusso SSE `/api/stream` invece di fare polling.
  </Card>
</CardGroup>

<Tip>
  Varianti utili da chiedere a Claude: **rising odds** (quote che salgono = denaro che esce), confrontare **apertura vs chiusura** (CLV), limitarsi a certe **leghe**, o finestra sugli **ultimi N minuti** invece che dall'apertura.
</Tip>