> ## 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 com Claude

> Ligue o Claude ao apinn e crie um detector de dropping odds em linguagem natural.

O apinn disponibiliza um [servidor MCP](/pt/mcp-server): o **Claude chama a API diretamente** (desportos, jogos, odds, histórico) em linguagem natural. Copie o prompt abaixo e o Claude constrói-lhe um sistema de **dropping odds** (detetar odds que caem — sinal de dinheiro *sharp*).

## 1. Ligue o Claude ao 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 o Claude chamar a API, dê-lhe a sua **chave** (`pnk_…`, no seu [painel](https://www.apinn.io/account)). Sem MCP? O prompt também funciona dando ao Claude acesso HTTP: base `https://api.apinn.io`, cabeçalho `X-API-Key`.

## 2. O prompt de "dropping odds"

<Info>
  Uma **dropping odd** = um resultado cuja odd decimal **cai** (encurta) de forma notória ao longo do tempo (ex.: 2,50 → 2,10). Odd mais curta = probabilidade implícita a subir = dinheiro a entrar nesse lado. É um sinal de *steam move* / ação informada.
</Info>

Cole isto no Claude tal como está (ajuste a chave e os parâmetros no topo):

```text Prompt theme={null}
Tens acesso à API do apinn (odds Pinnacle em tempo real) via as ferramentas MCP "apinn"
(ou por HTTP: base https://api.apinn.io, cabeçalho  X-API-Key: A_MINHA_CHAVE ).

OBJETIVO — Constrói-me um monitor de "DROPPING ODDS".
Uma dropping odd = um resultado cuja odd decimal CAIU (encurtou)
de forma significativa ao longo do tempo → sinal de dinheiro sharp / steam move.

PARÂMETROS (altera se quiseres):
- desporto     = 29         # 29=futebol, 33=ténis, 4=basquetebol
- mercado      = moneyline  # moneyline | spread | totals
- queda_pct    = 8          # % de queda mínima para sinalizar
- odd_min/max  = 1.30 / 6.00    # ignora os extremos
- refresco     = 60         # segundos entre passagens

MÉTODO:
1. Obtém os jogos ao vivo:
   GET /api/fixtures?sport_id={desporto}&live=1
2. Para cada evento, obtém o histórico completo das odds:
   GET /api/odds?event_id={id}&full_history=1&main_lines_only=1&market={mercado}
   (cada linha tem timestamp + odds1=casa, odds0=empate, odds2=fora ;
    todds1/0/2 = as mesmas odds SEM a margem — usa-as para um sinal mais limpo).
3. Para cada resultado, toma a odd de ABERTURA (primeiro snapshot) e a ATUAL
   (último snapshot). Calcula  queda% = (abertura − atual) / abertura × 100.
4. Mantém os resultados com  queda% ≥ queda_pct  E  odd_min ≤ atual ≤ odd_max.
5. Ordena por queda% decrescente.
6. Mostra uma tabela: jogo | mercado | resultado | abertura → atual | queda% | minutos desde a abertura.
7. Repete a cada {refresco}s ; alerta apenas sobre quedas NOVAS ou que aumentam.

Cada resposta devolve cabeçalhos de quota (X-Quota-Remaining) — respeita o limite (5.000 req/h).
Começa agora: lista as dropping odds atuais.
```

## 3. Ir mais longe

<CardGroup cols={2}>
  <Card title="Um script autónomo" icon="python">
    Peça ao Claude: *"transforma isto num script Python autónomo que corre em loop e me avisa (print/Telegram) a cada nova dropping odd"*.
  </Card>

  <Card title="Em tempo real" icon="bolt" href="/pt/concepts/streaming">
    Para sub‑segundo, faça o Claude ler o fluxo SSE `/api/stream` em vez de sondar.
  </Card>
</CardGroup>

<Tip>
  Variantes úteis para pedir ao Claude: **rising odds** (odds a subir = dinheiro a sair), comparar **abertura vs fecho** (CLV), restringir a certas **ligas**, ou janela sobre os **últimos N minutos** em vez de desde a abertura.
</Tip>