ICT Liquidity Levels

Visão Geral

Este indicador mapeia os Níveis de Liquidez ICT (Inner Circle Trader) — as ordens de stop-loss repousadas que se acumulam acima dos máximos de swing e abaixo dos mínimos de swing. Ele detecta Liquidez do Lado Comprador (BSL), Liquidez do Lado Vendedor (SSL), Máximas Iguais (EQH), Mínimas Iguais (EQL) e Varreduras de Liquidez (Turtle Soup), com suporte completo de Timeframe Superior (HTF) para confluência multi-timeframe. Os níveis se estendem em tempo real, os rótulos exibem o preço exato, e os níveis varridos são marcados e invalidados automaticamente.

Conceitos-Chave

• Liquidez do Lado Comprador (BSL) — Ordens de stop de compra repousadas acima dos máximos de swing. Quando traders colocam stops de perda acima dos máximos de swing ou definem entradas com stop de compra, eles criam um pool de liquidez que os players institucionais visam. Desenhada como uma linha horizontal no preço do máximo de swing.
• Liquidez do Lado Vendedor (SSL) — Ordens de stop de venda repousadas abaixo dos mínimos de swing. Stops de perda abaixo dos mínimos de swing e entradas com stop de venda criam um pool de liquidez que o smart money caça. Desenhada como uma linha horizontal no preço do mínimo de swing.
• Máximas Iguais (EQH) — Quando dois ou mais máximos de swing se formam aproximadamente no mesmo preço, um pool concentrado de BSL se acumula. Os market makers veem esse padrão de topo duplo/triplo como um ímã — os stops agrupados acima representam um alvo de liquidez de alto valor.
• Mínimas Iguais (EQL) — Quando dois ou mais mínimos de swing se alinham no mesmo preço, um pool concentrado de SSL se forma abaixo. Esse padrão de fundo duplo/triplo atrai caças a stops institucionais.
• Varredura de Liquidez (Turtle Soup) — Quando a sombra do preço ultrapassa um nível de liquidez mas o fechamento volta para dentro, as ordens de stop foram acionadas (varridas) sem um rompimento estrutural genuíno. Esta "caça aos stops" — também conhecida como Turtle Soup — é um clássico sinal de reversão ICT.
• Liquidez de Timeframe Superior (HTF) — Níveis de liquidez de timeframes superiores carregam mais significância porque representam pools maiores de ordens repousadas. O indicador plota níveis HTF juntamente com os níveis do timeframe atual para análise de confluência.

Como Funciona

1. Detecção de Swing O indicador usa ta.pivothigh e ta.pivotlow com um parâmetro configurável de Comprimento do Swing. Um máximo de swing é confirmado quando a máxima é maior que as barras adjacentes em ambos os lados; um mínimo de swing é confirmado quando a mínima é menor. Cada swing confirmado cria um novo nível de liquidez. 2. Máximas Iguais / Mínimas Iguais Quando um novo máximo de swing se forma dentro de uma tolerância (padrão 0,05%) de um nível BSL existente, ambos os níveis são classificados como Máximas Iguais (EQH). O nível existente é atualizado — sua cor muda para a cor EQH e a largura da linha aumenta. A mesma lógica se aplica a Mínimas Iguais (EQL). Este pareamento baseado em tolerância leva em conta variações naturais de preço que ainda representam o mesmo pool de liquidez institucional. 3. Detecção de Varredura de Liquidez A detecção de varredura funciona independentemente das configurações de exibição (detecção desacoplada). Em cada barra, o indicador verifica cada nível ativo:

• Varredura BSL: A máxima penetra acima do nível mas o fechamento permanece abaixo — os stops de compra foram acionados.
• Varredura SSL: A mínima penetra abaixo do nível mas o fechamento permanece acima — os stops de venda foram acionados.

Quando uma varredura é detectada:

• Um marcador itálico 𝘅 aparece no ponto da varredura.
• A linha desbota para cinza (pontilhada, largura 1) indicando que o nível foi atacado.
• Um alerta é disparado (se habilitado) com "[HTF] BSL/SSL Swept" incluindo preço e símbolo.

4. Invalidação de Nível Um nível é removido do gráfico quando o preço fecha além dele — seja através de uma varredura que continua, ou um rompimento direto. Isso evita que níveis obsoletos poluam o gráfico. A verificação de invalidação é executada a cada barra após a detecção de varredura, garantindo que um nível varrido na barra N seja removido se a barra N+1 fechar além dele. 5. Níveis de Timeframe Superior (HTF) Quando habilitado, o indicador busca máximos e mínimos de swing de um timeframe superior definido pelo usuário usando request.security. Níveis HTF são desenhados com linhas tracejadas, largura aumentada e cores opacas para distingui-los visualmente dos níveis do timeframe atual. Um sistema interno de prevenção de sobreposição garante que quando um nível HTF e um nível do timeframe atual existem no mesmo preço, apenas o nível HTF é mostrado — prevenindo duplicação visual. O módulo HTF valida que o timeframe selecionado é realmente superior ao timeframe do gráfico; caso contrário, nenhum nível HTF é criado. 6. Limite de Exibição por Tipo A entrada "Máx. Níveis (por tipo)" controla quantos níveis são mostrados para cada uma das quatro categorias independentemente: LTF BSL, LTF SSL, HTF BSL e HTF SSL. Quando uma categoria excede o limite, os níveis mais antigos são removidos primeiro — mantendo o gráfico focado na liquidez mais recente.

