Como usar a funcionalidade MTF?

A funcionalidade MTF é um recurso que permite alterar o período de qualquer indicador com apenas dois cliques nas entradas, usando o menu suspenso Resolução.

Os programadores de Pine podem usar o mesmo parâmetro de resolução que usamos em nossos indicadores internos em seus próprios scripts. Simplesmente ao adicioná-la a declaração de indicador do script, os programadores têm uma maneira fácil de adicionar a funcionalidade MTF aos scripts e permitem que os usuários decidam o tempo gráfico em que desejam que o indicador seja executado.

O uso do parâmetro de resolução adicionará automaticamente um campo de entrada Resolução às entradas do seu script. O valor padrão do parâmetro de resolução pode ser qualquer sequência de resolução válida. Se, no entanto, não estiver incluído nas opções disponíveis no menu suspenso do campo, o símbolo Igual ao padrão será exibido como o valor padrão no campo. Use a string vazia ("") para representar a resolução do gráfico.

Digamos, por exemplo, que você deseja usar um gráfico com uma resolução de 5m, mas deseja que ele mostre uma Média Móvel com base na resolução de 1D. Anteriormente, você poderia fazer isso usando a função security:

//@version=5
indicator(title="Moving Average", shorttitle="MA with security", overlay=true)
len = input.int(9, minval=1, title="Length")
src = input.source(close, title="Source")
out = ta.sma(src, len)
tf = input.timeframe(title="Timeframe", defval="1D")
s1 = request.security(syminfo.tickerid, tf, out, gaps=barmerge.gaps_on)
plot(s1, color=color.red)

Agora, no entanto, você só precisará adicionar resolution = "D" à sua chamada de study, conforme mostrado abaixo:

//@version=5
indicator(title="Moving Average", shorttitle="MA with timeframe", overlay=true, timeframe="D", timeframe_gaps=true)
len = input.int(9, minval=1, title="Length")
src = input.source(close, title="Source")
offset = input.int(title="Offset", defval=0, minval=-500, maxval=500)
out = ta.sma(src, len)
plot(out, color=color.blue, title="MA", offset=offset)

O novo parâmetro de resolução fornece uma maneira fácil de adicionar a funcionalidade MTF a scripts relativamente simples. Pine Scripts mais complexos ainda precisarão da security para implementar cálculos avançados usando informações de tempos gráficos maiores.

Observe que o valor das variáveis timeframe.* representará a resolução na qual o script está sendo executado atualmente, conforme determinado pelo valor do campo Tempo Gráfico nas entradas do script, independentemente do tempo gráfico. Observe também que, como os valores mais altos do período contêm lacunas quando o tempo gráfico é usado em um script (a não ser que timeframe_gaps esteja configurado como falso), as variáveis timeframe.* também contêm valores n/a entre as transições de tempo. Esse comportamento é esperado. Você pode aprender mais sobre isso em nossa Central de Ajuda.