Communitygithub.com

KorroAi/oddly

**Vantagens estruturais que instituições não conseguem alcançar. Protegido com severidade máxima.**

O que é oddly?

O `/oddly` é uma skill avançada para agentes de IA (como Claude Code) projetada para identificar oportunidades de arbitragem em situações especiais no mercado de ações dos EUA, focando em ofertas de compra de ações com lotes ímpares (odd-lot tender offers), spin-offs e direitos de subscrição. Diferente de robôs automatizados, o usuário executa o comando manualmente quando desejar (semanalmente, mensalmente), e o scanner busca oportunidades ativas com janelas de retrospectiva de 45 a 90 dias. A skill emprega um rigoroso sistema de 11 portões de validação (Gate 0 + 10 portões de severidade), onde cada oportunidade deve passar por todas as etapas — desde a verificação de que a oferta ainda está ativa até a explicação em duas frases para o avô. Se qualquer portão falhar, a oportunidade é rejeitada. O resultado é apresentado em um formato visual claro, mostrando apenas as oportunidades que passaram em todos os testes, com citações diretas dos documentos da SEC. É ideal para pequenos investidores que buscam retornos consistentes e de baixo risco, com expectativa de apenas 2 a 6 sinais por ano.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add KorroAi/oddly

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

/oddly — Arbitragem de Situações Especiais com IA

Vantagens estruturais que instituições não conseguem alcançar. Protegido com severidade máxima.

Como Usar

Você não executa um daemon. Não define um cron. Você abre o Claude Code e digita /oddly sempre que pensar — uma vez por semana, uma vez por mês, tanto faz. O scanner busca tempo suficiente para capturar o que você perdeu:

  • Ofertas de compra (tender offers): 45 dias de retrospectiva (prazos curtos)
  • Spin-offs: 90 dias de retrospectiva (arquivados meses antes da data do spin-off)
  • Direitos de subscrição (rights offerings): 60 dias de retrospectiva (janela moderada)

Nenhuma oportunidade fica obsoleta porque o Gate 0 elimina qualquer coisa já expirada.

Os 11 Portões (Gate 0 + 10 Portões de Severidade)

Gate 0: AINDA ATIVO? — ANTES de todos os outros portões

Esta oportunidade ainda é acionável AGORA?

  • Prazo da oferta expirou? → REJEITADO. Nem leia o documento.
  • Spin-off já concluído? → REJEITADO.
  • Subscrição de direitos encerrada? → REJEITADO.

Este portão é executado automaticamente. Se falhar, a oportunidade não chega à avaliação da IA.

G1: PROVISÃO DE LOTE ÍMPAR — EXPLÍCITA no texto do documento
    A IA DEVE citar a frase exata do documento da SEC.
    "Achamos que pode haver" = REJEITADO.
    Nenhuma linguagem de lote ímpar encontrada = REJEITADO.
    Este portão é BINÁRIO. Passa ou falha. Sem pontuação.

G2: TUDO EM DINHEIRO — Sem troca de ações, sem "sujeito a financiamento"
    A contraprestação da oferta deve ser 100% em dinheiro.
    "Sujeito a financiamento" ou "condição de financiamento" = REJEITADO.
    Troca de ações, mistura de ações+dinheiro = REJEITADO.
    Deve citar a cláusula de contraprestação em dinheiro do documento.

G3: ACESSÍVEL — 99 ações ≤ 50% do capital do usuário
    capital_do_usuário × 0,5 ÷ 99 = preço máximo da ação.
    Com $500 de capital: máximo $2,50/ação.
    Com $1.000: máximo $5,05/ação.
    Com $5.000: máximo $25,25/ação.
    Ação acima do limite = REJEITADO. Sem preenchimento parcial.
    Isso é MATEMÁTICA, não julgamento.

G4: PRÊMIO ≥ 10% — Sobre o preço de mercado atual
    (preço_da_oferta - preço_atual) / preço_atual × 100 ≥ 10.
    Abaixo de 10% = REJEITADO. Sem exceções.
    Isso considera spread, movimento adverso de preço, risco do negócio.
    A 8%: "quase, mas não" = REJEITADO.

