Phoenix Range Detector

Sobre

O Phoenix Range Detector encontra trechos calmos num gráfico. Nesses trechos, o preço fica numa faixa estreita. Ele desenha cada um como uma caixa ou como um canal inclinado.

Para adicionar o indicador, clique em Indicadores (Indicators) no alto do gráfico no KAGAMI. Ele fica no grupo KAGAMI, com o nome Phoenix Range Detector. No gráfico, o nome dele aparece como Phoenix RD.

Este indicador ainda não está na lista de Indicadores de todas as contas.

O KAGAMI calcula os desenhos nos seus próprios servidores. Ele segue as regras do script original, que foi escrito para o TradingView.

O que você vê no gráfico

Um candle (ou barra) é um pedaço de tempo no gráfico, por exemplo 15 minutos. Uma faixa é uma sequência de candles que ficam numa banda estreita.

• Uma caixa dourada é uma faixa plana. O preço andou de lado dentro dela.
• Um canal azul-claro é uma faixa inclinada. Ele tem duas bordas azuis contínuas, com um preenchimento azul fraco entre elas.
• Uma linha vermelha tracejada passa pelo meio. Ela marca a metade.
• Duas linhas pontilhadas marcam os quartos, a um quarto e a três quartos da altura.
• Uma pequena etiqueta fica em cima, na ponta direita. Ela diz STATIC (estática) para uma caixa e DYNAMIC (dinâmica) para um canal.

A faixa mais nova cresce a cada candle que fecha. A borda direita dela anda junto com o gráfico.

Quando uma faixa termina, isto é o que muda:

• Um candle fechou acima dela: ela fica verde.
• Um candle fechou abaixo dela: ela fica vermelha.
• Ela só acabou, porque ficou longa demais ou larga demais: ela mantém a cor.
• Um canal ganha linhas tracejadas curtas. Elas levam o canal dois candles adiante.
• Uma linha fina tracejada vai para a direita a partir do topo ou da base da faixa. Ela para quando um candle fecha através dela, ou depois de 100 candles.

Só uma faixa cresce de cada vez. As faixas nunca se sobrepõem.

Como os traders costumam ler

• Muitos traders chamam um trecho de lado de faixa (range) ou de consolidação.
• Muitos traders leem o topo e a base de uma faixa como preços em que os movimentos pararam antes.
• Alguns traders observam a cor que uma faixa ganha. Ela mostra de que lado um candle fechou quando a faixa terminou.
• Alguns observam a linha tracejada depois que uma faixa termina. Eles olham se o preço volta até ela.
• Alguns usam a linha do meio. Ela mostra se o preço está na metade de cima ou na de baixo.

Um indicador só descreve preços passados. Ele não consegue prever o futuro.

As configurações

Este indicador não tem configurações para mudar. Ele sempre usa os mesmos valores fixos:

• Uma nova faixa cobre 10 candles. Uma faixa dura no máximo 150 candles.
• Uma nova faixa pode ter no máximo 2 vezes o ATR de altura.
• ATR quer dizer average true range (amplitude verdadeira média). É o tamanho médio do movimento de um candle, nos últimos 14 candles.
• Uma faixa que está crescendo pode se alargar um pouco, até 2,4 vezes o ATR.
• Uma faixa termina quando um candle fecha além da borda dela por mais de 0,15 vez o ATR.
• Cores: dourado para as caixas, azul-claro para os canais, verde e vermelho quando uma faixa termina.

Quando ele pode enganar

• Ele encontra as faixas depois que elas acontecem. Uma faixa só aparece quando 10 candles já fecharam dentro dela. Então ela começa 10 candles para trás.
• A faixa mais nova ainda pode mudar. Até ela terminar, o topo, a base, a inclinação e o tipo dela podem mudar a cada fechamento.
• Uma cor não é uma tendência. Verde ou vermelho só diz onde um candle fechou. O preço pode voltar para dentro logo depois.
• Candles grandes esticam as regras. Todos os limites seguem o ATR. Quando os candles são grandes, uma banda larga ainda conta como estreita.
• Candles pequenos apertam as regras. Quando o mercado está muito calmo, um movimento pequeno pode terminar uma faixa.
• Gaps contam como movimentos. Um salto entre candles, como o salto de uma ação de um dia para o outro, pode terminar uma faixa.
• O candle em formação é ignorado. O candle que ainda está se formando não conta até fechar.
• Os desenhos antigos podem ser diferentes. Na ponta esquerda, os desenhos podem não bater com os do TradingView. O KAGAMI pode ler menos candles passados.

