Options Payoff: visualize cenários sem confundir modelo com cotação

ANÁLISE EDITORIAL

Uma curva de payoff ajuda a enxergar onde uma estrutura de opções ganha ou perde no vencimento. O problema começa quando um desenho limpo parece mais preciso do que os dados usados para construí-lo. Um strike lido errado, um prêmio estimado, um multiplicador inadequado ou uma volatilidade genérica pode transformar uma visualização educativa em uma falsa sensação de controle.

Options Payoff orienta um agente a extrair as pernas de uma estratégia e montar um widget interativo com curva no vencimento, valor teórico, pontos de equilíbrio e controles de cenário. A proposta é útil para estudar a estrutura de uma posição. Ela não consulta uma corretora, não valida uma ordem e não substitui preço de mercado, documento de risco ou análise profissional.

O que esta Skill faz

O SKILL.md auditado descreve um fluxo em cinco partes. O agente extrai dados da posição, identifica a estratégia, calcula o payoff, constrói uma visualização interativa e resume a leitura. O widget deve mostrar duas curvas: resultado intrínseco no vencimento e valor teórico antes do vencimento.

Os controles permitem variar strikes, prêmio, quantidade, multiplicador, volatilidade implícita, dias até o vencimento, taxa livre de risco e preço do ativo. A cada mudança, o gráfico recalcula lucro máximo, perda máxima, pontos de equilíbrio e resultado teórico no preço selecionado. Isso transforma uma posição estática em um laboratório de hipóteses.

Para quem serve

A Skill serve a estudantes de derivativos, criadores de material educativo e investidores que já conhecem os termos básicos e querem visualizar como as pernas se combinam. Também pode ajudar uma equipe de conteúdo a explicar por que uma trava vertical, um straddle ou um condor de ferro reage de forma diferente ao movimento do ativo e à passagem do tempo.

Ela não é uma boa porta de entrada para quem ainda não distingue compra e venda de opção, prêmio, strike, vencimento, exercício e assignment. A Options Institute da Cboe oferece uma trilha oficial de fundamentos, enquanto a visão básica do Options Industry Council ajuda a firmar o vocabulário antes do uso de modelos.

Origem, adoção e versão

A curadoria fixou o repositório himself65/finance-skills no commit 0a5759bca1ea273790cd45c17fad6a9aff76a7f5. Na consulta de 14 de setembro de 2026, a API pública do GitHub mostrava 3.318 estrelas e 378 forks. O projeto não estava arquivado e declarava licença MIT.

O SKILL.md não informa versão própria. O commit auditado registra a release 11.0.0 do repositório. A página separa essas duas informações porque a versão do conjunto não prova que cada Skill tenha ciclo independente. O README da raiz apresenta o projeto como coleção educativa e informativa, sem aconselhamento financeiro.

Por que ela não duplica outras Skills do catálogo

O catálogo já tem Skills para análise de dados, validação de métodos e criação de visualizações, mas não havia uma peça dedicada a decompor estratégias de opções e comparar payoff no vencimento com uma curva teórica ajustável. Options Payoff não é uma Skill de seleção de ativos, previsão de preços, execução de ordens ou gestão de carteira.

A finalidade específica é mostrar a geometria econômica das pernas informadas. Mesmo assim, ela não resolve adequação, liquidez, margem, imposto, risco de contraparte, regras da corretora ou necessidade de proteção. O gráfico é uma camada explicativa, não uma decisão.

Estratégias reconhecidas

A referência de estratégias cobre butterfly, trava vertical, trava de calendário, condor de ferro, straddle, strangle, covered call, venda de put e ratio spread. Para outra combinação, o modo custom deve decompor cada perna e somar os resultados.

Essa lista não garante que qualquer descrição informal seja interpretada corretamente. Uma trava de débito e uma trava de crédito podem usar strikes semelhantes, mas invertem sinais e limites. Uma butterfly de asas quebradas mantém exposição residual. Uma calendar precisa de dois vencimentos e, em geral, duas volatilidades, portanto não cabe na mesma fórmula de uma posição com vencimento único.

Curva no vencimento e curva teórica

A curva de vencimento usa valor intrínseco e prêmio. Depois do vencimento, o tempo restante é zero e a relação entre preço do ativo e resultado pode ser calculada por trechos. Já a curva teórica tenta estimar o valor antes do vencimento com Black-Scholes, usando preço do ativo, strike, tempo, taxa e volatilidade.

A distinção é central. Um ponto acima de zero na curva teórica não é ganho garantido nem preço executável. É a saída de um modelo sob hipóteses. O próprio documento de características e riscos da OCC alerta que o investidor não deve presumir que opções serão precificadas conforme um exemplo ou fórmula.

Limites do modelo Black-Scholes

