# Use a sala de opções com a sua IA

> O prompt pronto e os campos da API pública da sala de opções OMININ, para a sua IA estudar opções da B3 com dados de fim de pregão. Estudo, não recomendação.

A sala de opções OMININ calcula, a cada pregão, a grade de opções da B3, o gama do índice (IBOV e BOVA11) e a volatilidade de cada papel. Os dados são de fim de pregão e a leitura é pública, sem login.

**É estudo, não recomendação.** Nada aqui diz para comprar ou vender; a sua IA mostra números, riscos e o que invalida a ideia.

Há dois caminhos. Escolha o que a sua IA consegue usar e troque o que está entre {chaves} antes de colar.

## Prompt pela API (o principal)

Para IA que lê endereços de internet ou tem navegador. Lê a postagem do dia e a grade leve, filtra para o seu tamanho e monta até 4 candidatas.

```text
Você vai estudar uma operação de opções da B3 com a sala de opções OMININ
(https://opcoes.ominin.com.br). É estudo, não recomendação: não diga para eu
executar; mostre números, riscos e o que invalida a ideia.

MEU CONTEXTO
- Capital para a operação: até R$ {capital} (perda máxima aceitável: R$ {perda_max}).
- Margem: {posso usar margem / não posso usar margem}.
- Prazo: {de 1 a 8 semanas}.
- Ativo: {BOVA11 ou outro papel}. Visão, se tiver: {alta / baixa / lateral / sem visão}.

1. LEIA A POSTAGEM DO DIA
   Lista: https://opcoes.ominin.com.br/api/opcoes/blog (a primeira é a mais nova; campo "posts")
   Texto: https://opcoes.ominin.com.br/api/opcoes/blog/{slug}  (campo "corpo")
   Anote: data do fechamento, regime do gama (positivo/negativo), troca de sinal,
   distância do preço à troca, e a tabela de volume anormal.
   Confira se a data do fechamento é o pregão anterior a hoje. Se não for, avise.

2. LEIA A GRADE DO DIA
   Primeiro, descubra os vencimentos (resposta pequena, uns 20 KB):
   https://opcoes.ominin.com.br/api/opcoes/cadeia?papel={PAPEL}&data={AAAA-MM-DD}&faixa=1&tipo=call&negociadas=1
   Depois leia a grade leve de um vencimento (só aquele vencimento e strikes a até ±10% do preço;
   sem os filtros a grade inteira passa de 500 KB):
   https://opcoes.ominin.com.br/api/opcoes/cadeia?papel={PAPEL}&data={AAAA-MM-DD}&vencimento={AAAA-MM-DD}&faixa=10
   Use a data exata do vencimento que a lista trouxe: vencimento que não existe volta vazio
   (feriado muda a data do mensal). A grade também aceita tipo=call|put e negociadas=1.
   Volatilidade em perspectiva:
   https://opcoes.ominin.com.br/api/opcoes/ivrank?papel={PAPEL}&ate={AAAA-MM-DD}
   Valores em centavos (_cents). Para cada vencimento: linhas por strike, com
   call e put: close_cents, bid_cents, ask_cents, trades (negócios), qty,
   oi_qty (posição em aberto), gregas (vol, delta, theta_cents, prob_exercicio).

3. FILTRE PARA O MEU TAMANHO (não use a lista de volume da postagem para isso:
   ela mostra fluxo institucional, quase sempre ITM)
   - vencimento com 5 a 40 pregões;
   - delta entre 0,15 e 0,55 (em módulo);
   - 300 negócios ou mais no dia e posição em aberto alta;
   - diferença entre compra e venda de até 10% do preço;
   - preço unitário que caiba no capital em lotes de 100.
   O número no código NÃO é o strike (ex.: BOVAK179 tem strike 180).
   Sempre use strike_cents. Séries sem "/AAAA" podem ser de outro ano.

4. MONTE ATÉ 4 CANDIDATAS, do mais simples ao mais estruturado:
   compra seca; trava de débito; (só se margem permitida) trava de crédito.
   Venda descoberta: só se a perda numa queda de 10% couber no capital.
   Para cada uma, entregue:
   - pernas com código, strike, quantidade, preço do fechamento e pela oferta;
   - custo ou margem, ganho máximo, perda máxima, equilíbrio (e % do preço atual);
   - prob_exercicio de cada perna e theta em R$ por dia da posição;
   - se combina ou não com o regime do gama da postagem, em uma linha.
   Confira a série de valor pela sala:
   https://opcoes.ominin.com.br/api/opcoes/estrutura?legs=+CODIGO:QTD,-CODIGO:QTD&to={AAAA-MM-DD}
   (a série termina no último pregão até a data "to"; esse último ponto deve bater com a sua conta no fechamento).

5. RESPOSTA
   Uma tabela comparando as candidatas, uma linha "o que invalida" por operação,
   e o link https://opcoes.ominin.com.br/sala para eu montar e acompanhar
   (Grade, Montagem, Risco). Sem jargão em inglês. Sem recomendar execução.

REGRAS
- Dado de fim de pregão: não há oferta ao vivo. Compra/venda é a oferta do fechamento.
- Não invente preço: se close_cents vier null, diga "sem negócio no dia".
- Custos de corretagem e emolumentos ficam fora; avise isso.
- Em ações e no BOVA11, _cents ÷ 100 = reais. No IBOV (papel IBOV11), _cents ÷ 10.000 = pontos.
- Campos e regras completos da API: https://opcoes.ominin.com.br/llms.txt
```

