Resolution format​

A resolution value should have the ResolutionString type. The table below describes how to specify different resolution values. In these values, x represents a number of units.

You can also omit the number of units if it is equal to 1. For example, you can use D instead of 1D and W instead of 1W.

Set up resolution on the chart​

The resolution is initialized in the Widget Constructor and can be changed in the UI or using the API.

To get the current resolution, use the resolution method.

widget.onChartReady(() => {
    widget.activeChart().resolution();
});

Default resolution​

You can specify the default resolution using the interval property in the Widget Constructor.

new TradingView.widget({
    // ...
    interval: '1D',
});

In UI​

s can change the resolution in the following ways:

• Use the Resolution button on the top toolbar.

• Use the Resolution button in the Legend.

• Press any digit key or the , (comma) key.

To disable any of the methods above, refer to Disable resolution changing.

Using API​

You can use the setResolution method to change the resolution on the fly.

widget.onChartReady(() => {
    widget.activeChart().setResolution('2M');
});

Configure resolutions in datafeed​

You should configure resolutions in your datafeed to display data correctly. To do this, follow the steps below:

1. Specify resolutions that the chart and a certain symbol .
2. Enable specific resolutions that you use, for example, a resolution in seconds or days.
3. Implement the corresponding method in the datafeed.

1. Specify ed resolutions​

To enable any resolution, specify the following properties:

• DatafeedConfiguration.ed_resolutions contains all resolutions that the chart should .
• LibrarySymbolInfo.ed_resolutions contains all resolutions that a certain symbol should .

The resolutions should be listed in a specific format. For example, ["1", "15", "240", "D", "6M"] stands for 1 minute, 15 minutes, 4 hours, 1 day, and 6 months. If the certain symbol does not some chart resolutions, they are disabled for this symbol in the UI.

If a switches to another symbol, that does not the selected resolution, the library changes the resolution to the first available one for this symbol.

Additional resolutions​

The library can combine smaller intervals into larger ones to build new resolutions. For instance, it can build 2-minute bars from 1-minute bars. Therefore, you can enable resolutions that your datafeed does not explicitly provide. To do this, add these resolutions to the ed_resolutions arrays mentioned above.

If you want to disable resolution rebuilding, use the disable_resolution_rebuild featureset.

2. Enable required resolutions​

Follow the instructions below to enable the required resolutions.

Resolution in seconds​

To enable resolution in seconds, additionally configure the following properties:

• Enable the seconds_resolution featureset. To do this, include seconds_resolution to the enabled_features array.
• Set has_seconds to true.
• Specify seconds_multipliers that contains the resolutions provided by the datafeed.

Additionally, if your datafeed s tick data for a symbol, you can tell the library to build seconds bars from ticks. To do this, set build_seconds_from_ticks to true. Note that this feature is available in Trading Platform only.

Resolution in minutes (intraday)​

To enable intraday resolution (in minutes), additionally configure the following properties:

• Set has_intraday to true.
• Specify intraday_multipliers that contains the resolutions that the datafeed provides.

Resolution in days​

To enable resolution in days, additionally configure the following properties:

• Set has_daily to true.
• Specify daily_multipliers that contains the resolutions that the datafeed provides.

Resolution in weeks / months​

To enable resolution in weeks or months, additionally configure the following properties:

• Set has_weekly_and_monthly to true.
• Specify weekly_multipliers or monthly_multipliers that contains the resolutions that the datafeed provides.

Resolution in ticks​

To enable resolution in ticks, additionally configure the following properties:

• Enable the tick_resolution featureset. To do this, include tick_resolution to the enabled_features array.
• Set has_ticks to true.

Additionally, you can tell the library to build seconds bars from ticks. To do this, set build_seconds_from_ticks to true. Note that this feature is available in Trading Platform only.

3. Implement method in datafeed​

The library requests data from the datafeed based on the current resolution selected on the chart. All resolutions that your datafeed explicitly s should be listed in the *_multipliers properties (seconds_multipliers, daily_multipliers, etc.) and implemented in the getBars method.

Example​

Consider the following example. The datafeed has 1-minute and 2-minute bars. Also, you would like to a 5-minute resolution. In this case, you should configure the LibrarySymbolInfo properties as follows:

//...
"has_intraday": true,
"ed_resolutions": ["1", "2", "5"],
"intraday_multipliers": ["1", "2"], // The library can request 1-minute and 2-minute bars, and will build 5-minute bars from 1-minute data
//...

The example of the getBars implementation is demonstrated below:

getBars(symbolInfo, resolution, periodParams, onHistoryCallback, onErrorCallback) {
    if (resolution === '1') {
        const bars = getBarsFor1MinuteResolution(periodParams);
        onHistoryCallback(bars);
        ​
        return;
    }
    ​
    if (resolution === '2') {
        const bars = getBarsFor2MinuteResolution(periodParams);
        onHistoryCallback(bars);
        ​
        return;
    }

    //...
}

function getBarsFor1MinuteResolution(periodParams) {
    // Your custom logic
}

function getBarsFor2MinuteResolution(periodParams) {
    // Your custom logic
}

Additional settings​

You can use featuresets to adjust resolution settings.

Disable resolution rebuilding​

The library aligns bars to the nearest expected bar position. For example, if session is 0915-1530 and the chart shows a 5-minute resolution, the library expects the following bar timestamps: [09:15, 09:20, 09:25, ...]. If your datafeed provides a bar with the 09:17 timestamp, the library changes this timestamp to 09:15. You can use the disable_resolution_rebuild featureset to display bars exactly as your datafeed provides.

Enable custom resolutions​

You can use the custom_resolutions featureset to allow s to add custom resolutions. Note that if a adds a resolution that the symbol does not , this resolution will be disabled in the UI.

Disable resolution changing​

You can use the header_resolutions featureset to remove the Resolution button from the top toolbar.

To disable resolution changing in the Legend, use the legend_inplace_edit featureset. If you want to completely remove the Resolution button from the Legend, use the hide_resolution_in_legend featureset.

To disable the Resolution shortcut, use the show_interval_dialog_on_key_press featureset.