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

# Construir con Claude

> Conecta Claude a apinn y crea un detector de dropping odds en lenguaje natural.

apinn incluye un [servidor MCP](/es/mcp-server): **Claude llama a la API directamente** (deportes, partidos, cuotas, histórico) en lenguaje natural. Copia el prompt de abajo y Claude te construye un sistema de **dropping odds** (detectar cuotas que bajan — señal de dinero *sharp*).

## 1. Conecta Claude a 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>

Cuando Claude llame a la API, dale tu **clave** (`pnk_…`, en tu [panel](https://www.apinn.io/account)). ¿Sin MCP? El prompt también funciona dándole a Claude acceso HTTP: base `https://api.apinn.io`, cabecera `X-API-Key`.

## 2. El prompt de "dropping odds"

<Info>
  Una **dropping odd** = un resultado cuya cuota decimal **baja** (se acorta) de forma notable con el tiempo (p. ej. 2,50 → 2,10). Cuota más corta = probabilidad implícita que sube = dinero entrando en ese lado. Es una señal de *steam move* / acción informada.
</Info>

Pega esto en Claude tal cual (ajusta la clave y los parámetros de arriba):

```text Prompt theme={null}
Tienes acceso a la API de apinn (cuotas Pinnacle en tiempo real) vía las herramientas MCP "apinn"
(o por HTTP: base https://api.apinn.io, cabecera  X-API-Key: MI_CLAVE ).

OBJETIVO — Constrúyeme un monitor de "DROPPING ODDS".
Una dropping odd = un resultado cuya cuota decimal ha BAJADO (se ha acortado)
de forma significativa en el tiempo → señal de dinero sharp / steam move.

PARÁMETROS (cámbialos si quieres):
- deporte      = 29         # 29=fútbol, 33=tenis, 4=baloncesto
- mercado      = moneyline  # moneyline | spread | totals
- bajada_pct   = 8          # % de bajada mínimo para señalar
- cuota_min/max= 1.30 / 6.00    # ignora los extremos
- refresco     = 60         # segundos entre pasadas

MÉTODO:
1. Obtén los partidos en directo:
   GET /api/fixtures?sport_id={deporte}&live=1
2. Para cada evento, obtén el histórico completo de cuotas:
   GET /api/odds?event_id={id}&full_history=1&main_lines_only=1&market={mercado}
   (cada fila tiene timestamp + odds1=local, odds0=empate, odds2=visitante ;
    todds1/0/2 = las mismas cuotas SIN el margen — úsalas para una señal más limpia).
3. Para cada resultado, toma la cuota de APERTURA (primer snapshot) y la ACTUAL
   (último snapshot). Calcula  bajada% = (apertura − actual) / apertura × 100.
4. Conserva los resultados con  bajada% ≥ bajada_pct  Y  cuota_min ≤ actual ≤ cuota_max.
5. Ordena por bajada% descendente.
6. Muestra una tabla: partido | mercado | resultado | apertura → actual | bajada% | minutos desde apertura.
7. Repite cada {refresco}s ; alerta solo sobre bajadas NUEVAS o que aumentan.

Cada respuesta devuelve cabeceras de cuota (X-Quota-Remaining) — respeta el límite (5.000 req/h).
Empieza ahora: lista las dropping odds actuales.
```

## 3. Ir más lejos

<CardGroup cols={2}>
  <Card title="Un script autónomo" icon="python">
    Pídele a Claude: *"conviértelo en un script de Python autónomo que corra en bucle y me avise (print/Telegram) en cada nueva dropping odd"*.
  </Card>

  <Card title="En tiempo real" icon="bolt" href="/es/concepts/streaming">
    Para sub‑segundo, haz que Claude lea el flujo SSE `/api/stream` en vez de sondear.
  </Card>
</CardGroup>

<Tip>
  Variantes útiles que pedir a Claude: **rising odds** (cuotas que suben = dinero que sale), comparar **apertura vs cierre** (CLV), restringir a ciertas **ligas**, o ventana sobre los **últimos N minutos** en vez de desde la apertura.
</Tip>