## Prompt pelo navegador

Sem a API: o agente abre a sala no próprio navegador e aprende os botões sozinho. Parte da lista de volume da postagem do dia.

```text
Você vai estudar opções da B3 usando um site, pelo seu navegador.
É estudo: não recomende executar nada.

MEU LIMITE: até R$ {capital} por operação, {com/sem} margem.

PASSO 1 — O BLOG
Abra https://opcoes.ominin.com.br/blog e entre na postagem mais recente
("Gama do índice (IBOV e BOVA11)...").
Anote:
- a data do fechamento (primeira linha do texto);
- o regime do gama (positivo ou negativo) e a troca de sinal;
- a tabela "Opções com volume anormal em {dd/mm}", logo abaixo da tabela
  do gama. Ela tem até 5 linhas e 7 colunas: Opção, Papel, Strike,
  ITM/ATM/OTM, Prêmio negociado, Volume × média, Volume × posição em aberto.

PASSO 2 — A SALA (https://opcoes.ominin.com.br/sala, não precisa login)
Para cada linha da tabela de volume:
a) Abra a Grade no papel da linha, na data do fechamento.
   Ache a opção. Anote preço, vencimento e negócios no dia.
   O número no código nem sempre é o strike: use o strike da Grade.
b) Veja quanto custam 100 opções (o lote mínimo).
c) Monte na Montagem, no mesmo papel, mesmo vencimento e mesma direção
   (call = alta, put = baixa), até 3 versões que caibam no meu limite:
   - compra seca de uma opção perto do dinheiro;
   - trava de débito (compra uma perto do dinheiro, vende uma mais longe);
   - trava de crédito, só se eu puder usar margem.
   Escolha séries com muitos negócios no dia.
d) Envie cada versão como uma operação e, na janela dela, abra a aba
   Risco: custo, ganho máximo, perda máxima e equilíbrio.

PASSO 3 — A RESPOSTA
Uma tabela por linha da lista do blog, neste formato:

Opção do blog: {código} ({papel}, strike, vencimento, preço, negócios)
| Versão | Pernas (código, strike, qtd) | Custo | Ganho máx. | Perda máx. | Equilíbrio (% do preço) |
| original (100 opções) | ... |
| compra seca | ... |
| trava de débito | ... |
| trava de crédito | ... (só com margem) |
Combina com o regime do gama? (uma linha)

No fim:
- 2 linhas: a lista de volume do blog ajuda quem opera com R$ {capital}?
- O que foi difícil de achar ou de clicar no site.
```

Se o agente travar no navegador: a Montagem tem "colar linha", que aceita `+BOVAK170:1700,-BOVAK179:1700`; apertar Esc fecha a janela Montagem inteira.

## Campos e regras da API

A base é `https://opcoes.ominin.com.br/api/opcoes`. Todas as rotas abaixo são GET, públicas e sem login.

### As rotas