G5: PRAZO ≤ 60 DIAS a partir de hoje
    O bloqueio de capital é um custo real para uma conta pequena.
    61+ dias = REJEITADO.
    Calcule o retorno anualizado: prêmio ÷ (dias/365).

G6: LISTADA — NYSE ou NASDAQ apenas
    Sem OTC (OTCQX, OTCQB, Pink Sheets).
    Sem bolsas estrangeiras (TSX, LSE, etc.).
    Deve ser comprável em corretora padrão dos EUA.
    Verifique via yfinance: ticker.info["exchange"] deve conter "Nasdaq" ou "NYSE".

G7: RISCO DO NEGÓCIO — 2 cenários específicos de fracasso ESCRITOS
    A IA deve escrever 2 cenários CONCRETOS onde este negócio falha.
    Não genérico ("risco de mercado"). ESPECÍFICO:
    "Antitruste: negócio ultrapassa o limite HSR e DOJ questiona"
    "Voto de acionistas: investidor ativista se opõe, possui 15%"
    Se a IA não consegue pensar em 2 riscos específicos → não entende o negócio → REJEITADO.

G8: PREÇO VERIFICADO — Preço da oferta citado do texto do documento
    O parser automático dá uma DICA. A IA CONFIRMA.
    A IA deve citar: "Documento afirma: '$X,XX por ação em dinheiro'"
    Preço do parser ≠ preço verificado pela IA → REJEITADO.
    Não consegue encontrar o preço no documento → REJEITADO.

G9: SEM BANDEIRAS VERMELHAS — Verificar antes da entrada
    Alguma venda de insider nos últimos 30 dias? (verificar OpenInsider ou Formulário 4 da SEC)
    Algum litígio pendente contra o negócio?
    Alguma atividade incomum em opções?
    Algum aviso de continuidade de negócios para a empresa?
    UMA bandeira vermelha → discutir com o usuário, padrão REJEITADO.

G10: TESTE DA AVÓ — Explicar em 2 frases
    "A Empresa X oferece recomprar ações a $Y/ação."
    "Você compra a preço de mercado $Z (<$Y) porque possui <100 ações."
    "Você tem garantia de $Y. Lucro = $Lucro em ~30 dias."
    Se levar mais de 2 frases → muito complexo → REJEITADO.

Comandos

  • /oddly ou /oddly scan — Varredura completa de múltiplas estratégias de situações especiais
  • /oddly portfolio — Visualizar posições, prazos, lucro esperado
  • /oddly setup — Configurar capital e preferências

Protocolo de Varredura — /oddly

Passo 1: Buscar Oportunidades (Ofertas + Spin-offs)

python -c "
from oddly import scan_opportunities, load_config
cfg = load_config()
opps = scan_opportunities()
print(f'ENCONTRADAS|{len(opps)}')
for o in opps:
    print(f'OPP|{o.symbol}|{o.strategy}|{o.company_name}|{o.filing_type}|{o.filing_date}|{o.current_price}|{o.target_price}|{o.premium_pct}|{o.odd_lot_shares}|{o.still_active}|{o.deadline}|{o.filing_url}')
"

Passo 2: Ler Cada Documento

Para cada oferta encontrada, baixar e ler o documento real da SEC:

python -c "
import requests
url = '<filing_url>'.replace('-index.htm', '.txt').replace('-index.html', '.txt')
resp = requests.get(url, headers={'User-Agent': 'Oddly/1.0 (github.com/KorroAi/oddly)'})
print(resp.text[:15000])
"

Passo 3: Aplicar 10 Portões

Para cada oferta, aplicar TODOS os 10 portões em ordem. Se QUALQUER portão falhar → REJEITADO. Parar e passar para a próxima oferta.

G1 — Pesquisar no documento por linguagem de lote ímpar. Citar a frase. G2 — Pesquisar por "dinheiro", "condição de financiamento", "contraprestação em ações". G3 — Calcular: capital_do_usuário × 0,5 ÷ 99. Comparar com o preço da ação. G4 — Calcular prêmio. Deve ser ≥ 10%. G5 — Encontrar data de expiração. Deve ser ≤ 60 dias a partir de hoje. G6 — Verificar bolsa via yfinance. G7 — Escrever 2 cenários específicos de fracasso. G8 — Citar o preço da oferta do texto do documento. G9 — Varredura rápida por bandeiras vermelhas. G10 — Escrever a explicação em 2 frases.

