COT Institutional Flow LAB [Open]

Description
The COT Institutional Flow LAB [Open] is a specialized Fundamental Analysis suite designed to decode the "Smart Money" positioning using official legacy data from the CFTC's Commitment of Traders report.

By releasing this script as an Open-Source tool, traders and developers can study how to integrate complex external fundamental data (LibraryCOT) into Pine Script, build dynamic grid systems, and create adaptive visual scaling engines.

Underlying Concepts & Methodology
The script processes raw contract data, focusing on the interplay between three key market participants:

Commercials (Hedgers): The "Smart Money" producers/users. They often act as a mean-reverting force against extremes.

Large Speculators (Funds): Trend-following managed money.

Small Speculators (Retail): Non-reportable traders, often used as a contrarian indicator at extremes.

Key Features

Auto-Zoom Engine: A proprietary algorithm that dynamically scales Retail (Small Speculators) data. Since retail volume is often negligible compared to institutions, this feature amplifies their visual footprint to make their sentiment readable without distorting the main institutional data.

Translator Dashboard: A built-in HUD that interprets raw data into actionable signals (Micro Flow, Macro Trend, and Net Positioning).

Dynamic Grid System: Unlike static levels, the background grid adapts to historical volatility, highlighting extreme statistical overbought/oversold conditions (Index Mode 0-100).

How to Use

Trend Confirmation: Look for alignment between Price Trend and Large Speculators.

Reversal Setup: Watch for extreme divergence where Price makes a new High but Commercials aggressively sell.

[English Translation of User Interface]

To comply with House Rules regarding non-English UI, here is the translation of the script's settings menu:

1. Modo de Exibição (Display Mode)

Contratos Brutos / Índice = Raw Contracts / Index (0-100)

Estilo da Grade = Grid Style (Dynamic/Static)

2. Visual e Filtros (Visuals & Filters)

Auto-Zoom no Varejo? = Auto-Zoom Retail?

Força do Zoom = Zoom Strength

Mostrar Comerciais/Espec. = Show Commercials/Specs

Ocultar Semana Atual = Hide Current Week (Anti-Repaint)

Destacar Extremos = Highlight Extremes (Background)

Mostrar Data de Referência = Show Reference Date

3. Referência de Tempo (Time Reference)

Ativar Linhas (13/26/52/156) = Enable Vertical Lines (Quarterly/Yearly/3-Year)

Cor/Espessura/Estilo = Color/Width/Style

4. Painel Tradutor (Translator Panel)

Ativar Painel = Enable Dashboard

Tamanho/Posição = Size/Position

Usar Tema Claro = Use Light Theme

5. Parâmetros & Limiares (Params & Thresholds)

Período (Semanas) = Lookback Period (Weeks)

Limiar Superior/Inferior = Upper/Lower Threshold (%)

6. Guia Educativo (Educational Guide)

(Tooltips Only) = Contextual learning tooltips.

[Português]

Descrição
O causador de discórdia agora é Open-Source! O COT Institutional Flow LAB é uma ferramenta de análise de fluxo institucional que traduz os dados brutos do relatório COT (CFTC) em sinais visuais. Ele permite identificar quando os "Donos do Mercado" (Comerciais) estão se posicionando contra ou a favor da tendência.

Funcionalidades

Auto-Zoom Inteligente: Amplia automaticamente a linha do varejo para que ela seja legível frente ao volume massivo dos bancos.

Painel Tático: Resume a leitura de Micro e Macro tendência em tempo real.

Código Aberto: Estude a integração de dados fundamentalistas do CFTC direto no seu gráfico.