📊 COT Indicator History Pro — Fluxo do Ator + Direção (Institucional / Hedgers / Varejo)

CotIndicatorHistoryPro traz uma leitura avançada dos Compromissos dos Traders (COT) diretamente no seu gráfico, com uma divisão clara por participantes do mercado (Institucional, Hedgers/Comercial, Varejo).

Mostra não apenas onde cada ator está posicionado (predominantemente comprado/vendido), mas também o que eles estão fazendo agora (aumentando posições compradas ou vendidas), além de uma linha sintética de Direção para destacar o viés predominante.

O indicador carrega seu conjunto de dados de um feed JSON seguro (HISTÓRICO + SAÍDA) e o alinha com segurança no gráfico (opção anti-lookahead usando PublicationDate).

🗓️ Atualização Semanal de Dados (sexta-feira 21:00)

O conjunto de dados COT é atualizado toda sexta-feira às 21:00 (horário Europa/Roma) graças a um pipeline de automação dedicado:
um script sofisticado de processamento realiza os cálculos e publica os valores atualizados no feed JSON usado pelo indicador (e pelo ecossistema cBot relacionado, se instalado).

✅ O próprio indicador atualiza na plataforma usando sua configuração de Segundos de Atualização e exibirá os novos dados semanais assim que forem publicados.

✅ O Que Você Recebe (Linhas + Painel)

🔥 Linhas de “Fluxo” (3 Atores) — ΔNet/OI%

Essas linhas representam a mudança semana a semana nas posições líquidas, normalizada pelo Interesse em Aberto:

• 🔵 Fluxo Institucional (ΔNet/OI%)
• 🟡 Fluxo de Hedgers / Comercial (ΔNet/OI%)
• 💗 Fluxo de Varejo (ΔNet/OI%)

📌 Como ler:

• Acima de 0 ⇒ o ator está aumentando o LONG líquido (adicionando posições compradas e/ou cobrindo vendidas)
• Abaixo de 0 ⇒ o ator está aumentando o SHORT líquido (adicionando posições vendidas e/ou reduzindo compradas)
• Valores absolutos maiores (ex.: ±1,5%, ±3%) ⇒ mudanças de posicionamento mais fortes e significativas

🧭 Linha de “Direção” — Viés Especulativo Net/OI%

• ⚪ Direção (Viés Especulativo) Net/OI% resume a direção “especulativa” predominante (média de Institucional + Varejo, com fallback se necessário).

📌 Como ler:

• > 0 ⇒ Viés especulativo LONG
• < 0 ⇒ Viés especulativo SHORT
• ≈ 0 ⇒ fase NEUTRA / sem viés

🧩 Painel de Informações (Contexto Completo)

Um painel embutido exibe:

• 📄 Data do Relatório / Data de Publicação
• 📌 Interesse em Aberto + Mudança Semanal (WoW) (week-over-week)
• 🎯 Sinal de texto (se disponível na SAÍDA)
• Para cada ator:
• • Viés (predominantemente LONG / SHORT / NEUTRO) baseado no Net
  • Net/OI%
  • Fluxo (ΔNet/OI%)
  • WoW ΔLong / ΔShort / ΔNet para entender como a posição mudou

🧠 Como Ler (Simples & Prático)

✅ Fluxo vs Viés (Diferença Chave)

• Fluxo = o que eles estão fazendo agora (adicionando posições compradas ou vendidas)
• Viés = como eles estão posicionados no geral (predominantemente comprado ou vendido)

Exemplo:

• Institucional Viés LONG + Fluxo positivo ⇒ eles ainda estão aumentando posições compradas
• Institucional Viés LONG + Fluxo negativo ⇒ redução de posições compradas / possível rotação

🚦 Cenários Típicos de Negociação

✅ Cenário A — Confirmação de Tendência

• Direção > 0
• Fluxo Institucional > 0
  ➡️ A pressão compradora é consistente: frequentemente um setup de continuação.

✅ Cenário B — Potencial Reversão (Smart Money vs Varejo)

• Fluxo Institucional > 0 enquanto o Fluxo de Varejo < 0
  ➡️ Varejo vende/short enquanto instituições compram: possível acumulação.
  (O oposto = possível distribuição)

✅ Cenário C — Hedgers como “Alerta”

• Hedgers em níveis extremos (Net/OI longe do neutro) + Fluxo forte
  ➡️ Possível zona de excesso / hedge agressivo (frequentemente melhor como aviso do que como gatilho direto de entrada).

✅ Cenário D — Mercado “Carregando” (Risco de Breakout)

• Fluxo forte + Interesse em Aberto WoW em alta
  ➡️ Novas posições estão entrando: a probabilidade de movimentos estendidos frequentemente aumenta.

⚡ Rotina de Leitura de 10 Segundos

1. Verifique a Direção: LONG (>0) ou SHORT (<0)
2. Verifique o Fluxo Institucional: confirma ou diverge?
3. Verifique o Fluxo de Varejo: confirma ou faz o oposto?
4. Verifique o Interesse em Aberto WoW: expansão ou redução de posições?

✅ Símbolos Suportados + Legenda Principal (Chaves de Símbolo JSON)

O indicador pode analisar qualquer instrumento disponível no feed JSON (campo data[].symbol na SAÍDA).

Como selecionar o instrumento correto

• Chave de Símbolo Externa = AUTO 👉 usa automaticamente o símbolo do gráfico (e remove qualquer sufixo após “.”, ex.: US2000.ecn → US2000).
• Se seu corretor usa nomes de símbolos diferentes 👉 defina Chave de Símbolo Externa para a chave JSON exata (case-insensitive).

Chaves atuais no feed (exemplo de snapshot: reportDate 2026-02-17, publicationDate 2026-02-20)

• FX: AUDUSD, EURUSD, GBPUSD, USDMXN
• Índices: US100, US2000, DOW30, VIX
• Commodities/Metais/Agricultura: BRENT, WTI, COPPER, CORN, WHEAT, XAU (Ouro), XAG (Prata)
• Cripto: BTC, ETH

📌 Se você não vê valores no gráfico:

1. verifique se o símbolo do gráfico corresponde a uma chave JSON
2. defina Chave de Símbolo Externa manualmente (ex.: ETH, US2000)
3. verifique o painel Data do Relatório/Data de Publicação para confirmar o carregamento do conjunto de dados mais recente

⚙️ Notas

• Suporta alinhamento mais seguro com Usar PublicationDate (anti-lookahead) ✅
• Linhas e painel podem ser ativados/desativados individualmente.

📌 Aviso Legal: indicador apenas informativo, não é aconselhamento financeiro. Dados COT são semanais e devem ser contextualizados com tendência, níveis-chave e volatilidade.