Get started
The MTF functionality is a feature that allows you to change any indicator’s timeframe with just two clicks in Inputs, using the Timeframedropdown.
Pine coders can use the same timeframeparameter we use in our built-in indicators in their own scripts. By simply adding it to a script's indicatordeclaration statement, coders now have an easy way to add MTF functionality to scripts and let users decide the timeframe they want the indicator to run on.
Using the timeframe parameter will automatically add a Timeframeinput field to your script's Inputs. The parameter's default value can be any valid timeframe string. If, however, it is not included in the choices available from the field's dropdown menu, the default Same as symbol will appear as the default value in the field. Use the empty string ("") to represent the chart's timeframe.
Let’s say, for example, that you want to use a chart with a timeframe of 5m, but want it to show a Moving Average based on a timeframe of 1D. Previously, you could do this by using the request.securityfunction:
//@version=5indicator(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)
Now, however, you’ll just need to add timeframe="D" to your indicatorcall:
//@version=5indicator(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)The timeframeparameter provides an easy way to add MTF functionality to relatively simple scripts. The addition of timeframe_gaps=true is optional and similar in principle to the `gaps` parameter in the `request.security()` function. More complex Pine scripts will still need request.securityto implement advanced calculations using higher timeframe information.
Note that the value of timeframe.* variables will represent the timeframe the script is currently running on as determined by the value of the Timeframefield in the script's Inputs, regardless of the chart's timeframe. Also note that since higher time frame values contain gaps when the timeframe parameter is used in a script (unless timeframe_gaps is set to false), the timeframe.* variables will also contain n/a values between time transitions. This behavior is expected. You can learn more about it in our Help Center.
Pine coders can use the same timeframeparameter we use in our built-in indicators in their own scripts. By simply adding it to a script's indicatordeclaration statement, coders now have an easy way to add MTF functionality to scripts and let users decide the timeframe they want the indicator to run on.
Using the timeframe parameter will automatically add a Timeframeinput field to your script's Inputs. The parameter's default value can be any valid timeframe string. If, however, it is not included in the choices available from the field's dropdown menu, the default Same as symbol will appear as the default value in the field. Use the empty string (\"\") to represent the chart's timeframe.
Let’s say, for example, that you want to use a chart with a timeframe of 5m, but want it to show a Moving Average based on a timeframe of 1D. Previously, you could do this by using the request.securityfunction:
//@version=5\nindicator(title=\"Moving Average\", shorttitle=\"MA with security\", overlay=true)\nlen = input.int(9, minval=1, title=\"Length\")\nsrc = input.source(close, title=\"Source\")\nout = ta.sma(src, len)\ntf = input.timeframe(title=\"Timeframe\", defval=\"1D\")\ns1 = request.security(syminfo.tickerid, tf, out, gaps=barmerge.gaps_on)\nplot(s1, color=color.red)
Now, however, you’ll just need to add timeframe=\"D\" to your indicatorcall:
//@version=5\nindicator(title=\"Moving Average\", shorttitle=\"MA with timeframe\", overlay=true, timeframe=\"D\", timeframe_gaps=true)\nlen = input.int(9, minval=1, title=\"Length\")\nsrc = input.source(close, title=\"Source\")\noffset = input.int(title=\"Offset\", defval=0, minval=-500, maxval=500)\nout = ta.sma(src, len)\nplot(out, color=color.blue, title=\"MA\", offset=offset)The timeframeparameter provides an easy way to add MTF functionality to relatively simple scripts. The addition of timeframe_gaps=true is optional and similar in principle to the `gaps` parameter in the `request.security()` function. More complex Pine scripts will still need request.securityto implement advanced calculations using higher timeframe information.
Note that the value of timeframe.* variables will represent the timeframe the script is currently running on as determined by the value of the Timeframefield in the script's Inputs, regardless of the chart's timeframe. Also note that since higher time frame values contain gaps when the timeframe parameter is used in a script (unless timeframe_gaps is set to false), the timeframe.* variables will also contain n/a values between time transitions. This behavior is expected. You can learn more about it in our Help Center.
"},"popular":{"43000482542":{"solutionId":43000482542,"folderId":43000548581,"categoryId":43000363655,"title":"I forgot my username/password and would like to restore access to TradingView","lang":"en","updatedAt":"2024-04-01T13:11:29.000Z"},"43000473924":{"solutionId":43000473924,"folderId":43000547053,"categoryId":43000359303,"title":"Is US stock market data free by default?","lang":"en","updatedAt":"2024-03-20T10:45:34.000Z"},"43000502023":{"solutionId":43000502023,"folderId":43000554058,"categoryId":43000359303,"title":"I want to access Extended Hours data","lang":"en","updatedAt":"2024-03-18T09:47:35.000Z"},"43000471715":{"solutionId":43000471715,"folderId":43000547069,"categoryId":43000359310,"title":"I have been automatically charged after my trial and want a refund","lang":"en","updatedAt":"2022-05-19T06:23:37.000Z"},"43000471716":{"solutionId":43000471716,"folderId":43000547069,"categoryId":43000359310,"title":"I was automatically billed for 1 or 2 years and would like to have a refund","lang":"en","updatedAt":"2022-05-31T09:30:18.000Z"},"43000661857":{"solutionId":43000661857,"folderId":43000547456,"categoryId":43000359310,"title":"I paid for a plan, but my account has not been upgraded. How do I contact Support?","lang":"en","updatedAt":"2023-12-13T12:30:16.000Z"}},"language":"en","blogUrl":"https://www.tradingview.com/blog/en/","isMobileApp":false,"blackfridaySolutionShown":false,"cybermondaySolutionShown":false,"chatEnabled":false}}