O código de referência implementa preço de call, preço de put, delta e theta. Ele trata dias ou volatilidade iguais a zero usando valor intrínseco. É uma base didática, não um motor de risco completo.

A versão auditada não modela automaticamente dividendos, curva de juros, volatilidade diferente por strike, exercício antecipado, custos, slippage, margem ou regras específicas de liquidação. Para opções americanas, o exercício antes do vencimento pode importar. Para índices liquidados financeiramente, contrato, estilo e horário de cálculo precisam ser confirmados. A orientação do OIC sobre exercício e a orientação sobre assignment mostram por que o desenho do payoff é apenas parte da posição.

Compatibilidade e pré-requisitos

O README da Skill declara funcionamento no Claude.ai por meio de show_widget ou no Claude Code em conjunto com a Skill generative-ui. O SKILL.md chama explicitamente visualize:show_widget e visualize:read_me.

No Codex ou em outro host, o arquivo pode orientar a análise, mas a renderização não é automaticamente compatível. O ambiente precisa oferecer uma ferramenta equivalente para gerar HTML interativo ou uma visualização própria. O padrão Agent Skills ajuda na descoberta do arquivo, mas não padroniza o widget citado pela origem.

Instalação segura

O comando documentado pelo mantenedor para instalar apenas a Skill é:

npx skills add himself65/finance-skills --skill options-payoff

Esse comando consulta a rede, baixa código e grava arquivos no diretório de Skills. Execute primeiro em um ambiente descartável, confira a origem e fixe o commit quando o instalador permitir. A pasta oficial fixada permite comparar exatamente os arquivos antes de adotar a versão instalada.

O download local do Bastidores é documental e não executa nada. Ele permite revisar as instruções e fórmulas, mas não instala o ecossistema do mantenedor, não fornece o widget e não adiciona dados de mercado.

Configuração dos dados de entrada

Registre cada perna em uma tabela com tipo, compra ou venda, strike, prêmio, quantidade, multiplicador, vencimento e ativo subjacente. Depois registre preço à vista, volatilidade, taxa e horário da consulta. Se os contratos tiverem vencimentos diferentes, mantenha os tempos separados.

O SKILL.md sugere defaults quando faltam informações, como prêmio 5,00, 30 dias, volatilidade de 20% e taxa de 4,3%. Esses números são exemplos da origem, não valores atuais. Em uma demonstração, marque cada um como hipótese ilustrativa. Em qualquer leitura de posição real, pare e obtenha o dado correto. Não preencha silenciosamente o que não apareceu na captura.

Primeiro uso com dados ilustrativos

Um pedido seguro pode ser escrito assim:

Crie uma visualização educativa de uma trava de alta.
Use dados totalmente ilustrativos e identifique cada hipótese.
Não consulte corretora, não use dados pessoais e não recomende operação.
Mostre separadamente payoff no vencimento e valor teórico.

O resultado esperado é uma explicação das pernas, um gráfico ajustável e uma lista clara das premissas. Antes de interpretar, confira se o sinal de cada perna está correto, se o multiplicador corresponde ao contrato e se os pontos de equilíbrio foram calculados com o prêmio líquido total.

Uso com captura de corretora

A origem permite extrair dados de uma captura de corretora. Essa imagem pode conter número da conta, nome, saldo, posição total, identificadores, horários e outras informações sensíveis. Recorte somente a área necessária e remova dados pessoais antes de fornecer o arquivo ao agente.

Mesmo após o recorte, a leitura visual pode trocar preço atual por strike, omitir o sinal de uma perna ou confundir preço médio com cotação. O SKILL.md destaca que o spot é o preço atual do ativo, não o strike. A confirmação humana deve percorrer todas as pernas antes do cálculo.

Preços e volatilidade não são detalhes

A Skill inclui uma chamada a yfinance para tentar obter uma referência do S&P 500. O projeto yfinance informa que é uma ferramenta aberta voltada a pesquisa e educação e não é afiliada ao Yahoo. Uma resposta desse caminho não deve ser tratada como feed executável de corretora.

Preço à vista, bid, ask, último negócio e marcação podem divergir. A volatilidade também varia por strike e vencimento. Para estudar uma posição real, registre a fonte, o horário e a unidade de cada entrada. Se a informação estiver indisponível, o resultado correto é declarar a lacuna, não escolher um número conveniente.

Permissões e riscos

• Leitura: o agente pode ler descrições, tabelas e imagens de posição. Faça a sanitização antes do envio.
• Rede: a consulta de preço proposta usa yfinance. Trate-a como opcional e verifique a fonte e o horário.
• Execução: a instalação com npx baixa e executa um pacote. Revise o destino e a versão antes de autorizar.
• Escrita: o host pode criar HTML, imagens ou arquivos de apoio. Escolha uma pasta de saída e confira o conteúdo.
• Financeiro: nenhuma etapa deve abrir corretora, enviar ordem, alterar posição, movimentar dinheiro ou recomendar uma operação.
• Modelo: uma curva teoricamente correta ainda pode ser inadequada para o contrato, mercado e momento usados.

