Release Notes
You can check the library version by executing TradingView.version()
in a browser console.
Version 28.3.0
Date: Thu Oct 24 2024
New Features
- Symbol name in the Watchlist and Details widgets. Now, the
DatafeedQuoteValues.short_name
value is displayed as a symbol's short name in the Watchlist and Details. You can disable theprefer_quote_short_name
featureset to revert to the old behavior. In this case, theticker
value will be used instead.Trading Platform Only
Bug Fixes
- Anchored Note in multi-layout. Fixed an issue where plotting a saved Anchored Note in multi-layout would raise an error. Trading Platform Only
- Fixed symbol logo persistence in legend. Resolved an issue where a failed image load (e.g., a 404 error) for a symbol logo would cause the previous logo to persist in the legend. Now, the legend correctly updates to reflect the absence of a logo when loading fails. See the Symbol logos section of the Legend documentation for more details on the feature.
- Fixed ordering of symbol logos. Fixed an issue where symbol logos with two URLs defined in
logo_urls
were displayed in an inconsistent order. The order has been corrected on the chart legend and within the Account Manager table.
Version 28.2.0
Date: Tue Oct 01 2024
New Features
- Added
Rank Correlation Index
indicator. - Support building seconds bars from ticks. Trading Platform now supports building seconds bars from ticks for symbols configured to support it. Compatible symbols must set the
build_seconds_from_ticks
flag totrue
. Additionally,has_seconds
andhas_ticks
must betrue
, andseconds_multipliers
must be an empty array or only contain multipliers that the datafeed provides itself.Trading Platform Only
Improvements
- Added an option to customize the default Volume MA calculation in the Volume indicator. By default, the Volume MA, optionally plotted in the Volume indicator, used the SMA calculation. We have now introduced two additional options: EMA and WMA.
- Added new event to
SubscribeEventsMap
. Thetimeframe_interval
event is triggered when the one of the bottom left intervals is selected or thesetTimeFrame
API is used. - Added a symbol change to MACD indicator. It is now possible to change the targeted symbol when plotting MACD indicator without using the main series.
- Sped up sorting animation in the Account Manager. Raised by #8760 Trading Platform Only
Version 28.1.0
Date: Wed Sep 04 2024
Breaking Changes
- Deprecated API methods.
activateBottomWidget
is now markeddeprecated
. Please usesetAccountManagerVisibilityMode
instead. If you want to retrieve the current state of the Account Manager please usegetAccountManagerVisibilityMode
New Features
- Added
iframe_loading_same_origin
featureset. Theiframe_loading_same_origin
featureset ensures the library's iframe is loaded from the same domain as thelibrary_path
files.
Improvements
- Added new event to
SubscribeEventsMap
. Thestudy_dialog_save_defaults
event is triggered when the Save as default option is selected in the indicator settings. - Changed the return type for
OrderPreviewResult
. When implementingpreviewOrder
, you can specify links to external URLs now. The links will be displayed within thewarnings
orerrors
block.Trading Platform Only - Added an item counter for custom pages. By default, custom pages added to the Account Manager do not display the number of items in their corresponding table. Enabling
displayCounterInTab
will show this number next to the tab title.Trading Platform Only
Bug Fixes
- charting_library_debug_mode. Fixed an issue where enabling the featureset
charting_library_debug_mode
was of no effect. - Instant display of refreshed marks. Fixed an issue where new marks added after calling
refreshMarks
were not immediately displayed on the chart. Previously, these marks only appeared after user interaction, but now they are instantly visible once the data is provided. - Fixed an issue with
multiple_watchlists
featureset. When themultiple_watchlists
featureset was disabled, it was still possible to see theCreate a new list
option under the Watchlist drop-down menu.
Documentation
- New how-to guide. Check out a new guide on enabling debug modes to help identify potential issues when implementing your app and ensure it is running smoothly.
Version 28.0.0
Date: Wed Aug 14 2024
Breaking Changes
Removed
full_name
. TheLibrarySymbolInfo.full_name
property was removed from public API. The property contained strings in the'EXCHANGE:SYMBOL'
format and was used to request data from the datafeed. Therefore:- Now, you should use either the
name
orticker
property to specify an identifier for a certain symbol. For more information, refer to the Symbology article. - Instead of
'EXCHANGE:SYMBOL'
, the library will send eithername
orticker
values to the datafeed when calling methods such asgetBars
,getQuotes
, andsubscribeQuotes
. - The
'EXCHANGE:SYMBOL'
strings are no longer displayed in the Trading Platform UI. The symbol name will be used instead. You can disable theprefer_symbol_name_over_fullname
featureset to revert to the old behavior.Trading Platform Only
- Now, you should use either the
Deprecated API methods. The following methods are now marked
deprecated
for the Advanced Charts users.These methods will be removed from the Advanced Charts library in the next major version. However, they will still be available in Trading Platform.
Make
cancelOrders
optional. ThecancelOrders
method is marked as optional because the library calls it only for the Depth of Market widget.Trading Platform OnlyRemoved the
calculatePLUsingLast
flag. ThecalculatePLUsingLast
broker configuration flag has been removed.Trading Platform OnlySymbol search dialog behavior. Previously, when users pressed Enter in the Symbol Search dialog, they could enter arbitrary input directly. This input was passed to the datafeed for resolution and loading, regardless of whether the input matched any search results.
Now, pressing Enter selects the top search result unless the user has explicitly chosen another item. If there are no search results, pressing Enter will have no effect. You can enable theallow_arbitrary_symbol_search_input
featureset to use the old behavior.Change custom translation API. Change the custom_translate_function interface to accept different parameters: the original text, the singular original text, and the translated text. For example "prices", "price", "prix".
Changed the behavior of data display in the Depth of Market widget. Now, data is displayed in static mode. This means that the price series is fixed, while the current price moves within, above, or below the designated range. To center on the current price, click the centering button () or use the Shift + Alt/Option + C shortcut. Previously, centering was applied dynamically.
Renamed the Symbol Info dialog. The Symbol Info dialog and the corresponding items in context menus are called Security Info now. #8444
Renamed ErrorCallback to DatafeedErrorCallback.
ErrorCallback
used inIDatafeedChartApi
has been renamed toDatafeedErrorCallback
.Updated
selectedCurrency
behavior. InCurrencyInfo
, theselectedCurrency
property now returnsnull
instead of"Mixed"
when price scales contain mixed currencies.Deprecated property. The
brokerConfig
property in theTradingTerminalWidgetOptions
interface is deprecated and will be removed in the next major release. Use thebroker_config
property instead.
New Features
- New Custom themes API. This API allows you to customize colors of the chart elements including toolbars, dialogs, and buttons.
To do this, you should specify your own theme with a custom color palette.
For more information, refer to the Custom themes API article.
- Added Volume Candles chart style. This chart style allows for a visual assessment of the volume of trades for each candle. These are still candlesticks, but the width of each candle depends on the volume of trades during the period of formation of this candle. The greater the trading volume during the formation period of the candle, the larger the width of the candle.
To display Volume Candles, select the corresponding option in the drop-down menu on the top toolbar.
Improvements
Behavior change for
chartContextMenuActions
. When thechartContextMenuActions
method returns an empty array, the Trade item within the chart context menu will not be displayed. Previously, the item was rendered but grayed out.Trading Platform OnlyAdded the
library_custom_fields
property to theLibrarySymbolInfo
interface. This property is used to include additional metadata in the symbol information. The metadata will not be processed by the library.Added extra properties to
symbolExt
method. ThesymbolExt
method now returns additional properties includingticker
.Added the
debug_broker
option to the Widget Constructor. Whendebug_broker
is specified, the library logs calls and responses toIBrokerWithoutRealtime
andIBrokerConnectionAdapterHost
in the browser console. You can setdebug_broker
to one of the debug levels defined byBrokerDebugMode
.Trading Platform OnlyUpdated the Anchored VWAP drawing. Add bands settings to the Anchored VWAP drawing.
Added new methods to the Trading Host. The
getOrderTicketSetting
andsetOrderTicketSetting
methods have been added to theIBrokerConnectionAdapterHost
interface. These methods allow you to read and adjust Order Ticket settings.Trading Platform OnlyChanged
const enum
toenum
in the library type declarations. This change allows you to import enums from the library in a TypeScript environment with theisolatedModules
option enabled, such as when using Vite or similar tools.Added the
hideStudiesFromLegend
option toClientSnapshotOptions
. WhenhideStudiesFromLegend
is set to true, the legend within the generated screenshots won't contain any studies applied to the chart.Exposed
connectionStatusUpdate
fromIBrokerConnectionAdapterHost
. An existingconnectionStatusUpdate
API has been exposed forIBrokerConnectionAdapterHost
to help reflect connection status changes throughout the application lifecycle.Trading Platform OnlyNew keyboard shortcuts. The following shortcuts were added:
- Shift + Mouse wheel — scroll the chart horizontally
- Shift + Alt + B — place limit order to buy
- Shift + Alt + S — place limit order to sell
Enabled in-place editing for drawing texts. For the following drawings, users can now add custom text and edit it on the chart:
- Fib Retracement
- Trend-based Fib Extension
- Horizontal and Vertical Line
- Trend Line
- Info Line
- Ray
- Extended Line
- Signpost
- Note
- Anchored Note
- Comment
- Rectangle
- Ellipse
- Circle
To enter the text, users should click the +Add text placeholder that appears on hover.
Disabled color pickers in Chart settings. If a certain price label or line is hidden on the chart, users cannot adjust the color of this label/line in the Chart settings dialog.
Time zones. Time zone updates:
- Changed the Almaty (UTC+6) time zone to Astana (UTC+5).
- Added the new Kuala Lumpur (UTC+8) time zone.
Visibility of price labels for risk-reward drawings. Previously, price labels for the Long position and Short position drawings could be either hidden entirely or always displayed. Now, if the price labels are disabled for a certain drawing, the labels will be displayed when the drawing is selected.
Accessibility improvement. Users can now select the following elements in the Legend when navigating with the keyboard.
- The More () button and items in the corresponding menu
- The Remove () button
Added new multiple-chart layouts combinations.
Trading Platform OnlyNew style settings for the Note drawing. Now:
- The Background and Border settings are optional.
- The default color of the drawing depends on the current chart theme.
Bug Fixes
- Fixed the Pivot Points Standard compatibility with Japanese chart types. The Pivot Points Standard indicator used to cause the Assertion failed: data must have unique sorted times error when applied to chart types such as Line Break, Renko, Kagi, and Point-and-Figure under certain data conditions.
- Workaround for corrupted chart layouts. In rare cases, chart layouts can become corrupted and cause a DEFAULT_SYMBOL is not defined error when loaded by the library. To work around this error, set
symbol
to be used as a fallback for any corrupted charts. - Fixed an issue where 0-volume data were not displayed in the Legend. #8662
- Fixed the time indicator. The time indicator now correctly moves across the timeline in the Market Status pop-up.
- Fixed resizing for risk-reward tools. The resizing of Long position and Short position drawings works correctly now. #8513
- Fixed changing of drawing coordinates. The setting dialog used to crash when users changed coordinates of drawings such as Anchored Volume Profile, Fixed Range Volume Profile, and Regression Trend.
- Fixed the drawing settings bug. Previously, when users clicked Hide/Show on a drawing, the settings applied to this drawing would override the default ones. Now, changing drawing visibility does not affect the default settings. #8434
- Fixed colors of the scale buttons. The colors of the A (auto) and L (log) scale buttons match the chart background color now. #8459
- Fixed bugs on the multiple-chart layout. Trading Platform OnlyThe following bugs were fixed:
- The Long/Short Position drawing used to cause errors if the drawing was hidden for a certain resolution and that resolution was currently displayed on the chart.
- Synchronized Path and Polyline drawings were not displayed on larger resolutions if the first two points of the drawing were set at the same level on a smaller resolution.
- The Curve and Double Curve drawings used to cause errors if a user moved the drawing before enabling layout synchronization.
- Changing the Profit/Stop level of the synchronized Long/Short Position drawing used to cause errors if the drawing was hidden for a certain resolution and that resolution was currently displayed on the chart.
Documentation
- Updated types for overrides. The following categories of overrides within the
ChartPropertiesOverrides
have been added or updated:- Added types for the Step line chart style (
mainSeriesProperties.steplineStyle.*
). - Updated the types for
paneProperties.*
. - Added overrides that affect Trading Platform features (
tradingProperties.*
).
- Added types for the Step line chart style (
- New articles. Explore our latest articles:
- How to create a custom indicator — a step-by-step tutorial that demonstrates the Moving Average implementation.
- Custom indicators. Inputs — an overview of how to specify and manage input parameters for a custom indicator.
- Authentication — an article that outlines possible authentication approaches. Trading Platform Only
Version 27.006
Date: Tue May 21 2024
Bug Fixes
- Resolve quotes with ticker instead of symbol name. The library will now request quote data using the
ticker
property. Ifticker
is not provided in theLibrarySymbolInfo
object, thename
property will be used instead. This should resolve an issue some customers were experiencing where quote data was not being properly displayed in the Watchlist and Legend.
Version 27.005
Date: Tue May 07 2024
Improvements
- Update the Anchored AVWAP drawing. Add bands settings to the Anchored VWAP drawing.
- Subscribe to widget bar visibility events. A new
study_event
type was added:widgetbar_visibility_changed
. It returns the visibility state of the widget bar.
Bug Fixes
- Fixed a bug in the Market Status pop-up. Corrections specified for the extended session in the
session-correction
properties were not displayed in the Market Status pop-up window.
Version 27.004
Date: Wed Apr 17 2024
Breaking Changes
- Fixed time parameters in CrossHairMovedEventParams. In version 26.001, we changed the
time
property ofCrossHairMovedEventParams
to be a timestamp in the selected time zone. In this version, we reverted that change, andtime
represents a UTC timestamp again. Additionally, we introduced a newuserTime
property that represents a timestamp in the selected time zone.
Improvements
- Added ability to disable pulse animation when chart type is set to Line. New disable_pulse_animation featureset allows users to disable the pulse animation when chart type is set to Line.
Bug Fixes
- Fixed the price scale placement. The price scale should be placed back to its original position when a change made through the Settings dialog is canceled. Fixes #4991
- Fixed the 52 Week High/Low indicator issue. The 52 Week High/Low indicator no longer adds an empty space to the price scale when less than 52 weeks of historic bars are available. Fixes #8137 #8469
- Only calculate VWAP value when entire anchor period is loaded. The VWAP indicator will only calculate values for the input anchor period if all bars in that period have been loaded.
- Fixed a trailing stop modification dialog error. Fixed a problem where opening the Order Ticket for a trailing stop position caused a "ReferenceError: isPositionLikeItem is not defined" error to be thrown.
- Fixed the incorrect point position for the Long Position drawing. The
getPositionPoints()
method will now return correct point positions. Fixes #8230 BREAKING CHANGE
Position line price label does not use the correct price formatter. The price scale will now correctly reflect the value when a formatter is used withcreatePositionLine
. BothcreateOrderLine
andcreatePositionLine
methods behave similarly to the corresponding actions made in the UI via Order Ticket. Fixes #8413 #8324
Documentation
- New User accounts article. Refer to User accounts for information on how to manage user accounts in the Account Manager.
- Session documentation updates. The Symbology and Extended sessions articles now include more information on how to specify sessions and corrections for them.
- New Save user settings article. Refer to the Save user settings article for information on how to store user settings.
- Updated Watchlist article. Explore our latest Watchlist article that describes how to customize and handle the watchlist's data.
Version 27.003
Date: Thu Mar 14 2024
Improvements
- Added the resetLayoutSizes method. Use
resetLayoutSizes
to reset the sizes of all charts within a multiple-chart layout back to their initial default values.Trading Platform Only - Added the unloadUnusedCharts method. The
unloadUnusedCharts
method deletes non-visible charts from a multiple-chart layout. Use this method to prevent the library's inherent behavior to restore previously displayed charts instead of creating new charts when changing layouts.Trading Platform Only - Added a new type that reflects the ID of the created indicator. A new
study_event
type was added:create
. It returns theid
of the newly created indicator.
Bug Fixes
- Displaying volume indicator on chart load when visible_plots_set is not specified. The chart will now correctly display the volume indicator if the
create_volume_indicator_by_default
featureset is enabled even if the symbols LibrarySymbolInfo doesn't specify the optionalvisible_plots_set
property. - Prioritise widget constructor symbol over saved state. The
symbol
property in the widget constructor will now have priority over symbols loaded from saved chart states when usingsaved_data
orload_last_chart
. Fixes #7922 #8473 #7926 #8168 - Fixed an issue where the time_frames description was ignored.
Version 27.002
Date: Thu Feb 22 2024
Improvements
- Add positive and negative filled areas to Spread. The Spread indicator now has a positive and negative filled area above and below the baseline value of 0. The colors of the filled areas are green and red respectively.
Bug Fixes
- Brush drawing_event is now raising a
create
event when starting drawing.
Documentation
- Improved drawing documentation. Explore our latest articles about drawings.
- New Drawings API article describes how to manage drawings in the code.
- Updated Drawing Overrides article now includes more information on how to customize drawings.
Version 27.001
Date: Fri Feb 2 2024
Improvements
- Custom indicators can now dynamically hide indicator inputs in the legend when plots are hidden. The
hideWhenPlotsHidden
option has been added for a custom indicator's input. It enables you to hide an input's value in the legend text when the user hides all of the specified plots.
Bug Fixes
- Allow studies that extend the time scale to load historic bars before the leftmost bar of the main series.
Documentation
- New articles
Version 27
Date: Wed Jan 17 2024
Breaking Changes
- Custom study plot style text property moved. The chars and shapes custom study plots
text
style property was moved frommetainfo.defaults.styles.[plot id].text
tometainfo.styles.[plot id].text
. See this GitHub issue for more details #8184 - Changed context menu behavior of the 'Plus' button and removed the 'show_context_menu_in_crosshair_if_only_one_item' featureset. Now, the context menu of the Plus button opens even if the menu has only one item. Previously, the item's action was immediately executed if there was only one item in the context menu. Additionally, the
show_context_menu_in_crosshair_if_only_one_item
featureset has been removed.
Breaking Changes: Trading Platform
- Changed parameter type in the showPositionDialog method. The
position
parameter type of theshowPositionDialog
method in theBrokerCustomUI
interface has been changed toPosition | IndividualPosition
. - Renamed flags in the BrokerConfigFlags interface. The following flags have been renamed in the
BrokerConfigFlags
interface:supportTrades
flag has been renamed tosupportPositionNetting
;supportTradeBrackets
flag has been renamed tosupportIndividualPositionBrackets
;supportCloseTrade
flag has been renamed tosupportCloseIndividualPosition
;supportPartialCloseTrade
flag has been renamed tosupportPartialCloseIndividualPosition
;requiresFIFOCloseTrades
flag has been renamed torequiresFIFOCloseIndividualPositions
.
- Renamed TradeBase and Trade interfaces. The
TradeBase
interface has been renamed toIndividualPositionBase
and theTrade
interface has been renamed toIndividualPosition
respectfully. All fields and their types has been left unchanged. - Renamed tradeColumns field in the AccountManagerInfo interface. The
tradesColumns
field in the AccountManagerInfo interface has been renamed toindividualPositionColumns
. - Renamed Trade member to IndividualPosition in the ParentType enum. The
Trade
member of theParentType
enum has been renamed toIndividualPosition
. - Renamed trade related methods in the IBrokerConnectionAdapterHost interface. The following methods in the
IBrokerConnectionAdapterHost
have been changed:- the
tradeUpdate
method has been renamed toindividualPositionUpdate
. Thetrade
parameter of the method has been renamed toindividualPosition
. Also, the type of that parameter has been changed toIndividualPosition
; - the
tradePartialUpdate
method has been renamed toindividualPositionPartialUpdate
. The type of thechanges
parameter has been changed toPartial<IndividualPosition>
; - the
tradePLUpdate
method has been renamed toindividualPositionPLUpdate
; - the type of the
position
parameter of theshowPositionBracketsDialog
method has been changed toPosition | IndividualPosition
.
- the
- Renamed methods in the IBrokerWithoutRealtime interface. The following changes have been made in the
IBrokerWithoutRealtime
interface:- The
closeTrade
method has been renamed tocloseIndividualPosition
; - The
editTradeBrackets
method has been renamed toeditIndividualPositionBrackets
.
- The
- Renamed trade method in the IBrokerCommon interface. The
trades
method in theIBrokerCommon
has been renamed toindividualPositions
. The return type of that method has been changed toPromise<IndividualPosition[]>
. - Removed the Order Panel button from the right toolbar. To open Advanced Order Ticket, users should use the Trade button in Account Manager now.
New Features
- Enabled in-place editing in Legend. Users can change a symbol and resolution right from the Legend now. #7966
- Added Quick Search. The Quick Search dialog allows users to search for drawings, UI settings, and functions, such as Remove Indicators. To open this dialog, users should click the Quick Search button on the top toolbar or use the Ctrl/Cmd + K shortcut.
- Added ability to show daily change in the chart legend. New Last day change values option allows users to show/hide the last day change values in the main series legend.
To make this option available in the Chart Settings dialog, use the
legend_last_day_change
featureset. #8193 - Updated drawing icons. New icons for the Text, Anchored Text, Note, and Anchored Note drawings. #8181
Improvements
BREAKING CHANGE
Refactoring of the Ichimoku Cloud indicator. Following feedback we've re-written the Ichimoku indicator and have brought the following changes:- 'Leading Span B' input is now 'Leading Span Periods'.
- 'Lagging Span' input is now 'Lagging Span Periods'.
- 'Leading Shift Periods' is a brand new input that aligns better to the original definition of the indicator.
- Previously, 'Lagging span' was shifting both cloud and lagging lines. This should no longer apply as 'Leading Shift Periods' now handles the offset change for 'Lagging Span'.
BREAKING CHANGE
Inputs renaming for Stochastic indicator. Inputs for the Stochastic indicator have been renamed for consistency across our products.BREAKING CHANGE
Broker API clean up.Trading Platform OnlyThepositionDialogOptions
object has been removed from the Broker's Configuration. Please use thegetPositionDialogOptions
method to customize the Position dialog.- Added new keyboard navigation shortcut. Starting from version 26.002, the library supports a keyboard navigation activated via the Alt/Opt + Z shortcut. Now, you can change this default navigation shortcut to Tab. To do this, enable the new
accessible_keyboard_shortcuts
featureset. For more information, refer to Keyboard navigation. - Added ability to cancel order dragging by pressing Esc. If a user presses Esc while dragging the order, the order will be returned to its initial position.
Bug Fixes
- Market status text during pre-market and post-market sessions. The countdown text in the market status pop-up tooltip (in the legend area) has been fixed for pre-market and post-market sessions. The market status icon now shows an orange sunrise icon for pre-market and a blue moon icon for post-market.
- Floating drawing toolbar context menu. It wasn't possibly to override the context menu for the floating drawing toolbar.
- Missing translation for No data here. No data here message that is displayed on the chart whenever no bars are returned for a given symbol was missing its translation.
- Disabling the 'open_account_manager' featureset now works as expected. Trading Platform Only
- Order Panel Custom Input Fields Reactivity. Trading Platform OnlyThe reactivity of UI elements within the order panel when using custom fields has been improved (Fixes #6607).
- Fixed the pane buttons on the collapsed pane. The pane buttons used to overlap the Scroll to the Most Recent Bar button when the pane is collapsed. #8213
- The precision setting can be applied to all charts now. To do this, users should specify precision in the Chart settings dialog and click the Apply to all button. #8343 Trading Platform Only
- Fix the color of high/low price label. Now, the color of high/low labels on the price scale corresponds to the color of the high/low lines. Users can specify this color in the Chart settings dialog. #8255
Documentation
- Chart customization precedence article added. The library offers multiple approaches for changing the chart appearance and behavior. Explore our latest article on customization precedence for a comprehensive understanding of customization methods/properties and the sequence in which they are applied.
- Order Ticket dialog article added. Refer to Order Ticket to learn how to provide custom fields, enable an order preview, implement your custom Order Ticket, and more.
- New how-to guide on metainfo. Explore our latest guide on how to implement the
metainfo
field when you create a custom indicator. For more information about custom indicators andmetainfo
, refer to the updated Custom indicators and Metainfo articles. - Bracket orders article added. Explore our latest article on bracket orders in Trading Platform.
- Account Manager article added. Refer to Account Manager for more information on creating pages, customizing columns, and configuring the Account Manager behavior.
- Accessibility article added. Refer to the new Accessibility article for information about accessibility features that the library includes.
- Other documentation updates. The new documentation version includes:
- Updated Resolution and Price Scale articles.
- A full list of overrides for built-in indicators. Refer to the Indicator Overrides article for information.
Other
BREAKING CHANGE
Deprecated customFormatters and brokerFactory. Usecustom_formatters
andbroker_factory
instead.BREAKING CHANGE
Deprecated RawStudyMetaInfo.precision. Use theformat
property instead. For more information, refer to the Metainfo article.
Version 26.004
Date: Thu Nov 16 2023
New Features
- Add methods to handle trading quantity. The broker API now exposes a getter getQty and a setter setQty along with a subscription subscribeSuggestedQtyChange and its dependant to unsubscribe unsubscribeSuggestedQtyChange.
Improvements
- Added anchor option to VWAP indicator. The VWAP indicator now has input options for source and anchor.
- Source allows customisation of the price source for the indicator. Defaults to
hlc3
. - Anchor period setting specifies how frequently the VWAP calculation will be reset. This Defaults to
'Session'
.
- Source allows customisation of the price source for the indicator. Defaults to
Bug Fixes
- VWAP Indicator behaviour. The default behaviour for the VWAP indicator has been fixed. Previously it would anchor to the earliest available data point instead of the start of each session.
- Displaying DOM widget data on non-tradable symbols. Trading Platform OnlyWhen a symbol is non-tradable (
isTradable()
in the Broker API is returningfalse
) it is now possible to display depth data in the DOM widget provided via the datafeed. - The price source text is visible in the screenshot.
- Fix display of price sources in Overlay study. Price sources for symbols in the Overlay study were not being shown when the main series symbol did not have the same price source
- Both Trend Strength Index and Linear Regression Slope indicators were missing their zero-based property to properly plot them using a histogram.
- onChartReady inconsistency on Safari. Fixed an issue where
onChartReady
wouldn't reliably get called on specific versions of Safari.
Documentation
- New article on core trading concepts. We have added a new article describing trading concepts in Trading Platform. Learn how to integrate trading functionality into your application using the Broker API and Trading Host.
Version 26.003
Date: Thu Oct 05 2023
Bug Fixes
- Do not save to localstorage when the use_localstorage_for_settings feature is disabled. Fixed a bug where use_localstorage_for_settings did not stop some settings from being saved to localstorage.
- Disabling
drawing_templates
completely removes the ability to save it when using line tools. - Renaming a section within watchlist was throwing an error.
- Fixed an issue where it wasn't possible to set the background colour of a Renko bar to transparent.
Version 26.002
Date: Mon Sep 18 2023
Improvements
- IOrderLineAdapter and IPositionLineAdapter now support positioning with pixel units. The
setLineLength
method in the IOrderLineAdapter (returned by
createOrderLine)
and IPositionLineAdapter
(createPositionLine)
interfaces now support setting the unit to
'pixel'
.- Additionally, when using pixel unit, you can specify a negative number to position from the left edge of the chart instead.
- Added keyboard navigation. Keyboard navigation (activated via alt/opt + z keyboard shortcut) and many other accessability improvements have been added to the library.
- A featureset accessibility (on by default) has been added to control this behaviour.
- Menu name is provided to items_processor (context menu API). items_processor within the context_menu API now includes details about the name of menu, and the ids of the related item (such as the series, drawing, study, order, or position).
- Support more kinds of extended sessions. The library now supports specifying only one of the postmarket or premarket sessions without the other.
Bug Fixes
- On mobile devices, fixed an issue for when scrolling the pricescale with one finger while another one was holding the crosshair.
- Fixed an issue where it wasn't possible to set the background colour of a candle to transparent.
- 52 Week High/Low indicator compatibility with empty supported_resolutions array. Fixes #7884 issue.
- Fixed an issue where any added indicator on the chart couldn't be undone.
- Fixed issue with locking visible time range while resizing chart. When resizing the chart window with percentage right margin, and the
lock_visible_time_range_on_resize
featureset enabled then the visible range wasn't locked correctly. - SuperTrend Indicator Starting Point. The SuperTrend would previously start drawing from zero for the first bar, instead of only drawing the indicator after the initial length (defined in the indicator's inputs) when all the possible data for a symbol has been loaded.
- Changing the LineStyle for a position is again available.
- Styles tab for Pivot Point Standard indicator. Resolved an issue where the style tab for the Pivot Point Standard indicator would not function correctly when the type option was set to 'Floor'.
Other
- Custom Translation Function. The following changes have been made to the custom_translate_function
- The interface name for the options has changed from
TranslateOptions
toCustomTranslateOptions
. - The
plural
field inCustomTranslateOptions
can now be either a single string, or an array of strings. - A third boolean argument is now provided. When this is true then the key provided is already translated.
- The interface name for the options has changed from
Version 26.001
Date: Tue Aug 08 2023
New Features
- Add series and study values to crosshair move event. The
crossHairMoved
subscription now exposes the study and series values in the event object. The values are the same as the values shown in the data window. - Adding a new Floor type for calculating Pivot.
- Add the onHoveredSourceChanged method to the widget API. See
onHoveredSourceChanged
.
Improvements
- Added optional variable_tick_size property to symbol info.
- Added onMoving to the Order Line Adapter. onMoving
Bug Fixes
- Selecting an incorrect symbol within a study no longer prevents the study from recovering when a valid symbol is chosen later.
- Fix drawing tools not affecting undo/redo stack and chart layout saving buttons. Drawing actions can now be undone/redone and will affect the saving of the chart layout
- Disabling the 'open_account_manager' featureset now works as expected.
Other
- Watchlist sections featureset added for adjusting the visibility of the 'Add Section' button. The UI for creating watchlist sections can now be hidden by disabling the watchlist_sections featureset.
Version 26
Date: Tue Jul 18 2023
Breaking Changes
- Remove Lines item and submenu from background and symbol context menu. The "lines" item has been removed from the context menu of the chart and the legend of the main series.
New Features
- In bottom toolbar, tooltip text for date ranges has changed. Hovering over the time frame buttons will provide more details to understand how chart is constructed.
- Add setting for visibility of A (auto) and L (log) scale buttons. In Chart settings, Scale tab, a new setting has been introduced to enable shortcuts for Auto & Logarithmic modes.
- Bug in compare data displayed in Data window. There was an issue where OHLC values would only be displayed in the data window widget when using the cross hair selection instead of displaying the data from the latest available bar if nothing was selected. Fixes #7769
- Update chart maximization icon and remove animation. Maximization button restyled
- Price scale resizing while scrolling chart in mobile browser. When scrolling into history the price scale expands to accommodate the values, but doesn't retract when the values become shorter. This is done to make the scale less twitchy during scrolling. The scale's width is reset on data loading.
Improvements
- Fixed a bug where on some DPR there was no separator between the right widget panel and the order panel. Now the separator line is always visible.
- No bracket settings in chart settings. Bracket settings were added to the Chart settings in the Trading tab.
- Symbol logos within the Legend and Account Manager. Symbol logos can now be displayed within the Legend and the Account Manager panel (Trading Platform Only) if the
show_symbol_logos
featureset is enabled.show_symbol_logo_in_legend
featureset can be disabled to hide the logos within the legend.show_symbol_logo_for_compare_studies
featureset can be disabled to hide the logos within the legend for compare overlay studies.show_symbol_logo_in_account_manager
featureset can be disabled to hide the logos within the Account Manager panel (Trading Platform Only).
- Added setter and getter methods for CSS custom properties defined within the iframe. The widget API now includes setCSSCustomProperty and getCSSCustomPropertyValue methods for controlling CSS custom properties within the chart's iframe element.
Other
- Deprecated properties and methods. The following properties and methods are marked as deprecated and will be removed in the next major release:
customFormatters
in the ChartingLibraryWidgetOptions interface. Usecustom_formatters
instead.customFormatters
andbrokerFactory
in the TradingTerminalWidgetOptions interface. Usecustom_formatters
andbroker_factory
instead.
Version 25.002
Date: Wed Jul 12 2023
New Features
- Add 52 Week High/Low study.
- Enable hiding price scales when all studies or series are hidden. Adds the
hide_price_scale_if_all_sources_hidden
feature. When enabled price scales will be hidden when all studies (or the main series) attached to the price scale are hidden. - Option to always show legend values for studies on mobile. By default, when on mobile, the legend won't display any values for studies.
Enabling this new
always_show_legend_values_on_mobile
featureset allows you to display the values.
Improvements
- Sections can now be added within the Watchlist. Sections dividers can now be added within the watchlist (Trading Platform Only).
- Any item within a list which is prefixed with
###
will be considered a section divider. API Reference
- Any item within a list which is prefixed with
- Symbol and exchange logos can now be shown within the Compare Dialog. The symbol info provided by resolveSymbol should now include 'exchange_logo' if you would like to use the 'show_exchange_logos' featureset.
Bug Fixes
- Watermark API's content provider is now used for all charts within a multi-chart layout.
- Fixed issue with resetData. When resetting the data for a chart, any existing studies would become unlinked from the data source. Fixes #7802
- The
request_only_visible_range_on_reset
featureset now defaults todisabled
.
- The
Version 25.001
Date: Mon Jun 26 2023
Breaking Changes
- price_sources moved to symbol info. To allow price sources resolved on-demand with the associated symbol the
price_sources
property has been removed from the datafeed configuration object and added to the symbol info object.
New Features
- Added Market status state getter. marketStatus method is provided within IChartWidgetApi which returns a watched value of the charts symbols current market status.
- Symbol and exchange logos. It is now possible to specify logo images for symbols and exchanges. These will be visible within the search dialog, and watchlist (Trading Platform). The
show_symbol_logos
andshow_exchange_logos
featuresets should be enabled, and your datafeed should be updated to provide urls as part of the symbol info supplied by theresolveSymbol
method, and results supplied by thesearchSymbols
method. - Enable custom studies to extend the time scale. Enable custom studies to extend the time scale with points that don't exist in the main series.
- Added Custom Symbol Status API. The new Custom Symbol Status API enables the creation and customisation of an additional status to be displayed for the symbol within the legend area.
- The Custom Symbol Status API can be accessed via the
customSymbolStatus
method on the chart widget. - An example is provided on the Symbol Status page.
- The Custom Symbol Status API can be accessed via the
- Featureset added for clearing the price scale on errors. Added new
clear_price_scale_on_error_or_empty_bars
featureset to automatically clear pane price scales when the main series has an error or has no bars. - Adding Anchored VWAP in Trend line tools. A new Trend line tool has been added to the already long list: Anchored VWAP.
Improvements
- Added Watermark API. The new Watermark API enables the customisation of the watermark text in addition to providing WatchedValues for the color and visibility properties.
- The Watermark API can be accessed via the
watermark
method on the chart widget.
- The Watermark API can be accessed via the
- Updated broker API sample to support bracket orders. The sample broker API has been updated to support brackets (stop loss, and take profit) orders. Trading Platform Only
- Drawings in saved charts now restore with the saved settings for lock and disableSelection. The
lock
anddisableSelection
settings for a created shape will now be saved and restored correctly. #6761 - Fullscreen button can now be used to exit fullscreen mode as well. When using the
header_in_fullscreen_mode
featureset, it is now possible to use the fullscreen button to exit fullscreen mode. - Added method to programmatically set the time frame for the active chart. The setTimeFrame method has been added to the widget which can set the time frame in a similar manner to the Timeframes at the bottom of the chart buttons.
- Renaming precision dropdown values in Chart settings. To limit confusion when dealing with the Chart settings/Precision dropdown values, some fractional ones have been renamed to more readable ones.
- Changing Source option in line-break & renko chart. In Trading Platform, it was unnecessary to offer the option to change the source of data for both Renko and Line Break, as the data is taken from the close value.
Bug Fixes
- Timescale marks will adjust correctly when widget theme is changed.
- onAutoSaveNeeded event emitted when removing all drawings via toolbar button.
- removeChart within the save load adapter will await the promise before updating the UI.
- First getBars request after resetting data no longer has a countback of zero.
- Market status pop up text could sometimes display Infinity or NaN values and not update on the dot.
- Fix custom field validators. Fixes a bug where custom broker field validator functions were not called if provided.
- Fixed rendering on price and time axes when a Trend Angle line drawing is selected.
Other
- Changed validation warning message within the close position UI. Message changed from 'Specified value is more than the instrument maximum' to 'The amount entered exceeds the position size'.
- Corrected the strings for the ThemeName type definition. The possible values should have been lowercase: 'dark' & 'light'.
- Moved Session breaks from Events to Appearance tab in chart options. This reverts a breaking change made in
v25.0
. - Adding snippets for Trading Platform datafeed methods. Some functions were lacking an out of the box snippet to use within their application.
Version 25
Date: Mon May 22 2023
Breaking Changes
- Save and Load Chart Templates. Add methods to the save/load adapter to support chart templates.
- Renew design for send order and buy sell buttons. Renew design for send order and buy sell buttons:
- Buttons are now rounded
- Selected item and underline are now black
- New TV logo. What is changing:
- Changing the size, boldness of the text
- Indentation of the logo from the borders of the chart
- One row for grid lines settings. The grid lines settings have been combined into one row.
- Remove magnet icon near cursor - Reverting feature. Following reviews this piece of work was reverted.
- Update the library branding. Branding font and position is slightly changed.
- Do not load Euclid font for the branding logo on chart. The Euclid font will not load if there is an animated logo on the chart.
- When the chart data is reset, the new request for data will only be for the visible range. The previous behavior was that when resetData was evoked, that the datafeed would be requested to provide data for the entire range of data already loaded for that symbol. The new behavior is that the request is now only for the current visible range. This more closely matches the behavior of the first load. If you require the old behavior then you can disable the
request_only_visible_range_on_reset
featureset. - Remove timezone & session breaks section from scale gear menu. Time zone and Session breaks section has been removed from gear menu.
- Update chart types icons. Changed icons for Line, Area and Baseline chart types.
- Move Session breaks from Appearance to Events tab. Session breaks setting is moved to events tab.
- Changed the gear icon. Changed the icon for price scale settings button ('gear' in bottom-right corner).
- Chart navigation buttons. Navigation buttons at the bottom of the chart have a slightly new design.
New Features
- Adding a new chart type HLC Area. HLC Area is a new chart type available.
- Handle variable-tick-size. Added support for variable tick size.
- Add new stats position for info line drawing "auto". Option of automatic positioning of information block for infoline drawings was added "auto" (in addition to existing left, center, right).
- Add new checkboxes for price range in Info Line drawing box. Added 2 settings in linetools context menu:
- Percent change
- Change in pips
- Add ability to move anchors continuously - not by bars. Smooth resizing of icons, stickers and emojis was implemented.
- Correct Chart settings text Price scale labels. "LABELS" group in "Scales" tab of Chart settings has been renamed to "LABELS ON PRICE SCALE".
- Show + button on cursor by hotkey. Added hotkeys Alt+Ctrl (win) or Opt+Command (mac) for the appearance of the plus button under the cursor.
- Add Data window item to context/legend three dots menu. Added new item to context/legend three dots menu - "Data window..." with a shortcut. Opens Data Window in the right panel.
- Add Volume profile indicators on the top of chart series. Changed the default z-order for Volume Profile indicators and VP drawings. They are now located above the main series.
- Added new time zone Anchorage Alaska. Added new time zone Anchorage Alaska (UTC-9).
- Separate chart types Line with markers and Stepline. Step line and Line with markers types are added to the top toolbar chart types menu.
- Added new time zone Casablanca. Timezone Casablanca (UTC) has been added.
- Try to load line tools code dynamically. Fixed floating toolbar for Price Note to show color and text settings like for other drawings.
- Add sticker drawing tool. Add the ability to use stickers with
createMultipointShape
orselectLineTool
. - Add Accelerator Oscillator indicator.
Improvements
- Theming support for pop-up menus. Additional CSS custom properties have been added for styling pop-up menus. Pop-up (as known as 'pop-over') menus include toolbar menus, and context menus. See the full list of CSS custom properties in the CSS Color Themes article.
- Add date and time input UI for custom studies. Custom studies now support defining inputs of the
'time'
type and having a GUI element (date and time pickers) in the indicators settings dialog window. - setActiveChart added to the Widget API. The currently active chart in a multi-chart layout (available on Trading Platform only) can now be changed using the
setActiveChart
method. more info
Bug Fixes
- Include missing PriceAxisLastValueMode and LineStyle enums in type documentation.
Documentation
- The Overrides article update. We have updated the Overrides article. Now it contains general information about the Overrides API. For information on how to customize elements on the chart, refer to a new Chart Overrides article.
Version 24.004
Date: Mon Apr 24 2023
New Features
- Indicators can now be favorited. Indicators can now be favorited by tapping on the star icon to the left of the
indicator name. Favorited indicators will appear at the top of the indicator
list.
- The
items_favoriting
featureset should be enabled. more info
- The
- Adding two featuresets to hide the right_toolbar or its tabs. There are 2 new featuresets
hide_right_toolbar
&hide_right_toolbar_tabs
plus an additional WidgetBar API changeWidgetBarVisibility to control the right toolbar.hide_right_toolbar
allows you to instantiate the toolbar without showing it in the UI.hide_right_toolbar_tabs
will do the same with the exception of not showing tabs when displaying the right toolbar.
Improvements
- Added a middle band for the RSI indicator. Unlike on tradingview.com RSI was not presenting the option to plot a middle limit.
- Indicators favorites can now be defined within widget constructor. Indicators can now be defined as favorites using the
favorites
property of the widget constructor options. See Favorites.indicators for more information. - Add a way to independently clear bar marks/timescale marks.
clearMarks
method has been enhanced to pass in an option to choose which marks should be cleared on the chart.- By default behaviour will remain similar and both bar & TimeScale marks will be removed.
- Passing
ClearMarksMode.BarMarks
will only remove bar marks. - Passing
ClearMarksMode.TimeScaleMarks
will only remove TimeScale marks.
BREAKING CHANGE
Discrepancy in chart style/type methods. Only TypeScript breaking change as an interface has been renamed to better reflect its purpose.SeriesStyle
is now SeriesType.
Bug Fixes
- load_study_template event is not emitted. load_study_template event was not emitted when applying a template on the chart.
- Fixed autosize bug occurring on Chrome iOS when rotating the device. Workaround fix for a browser bug until Chrome resolves the issue on their side.
- Fixed the type definitions for a few of the PineJS Std library functions. PineJSStd documentation.
Documentation
- New Key Features article. We have added the Key Features article that lists features supported/unsupported in Advanced Charts and Trading Platform.
- How to connect data via Datafeed API. We have added a new tutorial on connecting data via Datafeed API. It will help you implement datafeed and real-time data streaming to the library step-by-step.
Other
- Incorrect watermark property key. Deprecated
symbolWatermarkProperties
property has now been removed. Please use settings_adapter withsymbolWatermark
key instead orapplyOverrides
to change values.
Version 24.003
Date: Tue Apr 11 2023
New Features
- Images within bar marks. Bar marks now support the rendering of images as the background by specifying the
imageUrl
property. Please see the Mark interface for more details. - Price Source and Long Description symbol info fields. Add support for displaying the price source and long description fields from the symbol info.
- To enable the price source first add
symbol_info_price_source
to the list of enabled features. Then it will be shown in the legend, if available. It can be hidden through the legend context menu and the series property dialog. - To enable the long description first add
symbol_info_long_description
to the list of enabled features. Then it will be shown in the legend, if available. It can be hidden through the legend context menu and the series property dialog.
- To enable the price source first add
Improvements
- Added more styling options for bar marks. The styling options for bar marks has been expanded to include options for styling the border.
- Border color can be set using the
border
property withincolor
of the Mark interface. See MarkCustomColor - Border width can be set using
borderWidth
andhoveredBorderWidth
. See Mark
- Border color can be set using the
- Drawing tools favorites can now be defined within widget constructor. Drawing tools can now be defined as favorites using the
favorites
property of the widget constructor options. See Favorites.drawingTools for more information. - Context menu API can now be used within the Watchlist.
watchlist_context_menu
featureset is enabled by default. See onContextMenu for more details. - Improved typings within package.json. The
package.json
bundled with the library has been improved to support newer versions of node, and offer improved typings. See NPM for more details. - Price scale now supports numbers with more than 10 decimal points.
- Timezone data has been updated.
Bug Fixes
- Chart type won't change when restoring default options. The chart type will no longer change when restoring the default options within the chart settings dialog.
- Last visible bar value in legend for overlay studies. When
use_last_visible_bar_value_in_legend
featureset is enabled, overlay studies will display the value for the last visible item on the chart. This now matches the behavior for the main series. - Fixed zoom behavior for percentage right margin option. Incorrect zooming behavior has been fixed for zoom buttons appearing on the chart, and the keyboard shortcuts. See
show_percent_option_for_right_margin
featureset for more information.
Documentation
- Add FAQ about unsubscribeBars delay. Added a new FAQ about
unsubscribeBars
being called with a delay.
Other
- Added symbol information to datafeed error messages. Added symbol information to realtime subscription error messages to improve the developer experience.
- Updated localisation list. The list of support localisations has been updated. Additionally, the chart will now fallback to english (with a console warning) if an unsupported locale is specified in the widget constructor options.
Version 24.002
New Features
- Added support for specifying custom timezones.
- Additional custom timezones can now be specified for use within the library. Please see the Adding Custom Timezones section within the Timezones page.
- Images within timescale marks.
- Timescale marks now support the rendering of images within the circular shape by specifying the
imageUrl
property. Please see the TimescaleMark interface for more details.
- Timescale marks now support the rendering of images within the circular shape by specifying the
- Support different margin rates for different order types. 6607
marginRate
has been deprecated- A
supportLeverageButton
flag that displays a leverage button has been added to the Broker configuration. - The
supportLeverage
flag enables leverage calculation by getting information fromleverageInfo
.
Enhancements
- Add horizontal line at 0 for Momentum study.
Bug fixes
setUserEditEnabled
does not hide 3 dots in Legend. 6765 | 6165widget.activeChart().getAllStudies().forEach(({ id }) => {
console.log(id);
tvWidget.activeChart().getStudyById(id).setUserEditEnabled(false);
});- setUserEditEnabled(false) should mask all icons except the "eye".
- setUserEditEnabled(true) should restore all the icons.
priceFormatter
could previously only be used for main series.priceFormatter
now applies to secondary series as well.right_toolbar
featureset didn't have a defaulton
value.Empty time frames at the bottom toolbar if
data_status: endofday
Export data doesn’t include projected data.
- Projected data can be included by setting
includeOffsetStudyValues
totrue
. await widget.activeChart().exportData({ includeOffsetStudyValues: true });
- Projected data can be included by setting
Highest PineJS.Std function doesn’t work correctly with negative numbers.
Exposing
icon
prop inCreateShapeOptionsBase
. 6723Wrong extended session background color 7443
Documentation
- Added migration guide from Advanced Charts to Trading Platform.
- Added additional documentation for Drawings.
- Missing overrides in documentation. 7457
- Updated documentation for Marks.
- Align ChartMetaInfo & ChartData.
Other
- Removed
Australia/ACT
from the list of timezones within our documentation. Please use either the Sydney timezone or specify your own custom timezone.
Version 24.001
New Features
- Adding originalText as an additional field to UndoRedoState. Event should mention the name of the action in plain English in addition to also being translated to the corresponding language. UndoRedoState
- Add the ability to change X-Axis margin % from Chart Properties. A new featureset has been added
show_percent_option_for_right_margin
that adds additional percentage option to the right margin section of the chart settings dialog. - Display rightmost visible value when in percent mode. A new featureset has been added
use_last_visible_bar_value_in_legend
to show the most recent “global” bar value. When this feature is enabled the rightmost bar in the visible range is used instead. - Ability to change on the fly the Currency and Unit label setting. currencyAndUnitVisibility API
- Add simple SSR support. Allow the library to be imported within a NodeJS context. This improves support for frameworks such as Remix.
- Added
clearUndoHistory
.
Improvements
- Name to be used instead of ticker. Allow a human friendly name to be returned from
symbol_search_complete
.
Bug Fixes
- Incomplete indicators when using Heikin-Ashi. Indicator line should draw to all the visible data points.
- Compare study doesn’t save and restore ticker name correctly. The compare study should work for custom ticker names just like it does for ticker names which match our format (with the colon).
- VPFR: Right point is automatically moving when dragging start point. When drawing the VPFR, or moving one of the anchor points, it is expected that the right anchor point should not move one bar further to the right.
- Selecting Apply Defaults option within chart settings doesn’t work. Some Settings even if not validated are not restored to their original values when Apply Defaults is selected.
- Decentralised app browser loading error. Chart fails to load in wallet apps like MetaMask, Trust & Phantom. Enable the
iframe_loading_compatibility_mode
featureset to enable compatibility with these browsers. - When disabled, widget bar still present a significant margin. Even when there aren't any pages or widget in the right toolbar and IF right_toolbar is disabled, contrary to the drawing toolbar that vanishes the widget bar stays there with the pill button to expand it whereas there isn't anything to expand.
- Can’t enable header_compare feature without header_symbol_search.
- Disabling header_symbol_search should only hide the search button
- Disabling header_compare should only hide the compare button
- Removed section of PostCSS syntax in bundled css files.
Other
- New Documentation site. 🎉
- Add
shape
to TimeScale. Shape property is described in TimescaleMark interface. - Remove magnet icon near cursor.
Version 24
preset
Widget-Constructor parameter has been removed. Users can still use some featuresets to mimic the same behavior by disabling the following list:'left_toolbar', 'header_widget', 'timeframes_toolbar', 'edit_buttons_in_legend', 'context_menus', 'control_bar', 'border_around_the_chart'
chart_style_hilo
featureset is now enabled by default. This adds the High-low option to chart style controls dropdown. This featureset has been available since 1.15 but was previously disabled by default.- Added typings for custom indicators. Typescript equivalents of our existing examples are available here: Custom Studies Typescript Examples.
symbol_search_complete
has changed. The function now takes an additional search result object parameter, and returns an additional human-friendly symbol name.- Mark tooltips do not support HTML anymore.
UI changes
With this version you will notice that the top toolbar has been redesigned with the following changes:
- Button padding & separator size have been reduced
- Compare button has shifted next to Symbol
- Drawing icon is now more prominent
- New fullscreen icon
- Save button style better highlights when there's a change
- Top toolbar now extends to left & right edges
- UI font changes to a default system one
- Undo/redo buttons are now relocated next to the save button
Trading Platform
- Default formatter
textNoWrap
has been removed. columnId
field of SortingParameters has been renamed toproperty
.- Required
id
field has been added to column description. - Type of
formatter
field in column description has been changed to StandardFormatterName | FormatterName. property
field has been removed fromcolumn description
. Use dataFields field instead.- Type of
formatter
field in SummaryField has been changed to StandardFormatterName.
Version 23
Average close price line
is now masked by default in Chart settings and can be shown by usingshow_average_close_price_line_and_label
featureset.
Version 22
Methods getTimezone and setTimezone have been deprecated and will be removed in future versions. Use getTimezoneApi instead.
POST request data format sent to snapshot_url has been changed. Since this version this request contains
multipart/form-data
with the fieldpreparedImage
that represents binary data of the snapshot image inimage/png
format.Optional
inputs
arguments for createStudy has been changed from using an array of ordered values to an object with named properties. You can still use array-like inputs but it will be removed in further releases.The set of inputs for Moving Average study has been changed and the first input now is a symbol. If you used
createStudy
to create Moving Average study you will have to modify the list of inputs by simply adding an empty string as the first element:tvWidget.activeChart().createStudy('Moving Average', true, false, ['', 9]);
instead of
tvWidget.activeChart().createStudy('Moving Average', true, false, [9]);
Study
Ichimoku
has been modified with someInputs
&Style
properties renamed.Both
scrollPosition
anddefaultScrollPosition
from Chart-Methods have been deprecated in favour of rightOffset and defaultRightOffset accordingly.The
rest.html
file anddatafeeds/rest
directory have been removed.When subscribed to
drawing_event
aclick
is no longer emitted when a drawing is created. Acreate
event is emitted instead.Study
True Strength Indicator
has been renamed toTrue Strength Index
and modified with its style elements being properly named with 1stPlot
becomingTrue Strength Index
& secondPlot
becomingSignal
.
Trading Platform
The
watchList
method now returns a promise that resolves a watchlist API object when the watchlist widget has loaded.suggestedQty
has been removed from theTrading Host
.dome_widget
featureset which controls the DOM widget visibility has be deprecated in favour ofdom_widget
.
Version 21
Featureset
show_dialog_on_snapshot_ready
has been removed. takeScreenshot makes a snapshot silently, so you can use the URL from onScreenshotReady callback to show your own dialog instead.Field
holidays
from SymbolInfo has been renamed tosession_holidays
.changeTheme
from Widget Methods now returns a Promise. You can apply other style modifications after the promise is fulfilled.Symbol type
bitcoin
has been renamed tocrypto
.The symbol search dialog suggestions list uses the
full_name
instead of theexchange
andsymbol
value. This data is provided by your implementation of searchSymbols.
Trading Platform
supportModifyOrder
flag has been marked deprecated and will be removed in future versions. UsesupportModifyOrderPrice
,supportEditAmount
andsupportModifyBrackets
instead.empty
formatter has been removed.Flag
durationForMarketOrders
has been removed from Broker ConfigurationconfigFlags
object. To use duration with market orders, add appropriate order type tosupportedOrderTypes
array.supportReducePosition
flag has been removed from the Broker ConfigurationconfigFlags
object.supportExecutions
flag has been added. If broker supports executions you need to set the flag totrue
.The default value of
asc
field of the SortingParameters has been changed totrue
.The
customFormatters
field has been removed from the accountManagerInfo.id
,modificationProperty
,fixedWidth
,showOnMobile
andshowTooltipOnCell
fields have been removed from the Account Managercolumn description
. Theproperty
field has been made mandatory, so you can use it instead ofid
.The string
id
field has been made mandatory in eachtable
(Account Manager) row.The return value of the method
placeOrder
in the Broker API has been changed fromPromise<void>
toPromise<PlaceOrderResult>
.contextMenuEvent
type incontextMenuActions
inAccountManagerInfo
interface has been changed fromMouseEvent
toMouseEvent | TouchEvent
.The shape of the
news_provider
property in the Widget Constructor options has changed. Theis_news_generic
andget_news
properties have been replaced with a single function.