Características

• Detecção BSL / SSL — Identificação automática de liquidez do lado comprador e vendedor em máximos e mínimos de swing confirmados.
• Máximas Iguais / Mínimas Iguais — Pareamento baseado em tolerância detecta pools de liquidez concentrados onde múltiplos swings se alinham no mesmo preço. Níveis EQH/EQL recebem cores distintas e largura de linha aumentada.
• Varredura de Liquidez (Turtle Soup) — Detecção em tempo real de caças a stops: sombra além + fechamento dentro. Marcador itálico 𝘅 no ponto da varredura, linha desbota para cinza.
• Detecção / Exibição Desacoplada — A detecção de varredura sempre executa independentemente do botão "Mostrar Varreduras". Desligar a visual não desativa a lógica subjacente ou os alertas.
• Níveis de Timeframe Superior — Busca dados de swing HTF via request.security para confluência multi-timeframe. Níveis HTF mostrados com linhas tracejadas, cores opacas e largura aumentada.
• Prevenção de Sobreposição HTF-LTF — Quando ambos os timeframes têm um nível no mesmo preço, apenas o nível HTF é exibido. Verificação bidirecional previne duplicação.
• Invalidação Automática de Nível — Níveis são removidos quando o preço fecha além deles (continuação de varredura ou rompimento direto). Nenhum nível obsoleto permanece no gráfico.
• Rótulos Alinhados à Direita com Preço — Rótulos limpos de texto plano (sem balão) exibem "BSL 105.50", "HTF EQH 106.20" etc., reposicionados para a borda direita a cada barra.
• Limites de Exibição por Tipo — Limites independentes para LTF BSL, LTF SSL, HTF BSL e HTF SSL. Níveis mais antigos removidos primeiro.
• Personalização Completa de Cores — Cores separadas para BSL, SSL, EQH, EQL, Marcador de Varredura, HTF BSL e HTF SSL.
• Sistema de Alertas — Três alertas configuráveis: Novo Nível de Liquidez, Varredura de Liquidez e Nova Máxima/Mínima Igual. Cada um inclui prefixo HTF quando aplicável, preço, símbolo e timeframe.

Como Usar

• Identificar Alvos de Liquidez: Níveis BSL acima dos máximos de swing e níveis SSL abaixo dos mínimos de swing mostram onde as ordens de stop estão repousadas. O preço é atraído para esses pools — use-os como alvos direcionais.
• Máximas / Mínimas Iguais como Ímãs: Zonas EQH e EQL representam liquidez concentrada. Quando o preço se aproxima de um nível EQH/EQL, espere uma tentativa de varredura. Estes são alvos de caça a stops de alta probabilidade.
• Reversão Turtle Soup: Quando um marcador de varredura (𝘅) aparece, sinaliza que a liquidez foi tomada mas o preço rejeitou o rompimento. Esta é uma configuração clássica de reversão — busque confirmação de Order Blocks, FVGs ou mudanças na estrutura de mercado.
• Confluência HTF: Habilite níveis HTF para ver onde a liquidez de timeframe maior está posicionada. Quando um nível HTF e LTF se alinham (ou estão próximos), o pool de liquidez é mais significativo. Varreduras HTF carregam implicações de reversão mais fortes.
• Combine com Ferramentas ICT: Níveis de liquidez funcionam melhor junto com Order Blocks (onde as instituições colocaram ordens), Fair Value Gaps (onde o preço quer se reequilibrar) e Estrutura de Mercado (BOS/CHoCH para direção da tendência). Uma varredura em um Order Block dentro de um FVG é uma entrada ICT clássica.
• Ajuste do Comprimento do Swing: Aumente o Comprimento do Swing para detectar apenas pontos de swing principais (menos níveis, mais significativos). Diminua para um mapeamento de liquidez mais granular em timeframes menores.

Limitações

• A detecção de swing usa ta.pivothigh/ta.pivotlow, que requer que um número de barras igual ao Comprimento do Swing passe antes da confirmação. Os níveis aparecem com um atraso igual ao Comprimento do Swing.
• Os dados HTF são buscados via request.security. Se o HTF selecionado não for superior ao timeframe do gráfico, nenhum nível HTF é criado. O indicador valida isso automaticamente.
• A detecção de Máximas/Mínimas Iguais usa uma tolerância percentual. Em instrumentos de preço muito baixo, o padrão de 0,05% pode precisar de ajuste.
• A detecção de varredura verifica sombra vs. fechamento na mesma barra. Padrões de varredura multi-bar (sombra na barra 1, fechamento de volta na barra 2) não são detectados — apenas varreduras de barra única correspondem à definição clássica de Turtle Soup.
• Este indicador mapeia onde a liquidez está repousada e quando ela é varrida — ele não gera sinais de compra/venda. Combine com Order Blocks, Fair Value Gaps, análise de estrutura de mercado e gerenciamento de risco adequado para configurações de trade completas.