- `/api/opcoes/blog`: a lista das postagens (campo `posts`, a primeira é a mais nova).
- `/api/opcoes/blog/{slug}`: a postagem inteira (campo `corpo`, em Markdown).
- `/api/opcoes/cadeia?papel=BOVA11`: a grade do papel. O pregão vai em `data` (AAAA-MM-DD); sem ele, vem o último pregão.
- `/api/opcoes/ivrank?papel=BOVA11`: o pregão vai em `ate` (AAAA-MM-DD), não em `data`. Mostra onde está a volatilidade de hoje na faixa do último ano (`iv_rank`, `faixa`, `vol_hoje`, `vol_min`, `vol_max`).
- `/api/opcoes/estrutura?legs=+BOVAK170:100,-BOVAK179:100`: a série de valor de uma operação montada (`legs` usa + para comprar e - para vender, com a quantidade depois dos dois pontos). A janela vai em `from` e `to` (AAAA-MM-DD); sem elas, são os últimos 180 dias até hoje. O último ponto é o último pregão até `to`.

### Valores e códigos

- Os valores vêm em centavos (campos terminados em `_cents`). Em ações e no BOVA11, `close_cents` 374 é R$ 3,74.
- No IBOV (papel `IBOV11`) os centavos vêm 100 vezes maiores: divida por 10.000 para ter pontos. Vale para fechamento, strike, prêmio e gregas em valor (`vega_cents`, `theta_cents`); o `gex_cents` não segue essa regra. No pregão de 29/10/2026, o fechamento veio `1693030000` (169.303 pontos), o strike `1700000000` (170.000 pontos) e o prêmio da call `IBOVK70`, `37650000` (3.765 pontos). Confira sempre pelo tamanho do número: pontos do IBOV têm seis dígitos.
- `strike_cents` é o strike. O número no código da série não é: `BOVAK179` tem strike 180 e `IBOVK70` tem strike 170.000.
- Alguns códigos levam o ano depois da barra, como `BOVAK176/2026`, porque a B3 reaproveita o código de série. Sem o `/AAAA`, o código pode ser de outro ano.
- Cada vencimento tem `tipo`: `mensal` ou `semanal`. Sempre use a data exata (AAAA-MM-DD) que a lista trouxe: feriado muda o mensal.
- Em cada linha da grade, `call` e `put` trazem `instrumento`, `close_cents` (null = sem negócio no dia), `trades` (negócios), `qty` (quantidade negociada), `bid_cents` e `ask_cents` (oferta de compra e de venda do fechamento, null quando não houve), `close_anterior_cents`, `oi_qty` (posição em aberto) e `gregas` (`vol`, `delta`, `gama`, `vega_cents`, `theta_cents` por opção e por dia, `prob_exercicio`).
- Dado de fim de pregão: não há oferta ao vivo e a oferta é a do fechamento.

### Filtros da grade

Sem filtro, a grade inteira passa de 500 KB. Use:

- `vencimento=AAAA-MM-DD` (vários, separados por vírgula): só esses vencimentos. Data que não existe volta `vencimentos` vazio.
- `faixa=1` a `50`: só strikes a até esse percentual em torno do fechamento do papel.
- `tipo=call` ou `tipo=put`: só esse lado.
- `negociadas=1`: só células com negócio no pregão.
- Para listar os vencimentos de um papel, leia `faixa=1&tipo=call&negociadas=1` (uns 20 KB). Para estudar um vencimento, `vencimento=...&faixa=10` (uns 30 KB).

### Erros, limite e memória de resposta

- Erro vem como `{"error":{"code":"...","message":"..."}}`. Na grade, o 400 tem código próprio: `vencimento_invalido`, `faixa_invalida`, `tipo_invalido`, `negociadas_invalida` e `faixa_sem_fechamento` (o papel não fechou naquele pregão).
- O limite é de 1200 pedidos por minuto por IP. Passou disso: 429 `rate_limited`, com o cabeçalho `Retry-After` (segundos para esperar).
- Em geral a resposta 200 pode ser guardada por 5 minutos (`Cache-Control: public, max-age=300`), mas respeite o `Cache-Control` de cada resposta: a `estrutura`, por exemplo, manda `max-age=86400` ou `no-store`. Pregão fechado não muda: não precisa pedir de novo.

### Contato

Dúvida ou problema: suporte@ominin.com.br. É estudo, não recomendação.