A página Leverage & Risk do OIC lembra que uma posição vendida sem cobertura pode ter risco muito diferente de uma estrutura limitada. Confirme a exposição econômica, não apenas o formato visual.

Erros comuns e como corrigir

A curva parece invertida: revise compra e venda de cada perna, prêmio pago ou recebido e sinal da posição. Não corrija o gráfico apenas trocando cores.

O ponto de equilíbrio não bate com a corretora: confirme prêmio líquido, multiplicador, quantidade, custos e unidade. Uma corretora pode incluir taxas ou convenções que o modelo simples não inclui.

A calendar mostra lucro máximo exato: trate isso como sinal de excesso de certeza. O valor perto do vencimento curto depende da volatilidade da perna longa e de outras premissas. A referência fornece uma aproximação, não uma garantia.

O gráfico usa preço atual igual ao strike: substitua pelo spot confirmado. A origem alerta explicitamente contra esse default.

O widget não abre no Codex: o host pode não oferecer show_widget. Use uma ferramenta de visualização compatível ou gere um HTML local revisável, sem afirmar compatibilidade nativa.

Uma estratégia não está na lista: decomponha cada perna no modo custom e teste valores extremos do ativo. Não force o nome de uma estratégia parecida.

Resultado esperado e validação

O resultado esperado contém tabela de pernas, premissas, duas curvas claramente nomeadas, controles com unidades, estatísticas recalculadas e aviso educativo. Teste pelo menos um ponto abaixo de todos os strikes, um em cada intervalo, um acima de todos os strikes e o próprio vencimento.

Compare a curva de vencimento com cálculo manual simples. Depois altere uma entrada por vez. Se o prêmio sobe, a curva deve refletir o novo custo ou crédito. Se os dias chegam a zero, a curva teórica deve convergir para o valor intrínseco. Essa checagem não valida o mercado, mas detecta erros básicos de implementação.

Versão, licença e pacote auditado

O pacote local contém seis arquivos textuais: SKILL.md, README.md, duas referências Markdown, LICENSE e ORIGEM.md. Seu SHA-256 é f9d1f8d575f16dd79a1ad328ccb65fa17beac6abab76808e4ca61c6e156b792e. Os cinco arquivos da origem preservam os bytes públicos do commit fixado; o registro de procedência foi acrescentado pelo Bastidores.

A licença MIT permite redistribuição sob suas condições, e o aviso foi mantido. Licença aberta não significa que dados de mercado, capturas de corretora, marcas ou conteúdo de terceiros possam ser redistribuídos.

Limites do download local

O ZIP não inclui yfinance, Python, navegador, corretora, feed de mercado, API, widget pronto, Chart.js, plugin completo, outras Skills, scripts, executáveis, dependências, credenciais, imagens de contas, posições, ordens, relatórios ou dados pessoais.

Ele é suficiente para auditar a lógica documental, as fórmulas de referência e os limites declarados. Para instalação funcional, use a origem oficial, revise o pacote recebido e confirme se o host oferece a ferramenta de visualização necessária. O botão do repositório oficial permanece separado do download local.

Checklist antes de usar

1. Confirme contrato, estilo, vencimento e multiplicador de cada perna.
2. Remova dados pessoais de qualquer captura.
3. Registre fonte e horário do spot, prêmio, volatilidade e taxa.
4. Não substitua dado ausente por default sem rotulá-lo como exemplo.
5. Separe payoff no vencimento de valor teórico antes do vencimento.
6. Teste pontos extremos e intervalos entre strikes.
7. Considere custos, liquidez, exercício, assignment e margem fora do gráfico.
8. Não conecte corretora nem execute ordem a partir desta Skill.
9. Leia o documento vigente da OCC antes de operar opções.

Fontes oficiais consultadas

• Repositório oficial finance-skills.
• Pasta Options Payoff no commit auditado.
• SKILL.md auditado.
• README da Skill.
• Fórmulas e estratégias da origem.
• Implementação Black-Scholes de referência.
• Licença MIT.
• OCC, documento vigente de características e riscos.
• Cboe Options Institute.
• OIC, fundamentos de opções.
• OIC, alavancagem e risco.
• OIC, exercício de opções.
• OIC, assignment.
• Cboe, fatos e ferramentas educativas sobre opções.
• Documentação do projeto yfinance.
• Especificação Agent Skills.

Se você quer estudar uma estrutura antes de levá-la a uma plataforma financeira, consulte o catálogo de Skills do Bastidores da IA. Use Options Payoff como quadro de hipóteses, confirme cada entrada e mantenha qualquer decisão ou operação fora do fluxo automático.