Os gráficos servem para aprender. Não são conselhos. Leia nosso Aviso de Risco.

Um exemplo

Pegue NASDAQ:AAPL num gráfico de 15 minutos. Cada candle vale 15 minutos. Os números abaixo são inventados.

1. Digamos que o ATR é 0,50 e fica assim.
2. Por 10 candles, a AAPL anda de lado entre 100,00 e 100,80. A banda tem 0,80 de altura.
3. O limite é 2 × 0,50 = 1,00. A banda cabe, então aparece uma caixa dourada STATIC.
4. Mais candles fecham dentro. A caixa cresce para a direita.
5. Depois, um candle fecha em 100,90. O topo da caixa é 100,80.
6. O nível de rompimento é 100,80 + 0,15 × 0,50 = 100,875. O fechamento fica acima dele.
7. A faixa termina e a caixa fica verde. Ela termina no candle antes do rompimento.
8. Uma linha verde tracejada vai para a direita a partir da base da caixa, em 100,00.
9. Essa linha para no primeiro fechamento abaixo de 99,925, ou depois de 100 candles.

Detalhes técnicos

Esta parte dá as regras exatas, para quem quer saber. Todas as regras rodam só em candles fechados, um candle de cada vez, do candle mais antigo que o KAGAMI lê até o mais novo.

O cálculo

Os termos que as regras usam:

• Amplitude verdadeira (true range) de um candle = o maior entre high − low, |high − previous close| e |low − previous close|. No primeiro candle de todos, é high − low.
• ATR = a média de Wilder da amplitude verdadeira em 14 candles. O primeiro ATR é a média simples das primeiras 14 amplitudes verdadeiras. Depois disso, ATR = (true range + 13 × previous ATR) ÷ 14. Os primeiros 13 candles não têm ATR.
• Meio de um candle = (high + low) ÷ 2.
• Linha de ajuste = a linha reta de mínimos quadrados que passa pelos meios dos candles da faixa (fórmulas abaixo).
• Distância de cima = o maior high − fit(x) entre os candles da faixa. Distância de baixo = o menor low − fit(x) (em geral abaixo de zero). As bordas do canal são fit(x) + upper offset e fit(x) + lower offset, então elas tocam a máxima mais alta e a mínima mais baixa reais em volta da linha.
• Altura estática = a máxima mais alta − a mínima mais baixa dos candles da faixa.
• Altura dinâmica = distância de cima − distância de baixo.
• Inclinação = |slope| × (n − 1), o quanto a linha de ajuste sobe ou desce ao longo da faixa.
• Plana: inclinação ≤ 0.35 × the larger of (static height, tick size).
• Tick = o menor passo de preço. O KAGAMI usa 0,01 para ações dos EUA (0,0001 quando o último fechamento fica abaixo de 1), e uma unidade da precisão de preço do gráfico para todos os outros mercados. Ele só importa no teste de faixa plana.

A linha de ajuste: numere os candles da faixa x = 0, 1, 2 … a partir do primeiro candle dela, com y = o meio do candle e n = o número de candles. Então:

• slope = (n × Σxy − Σx × Σy) ÷ (n × Σx² − (Σx)²), ou 0 quando a parte de baixo dessa fração é 0
• start = (Σy − slope × Σx) ÷ n
• fit(x) = start + slope × x

O ATR em cada teste abaixo é o ATR do candle que está sendo avaliado.

O início de uma faixa

Em cada candle fechado, enquanto nenhuma faixa está crescendo:

1. Pelo menos 10 candles precisam vir antes deste.
2. A janela é este candle e os 9 antes dele: 10 candles. A janela precisa começar depois do último candle da faixa anterior.
3. Calcule a linha de ajuste, a altura estática e a altura dinâmica na janela.
4. A estática cabe quando a altura estática ≤ 2.0 × ATR. A dinâmica cabe quando a altura dinâmica ≤ 2.0 × ATR.
5. Quando qualquer uma cabe, uma faixa começa no primeiro candle da janela.
6. Ela é dinâmica quando a dinâmica cabe e, além disso, ou a estática não cabe, ou a janela não é plana e a altura dinâmica ≤ 0.85 × static height. Se não, ela é estática.

Depois que uma faixa termina, a próxima janela pode começar, no mais cedo, no candle que a terminou. Então a próxima faixa pode aparecer, no mais cedo, 9 candles depois do fim.

Uma faixa cresce ou termina

Em cada candle fechado seguinte, com n = o número de candles do primeiro candle da faixa até este:

1. Calcule a linha de ajuste de novo, incluindo este candle. A altura estática agora também inclui a máxima e a mínima deste candle.
2. O limite é 2.0 × ATR × 1.20, que é 2.4 × ATR.
3. A estática cabe quando a altura estática ≤ limite. A dinâmica cabe quando a altura dinâmica ≤ limite.
4. Rompimento para cima: fechamento > topo anterior + 0.15 × ATR. Rompimento para baixo: fechamento < base anterior − 0.15 × ATR. Anterior quer dizer a faixa como estava depois do último candle: o topo e a base de uma caixa, ou as bordas de um canal no último candle.
5. Folga para pavios, só enquanto a faixa é estática: a caixa ainda cabe quando não há rompimento e a altura estática ≤ limite + 0.60 × ATR (ou seja, 3.0 × ATR). Um pavio pode passar para fora e esticar a caixa; só um fechamento fora rompe a caixa.
6. A faixa termina quando já tem 150 candles (n > 150), ou quando há um rompimento para cima ou para baixo, ou quando nem a estática (com a folga para pavios) nem a dinâmica cabem.
7. Se não, este candle entra na faixa. A caixa inclui a máxima e a mínima dele, e a linha de ajuste é atualizada.
8. O tipo é decidido de novo: dinâmica quando a dinâmica cabe e, além disso, ou a estática (com a folga para pavios) não cabe, ou a faixa não é plana e a altura dinâmica ≤ 0.85 × static height. Se não, estática.

Então uma faixa que está crescendo pode mudar entre STATIC e DYNAMIC, e a cor dela muda junto.

O que é desenhado

Enquanto uma faixa cresce, ela é desenhada de novo a cada candle fechado, do primeiro candle dela até o candle fechado mais novo.

A etiqueta aponta para baixo, para o seu ponto. Ela é preenchida com a cor da faixa, com 15% de transparência, e tem texto branco #FFFFFF em tamanho pequeno. Num canal de queda, a etiqueta flutua acima da ponta direita do canal, na altura da ponta esquerda dele.

Quando uma faixa termina

A faixa terminada mantém o desenho do candle anterior. A borda direita dela é o último candle dentro dela; o candle que a terminou não faz parte dela. Depois:

1. Nova cor, só depois de um rompimento. A borda e o preenchimento da caixa, as bordas e o preenchimento do canal, as linhas de 25% e 75% e a etiqueta ficam verde-azuladas #26A69A depois de um rompimento para cima, ou vermelhas #EF5350 depois de um rompimento para baixo. Elas mantêm as transparências (preenchimento 92%, linhas dos quartos 40%, etiqueta 15%). A linha de 50% continua vermelha. A etiqueta mantém a palavra.
2. Projeção, só para uma faixa dinâmica. Duas linhas tracejadas de 2 px levam as bordas de cima e de baixo na mesma inclinação, do último candle dentro até 2 candles depois. Elas ficam com a cor final: verde, vermelha, ou azul-clara quando a faixa só acabou. Uma linha vermelha pontilhada de 1 px leva a linha de 50% do mesmo jeito. A projeção termina um candle depois do candle que terminou a faixa.
3. Níveis: o teto e o piso podem continuar indo para a direita (veja abaixo).

O teto é o topo da faixa no último candle dela; para um canal, o valor da borda de cima ali. O piso é a base, do mesmo jeito.

• O teto continua quando o candle que terminou a faixa não fechou acima de ceiling + 0.15 × ATR. O piso continua quando ele não fechou abaixo de floor − 0.15 × ATR.
• Então, depois de um rompimento para cima, só o piso continua; depois de um rompimento para baixo, só o teto; e depois de uma faixa que só acabou, os dois continuam.
• Um nível é uma linha reta tracejada, de 1 px, na cor final, com 20% de transparência. Ele é reto também para um canal.
• Em cada candle fechado seguinte, ele vai até esse candle. Ele para no primeiro candle que fecha acima de ceiling + 0.15 × ATR (um teto) ou abaixo de floor − 0.15 × ATR (um piso), ou 100 candles depois do último candle da faixa.
• Um nível que parou fica no gráfico onde parou.

Quantos desenhos ficam

Toda faixa terminada fica no gráfico. O KAGAMI mantém os limites do script original: 500 caixas, 500 linhas e 500 etiquetas. Passando de 500 de um tipo, o mais antigo desse tipo é tirado, seja qual for a faixa a que pertence. O preenchimento de um canal sai quando qualquer uma das bordas dele sai.

As linhas acabam primeiro. Uma faixa estática deixa até 5 linhas; uma dinâmica, até 10. Então, num histórico longo, as faixas mais antigas à esquerda perdem as linhas primeiro. Uma caixa pode ficar sem a sua linha de 50%.