Passo 4: Saída

Apresentar apenas os sinais que PASSARAM EM TODOS OS 10 PORTÕES:

╔══════════════════════════════════════════╗
║  OFERTA DE LOTE ÍMPAR: [SÍMBOLO] — [Empresa] ║
╠══════════════════════════════════════════╣
║  Preço da Oferta:   $X,XX (VERIFICADO)      ║
║  Preço Atual:  $X,XX                  ║
║  Prêmio:        +XX,X% ≥ 10% ✓           ║
║  Lote Ímpar:        ≤99 ações GARANTIDO  ║
║  Prazo:       [Data] (X dias)        ║
║  Comprar:            99 ações @ $X,XX      ║
║  Custo:           $XXX,XX                ║
║  Lucro Esperado: $XX,XX                 ║
║  ─────────────────────────────────────  ║
║  G1 Lote Ímpar:   ✓ "[citação do documento]" ║
║  G2 Tudo em Dinheiro:  ✓ "[citação do documento]" ║
║  G3 Acessível:    ✓ $X ≤ $max             ║
║  G4 Prêmio:   ✓ XX% ≥ 10%            ║
║  G5 Prazo:  ✓ X dias ≤ 60          ║
║  G6 Listada:    ✓ NASDAQ/NYSE          ║
║  G7 Risco do Negócio: ✓ [risco 1], [risco 2]   ║
║  G8 Verificado:  ✓ "[citação exata do preço]"║
║  G9 Sem Bandeiras:  ✓ Limpo                ║
║  G10 Explicar:  "[resumo em 2 frases]"  ║
║  ─────────────────────────────────────  ║
║  VEREDICTO: APROVADO — 10/10 portões      ║
╚══════════════════════════════════════════╝

Se NENHUMA oportunidade passar em todos os portões:

SEM SINAIS — 0/[N] ofertas passaram em todos os 10 portões.
Isso é NORMAL. Oportunidades reais de lote ímpar são 2-4/ano.
Rejeitadas: [listar cada oferta com qual portão falhou]

Passo 5: Se um Sinal Passar — O que o Usuário Faz

Quando um documento passa em TODOS os portões, apresentar a oportunidade E estes passos concretos:

  1. "Abra sua corretora (Fidelity, Schwab, Vanguard, IBKR, E*TRADE) e compre [N] ações de [SÍMBOLO] a preço de mercado. Isso é uma compra de ações normal. Nada especial."
  2. "Registre: oddly buy [SÍMBOLO] [preço] [ações] [preço_da_oferta] --deadline [data]"
  3. "Após comprar, encontre a oferta de compra na seção de Ações Corporativas da sua corretora. Se não aparecer em 2-3 dias, ligue para sua corretora e diga: 'Eu possuo ações de [SÍMBOLO]. Há uma oferta de compra ativa a $[PREÇO]. Quero participar.'"
  4. "Suas ações serão vendidas ao preço da oferta quando a oferta for encerrada. Registre: oddly sell [SÍMBOLO] [preço_de_saída] --reason tendered"

Explique também:

  • 99 ações é o máximo, mas qualquer quantidade de 1 a 99 se qualifica
  • A provisão de lote ímpar diz "menos de 100 ações" — todos os detentores de lote ímpar têm prioridade
  • Comprar menos ações reduz tanto o custo quanto o lucro proporcionalmente
  • Nenhuma corretora ou plataforma especial é necessária — qualquer corretora padrão funciona
  • A corretora é legalmente obrigada a processar solicitações de oferta de acionistas

Portfólio — /oddly portfolio

Mostrar posições com: preço atual vs. oferta, dias até o prazo, lucro esperado.

Princípios

  1. Perfeição ou nada. 11/11 portões (Gate 0 + 10 de severidade) ou nenhuma negociação.
  2. Verificável, não baseado em opinião. Citar texto do documento, não "acho que".
  3. Honestidade. Zero sinais = diga com orgulho. O sistema funciona.
  4. Você executa /oddly quando quiser. Sem daemon. Sem cron. A varredura captura o que você perdeu.
  5. 1-6 sinais/ano. Cada um matematicamente positivo. Esse é o jogo.
  6. Inglês apenas.

Habilidades Relacionadas