Timeframe é o intervalo representado por uma barra ou vela num gráfico temporal convencional. Alterá-lo reagrupa os preços; ampliar o gráfico muda apenas a apresentação.
Jana abre um gráfico de bitcoin e troca velas de minutos por velas diárias. O mercado não mudou: mudou o período resumido por cada vela. Um pequeno movimento que ocupava a tela pode desaparecer dentro da amplitude diária. A TradingView também chama esse intervalo de resolução. O zoom amplia a visualização; mudar o intervalo agrupa os dados de outra forma. Nenhuma dessas ações determina por quanto tempo Jana deve manter bitcoin. [1]
Para ler um gráfico, basta inicialmente entender a unidade indicada. Ao processar dados, a notação exata importa: no Pine Script da TradingView, 15 significa quinze minutos, 60 uma hora e 1M um mês. Não existe uma unidade H separada para horas. Já a interface REST API da Kraken para OHLC aceita minutos de uma lista permitida. Uma configuração não deve ser transferida entre plataformas sem conferir seu significado. [1] [5]
Uma vela diária precisa de início e fim definidos. Ao comparar gráficos, Jana verifica esses limites e a fonte dos dados, além do mercado. Na TradingView, o fuso do gráfico controla a exibição; o Pine Script utiliza valores temporais e regras próprias de cálculo. Exibir a hora local não altera por si só os cálculos do script. Horários diferentes no eixo não comprovam que as velas foram montadas de outra maneira. [2]
Num mercado com horários definidos, o encerramento da sessão —o período aberto à negociação— pode encurtar a última vela. A TradingView alinha velas temporais aos limites da sessão. Portanto, não é seguro supor que toda barra de qualquer gráfico abrange a duração nominal completa. Outros gráficos criam barras a partir de um número de atualizações de preço ou de uma variação de cotação, em vez do relógio; seus intervalos temporais são irregulares. [2]
Jana observa uma vela diária no meio do dia. A máxima (High), a mínima (Low) e o último preço ainda podem mudar. A TradingView chama o campo do último preço de Close, mas numa vela aberta ele ainda não é o preço final do dia. O mesmo cuidado vale para um indicador que usa um intervalo maior num gráfico curto. É preciso distinguir valores provisórios dos confirmados no fechamento, ou um sinal poderá parecer diferente depois. [3]
Um backtest testa regras em dados históricos. Cada decisão só pode usar informações disponíveis naquele momento: o preço final do dia era desconhecido pela manhã. A TradingView alerta que lookahead_on, numa consulta de intervalo maior sem o deslocamento apropriado da expressão, pode atribuir valores futuros a barras passadas. O resultado parece convincente, mas não é reproduzível em tempo real. Conferir quando a informação estava disponível importa mais que uma bela curva de resultados. [4]
Um programa pode consultar barras menores contidas numa vela mais longa. Nessas consultas, request.security do Pine Script retorna apenas uma barra interna por barra do gráfico. request.security_lower_tf pode retornar um array com as barras internas disponíveis. Isso determina se o cálculo usa uma amostra ou uma sequência disponível. Nem o array garante um histórico completo: podem faltar dados e o fornecedor pode corrigir registros posteriormente. [4]
Jana anota o mercado, o intervalo, a fonte e se as velas já fecharam. Para um indicador calculado sobre certo número de velas, registra também essa quantidade: outro intervalo muda o tempo coberto. Multiplicar quantidade por duração funciona diretamente apenas com intervalos completos, consecutivos e sem lacunas. Timeframe ajuda a definir qual parte do passado estamos examinando; não fornece a resposta sobre os preços futuros. [1] [2]
Vinte velas, dois períodos
Num gráfico hipotético, Jana seleciona 20 velas completas, de igual duração, consecutivas e sem lacunas. Com 15 minutos cada, elas cobrem 20 × 15 = 300 min. Ao mudar para 60 minutos, as mesmas 20 velas representam 20 × 60 = 1200 min. Essa é a duração coberta pelos intervalos inteiros, não a distância entre o primeiro e o último horário de fechamento. O cálculo não vale da mesma forma para velas encurtadas ou ausentes e não promete melhores resultados de negociação. A última vela continua provisória até fechar.
Para ter uma visão mais completa, leia este verbete junto com OHLCV, Candlestick chart, Technical analysis, Backtesting, Moving average, Price action. Também há referências a este verbete em OHLCV, Candlestick chart, Price action, Technical indicator.
01Mudar o fuso horário também muda as velas diárias?+
Não automaticamente. O fuso do gráfico na TradingView é uma configuração visual e não altera os cálculos temporais do Pine Script. Ao comparar fontes, confira os limites reais dos intervalos; outra hora no rótulo não comprova outra agregação.
02Posso combinar um gráfico diário com um intervalo menor?+
Sim. O intervalo maior pode trazer contexto e o menor detalhes. É preciso saber de qual mercado vêm os dados e quais valores eram conhecidos no momento da decisão. Não se pode usar antecipadamente o resultado final de um dia ainda aberto.