Valores

O KAGAMI não mostra valores para ajustar neste indicador. Ele sempre usa os padrões do script original:

Não disponível no KAGAMI:

• mudar qualquer um dos valores acima;
• o grupo Moving Averages do original (MA type, Source, Line width, e três médias móveis de 20, 50 e 200 candles). Elas vêm desligadas no padrão do original. O KAGAMI não desenha essas médias.

Quando os valores mudam

• O KAGAMI só avalia candles fechados. O candle em formação nunca conta, então nada se move enquanto um candle se forma.
• A página pede os desenhos aos servidores do KAGAMI a cada novo candle fechado, e a cada 60 segundos. Nos tempos gráficos bem curtos, no máximo uma vez a cada 2 segundos.
• A faixa que está crescendo muda a cada fechamento. A borda direita, o topo, a base, a inclinação, o tipo e a cor dela podem mudar. O primeiro candle dela fica.
• Uma faixa terminada fica fixa. Só os níveis dela continuam crescendo até parar, e os limites de 500 podem tirar as partes mais antigas dela.
• O KAGAMI lê até os últimos 2.000 candles e começa as regras no mais antigo. Quando chegam candles novos, esse começo anda para a frente. Então as faixas mais antigas na ponta esquerda podem mudar ou sumir.

Tempos gráficos

• As regras são as mesmas em todos os tempos gráficos. Elas contam candles, não horas. O ATR vem dos candles do próprio gráfico.
• Os tempos gráficos em segundos (1, 5, 10, 15 e 30 segundos) existem só para cripto. Ações e câmbio começam em 1 minuto.
• Os candles de ações dos EUA cobrem o horário do mercado (09:30–16:00 em Nova York). As regras não sabem das sessões. Uma faixa pode atravessar uma noite ou um fim de semana, e o salto na abertura conta como qualquer outro movimento.
• Num gráfico de 1 segundo, os desenhos se atualizam no máximo uma vez a cada 2 segundos.

Diferenças em relação ao script Pine original

O KAGAMI desenha as mesmas faixas, linhas, etiquetas e cores que o script original com as configurações padrão. O que é diferente:

1. Sem configurações. Cada valor fica fixo no padrão do original.
2. Sem médias móveis. As três médias móveis opcionais do original não são desenhadas. Elas vêm desligadas no padrão dele.
3. Sem alertas. Os dois alertas do original, para uma faixa que se forma e para uma faixa que termina ou rompe, não existem no KAGAMI.
4. Sempre candles fechados. No TradingView, o Evaluate on bar close only pode ser desligado. No KAGAMI, ele fica sempre ligado.
5. Histórico. O KAGAMI lê até os últimos 2.000 candles. O TradingView muitas vezes tem mais. As faixas mais antigas podem ser diferentes.
6. Dados dos candles. O KAGAMI usa os seus próprios dados de mercado. Uma pequena diferença num candle pode mudar quais faixas são encontradas.
7. Tick. O KAGAMI usa a sua própria regra (veja O cálculo). Ela só importa no teste de faixa plana.
8. Limites de objetos. O TradingView chama o seu limite de 500 de aproximado. O KAGAMI fica com exatamente os 500 mais novos de cada tipo.
9. A aparência. O KAGAMI usa as ferramentas de desenho do próprio gráfico: um retângulo, linhas de tendência, uma forma de canal para o preenchimento e um balão para a etiqueta. Os tamanhos e as fontes parecem um pouco diferentes. Você não pode selecionar, mover nem editar esses desenhos, e eles não ficam salvos.
10. Pontos no futuro. A projeção de um canal pode ir um candle além do candle fechado mais novo. O KAGAMI coloca esse ponto uma duração de candle depois, em tempo de relógio. O TradingView conta barras.

Casos especiais

• Menos de 3 candles fechados: nada é desenhado.
• Os primeiros 13 candles não têm ATR, então nenhuma faixa pode começar. A primeira faixa pode aparecer, no mais cedo, no 14º candle.
• Preços que não se movem nada: o ATR é 0. Uma caixa de altura zero pode aparecer, e qualquer movimento depois termina essa caixa.
• Uma faixa de cada vez. As faixas nunca dividem candles.
• Trechos calmos longos: uma faixa termina em 150 candles, mesmo que o preço continue calmo. A próxima pode começar 9 candles depois.
• Gaps grandes aumentam a amplitude verdadeira, então o ATR cresce. Isso afrouxa os limites para os candles seguintes.
• Candles que faltam: as regras contam candles, então um buraco nos dados é simplesmente pulado.