Skip to main content
Version: v27

Charting Library

TradingView Advanced Charts

Enumerations

Interfaces

Type Aliases

AccountId

Type

Nominal<string, "AccountID">


AccountManagerColumn

Type

{ [K in StandardFormatterName | FormatterName]: AccountManagerColumnBase<K> }[StandardFormatterName | FormatterName]


ActionMetaInfo

Describes a single action to put it into a dropdown or a context menu.

Type

ActionDescriptionWithCallback | MenuSeparator


AskBid

The Ask and Bid quotes.

Type

Required<Pick<TradingQuotes, "ask" | "bid">>


AvailableSaveloadVersions

Type

"1.0" | "1.1"


CellAlignment

Type

"left" | "right"


ChartActionId

A chart action ID.

Type

"chartProperties" | "compareOrAdd" | "scalesProperties" | "paneObjectTree" | "insertIndicator" | "symbolSearch" | "changeInterval" | "timeScaleReset" | "chartReset" | "seriesHide" | "studyHide" | "lineToggleLock" | "lineHide" | "scaleSeriesOnly" | "drawingToolbarAction" | "stayInDrawingModeAction" | "hideAllMarks" | "showCountdown" | "showSeriesLastValue" | "showSymbolLabelsAction" | "showStudyLastValue" | "showStudyPlotNamesAction" | "undo" | "redo" | "paneRemoveAllStudiesDrawingTools" | "showSymbolInfoDialog"


ChartDescriptorFunction

Function to provide a description of the chart described by the context data

Type

(context: ChartDescriptionContext) => Promise<string | null>

Type declaration

Signature

(context: ChartDescriptionContext) => Promise<string | null>
Parameters
NameType
contextChartDescriptionContext
Returns

Promise<string | null>


ChartTypeFavorites

Chart type names for use within the favorites Widget Constructor option. This type is for Advanced Charts, if you are looking for the Trading Platform type then please see TradingTerminalChartTypeFavorites.

See Favorites for the Widget Constructor option where you can define these favorites, and ChartingLibraryWidgetOptions.favorites for the Widget Constructor option.

Type

"Area" | "Bars" | "Candles" | "Heiken Ashi" | "Hollow Candles" | "Line" | "Line Break" | "Baseline" | "LineWithMarkers" | "Stepline" | "Columns" | "High-low"


ChartingLibraryFeatureset

This is the list of all featuresets that work in Advanced Charts

Type

"use_localstorage_for_settings" | "items_favoriting" | "save_chart_properties_to_local_storage" | "create_volume_indicator_by_default" | "create_volume_indicator_by_default_once" | "volume_force_overlay" | "right_bar_stays_on_scroll" | "constraint_dialogs_movement" | "charting_library_debug_mode" | "side_toolbar_in_fullscreen_mode" | "header_in_fullscreen_mode" | "disable_resolution_rebuild" | "chart_scroll" | "chart_zoom" | "horz_touch_drag_scroll" | "vert_touch_drag_scroll" | "mouse_wheel_scroll" | "pressed_mouse_move_scroll" | "mouse_wheel_scale" | "pinch_scale" | "axis_pressed_mouse_move_scale" | "low_density_bars" | "uppercase_instrument_names" | "no_min_chart_width" | "fix_left_edge" | "lock_visible_time_range_on_resize" | "shift_visible_range_on_new_bar" | "custom_resolutions" | "end_of_period_timescale_marks" | "cropped_tick_marks" | "study_overlay_compare_legend_option" | "study_symbol_ticker_description" | "auto_enable_symbol_labels" | "insert_indicator_dialog_shortcut" | "two_character_bar_marks_labels" | "confirm_overwrite_if_chart_layout_with_name_exists" | "determine_first_data_request_size_using_visible_range" | "move_logo_to_main_pane" | "study_templates" | "datasource_copypaste" | "seconds_resolution" | "tick_resolution" | "secondary_series_extend_time_scale" | "header_widget" | "header_symbol_search" | "symbol_search_hot_key" | "header_resolutions" | "show_interval_dialog_on_key_press" | "header_chart_type" | "header_settings" | "header_indicators" | "header_compare" | "header_undo_redo" | "header_quick_search" | "header_screenshot" | "header_fullscreen_button" | "border_around_the_chart" | "header_saveload" | "left_toolbar" | "control_bar" | "timeframes_toolbar" | "legend_widget" | "display_legend_on_all_charts" | "object_tree_legend_mode" | "edit_buttons_in_legend" | "show_hide_button_in_legend" | "format_button_in_legend" | "delete_button_in_legend" | "context_menus" | "pane_context_menu" | "scales_context_menu" | "legend_context_menu" | "main_series_scale_menu" | "display_market_status" | "remove_library_container_border" | "property_pages" | "show_chart_property_page" | "chart_property_page_scales" | "chart_property_page_trading" | "chart_property_page_right_margin_editor" | "countdown" | "dont_show_boolean_study_arguments" | "hide_last_na_study_output" | "symbol_info" | "timezone_menu" | "snapshot_trading_drawings" | "source_selection_markers" | "go_to_date" | "adaptive_logo" | "show_dom_first_time" | "hide_left_toolbar_by_default" | "chart_style_hilo" | "chart_style_hilo_last_price" | "pricescale_currency" | "pricescale_unit" | "scales_date_format" | "popup_hints" | "save_shortcut" | "show_right_widgets_panel_by_default" | "show_object_tree" | "show_spread_operators" | "hide_exponentiation_spread_operator" | "hide_reciprocal_spread_operator" | "compare_symbol_search_spread_operators" | "studies_symbol_search_spread_operators" | "hide_resolution_in_legend" | "hide_unresolved_symbols_in_legend" | "show_zoom_and_move_buttons_on_touch" | "hide_main_series_symbol_from_indicator_legend" | "hide_price_scale_global_last_bar_value" | "show_average_close_price_line_and_label" | "hide_image_invalid_symbol" | "hide_object_tree_and_price_scale_exchange_label" | "scales_time_hours_format" | "use_na_string_for_not_available_values" | "pre_post_market_sessions" | "show_percent_option_for_right_margin" | "lock_visible_time_range_when_adjusting_percentage_right_margin" | "iframe_loading_compatibility_mode" | "use_last_visible_bar_value_in_legend" | "symbol_info_long_description" | "symbol_info_price_source" | "chart_template_storage" | "request_only_visible_range_on_reset" | "clear_price_scale_on_error_or_empty_bars" | "legend_inplace_edit" | "show_symbol_logos" | "show_exchange_logos" | "show_symbol_logo_in_legend" | "show_symbol_logo_for_compare_studies" | "always_show_legend_values_on_mobile" | "studies_extend_time_scale" | "accessible_keyboard_shortcuts" | "accessibility" | "aria_detailed_chart_descriptions" | "aria_crosshair_price_description" | "saveload_separate_drawings_storage" | "disable_pulse_animation"


ColorTypes

These are defining the types for a background

Type

"solid" | "gradient"


ContextMenuItemsProcessor

Context menu items processor signature

Type

(items: readonly IActionVariant[], actionsFactory: ActionsFactory, params: CreateContextMenuParams) => Promise<readonly IActionVariant[]>

Type declaration

Signature

(items: readonly IActionVariant[], actionsFactory: ActionsFactory, params: CreateContextMenuParams) => Promise<readonly IActionVariant[]>
Parameters
NameTypeDescription
itemsreadonly IActionVariant[]an array of items the library wants to display
actionsFactoryActionsFactoryfactory you could use to create a new items for the context menu.
paramsCreateContextMenuParamsan object representing additional information about the context menu, such as the menu name.
Returns

Promise<readonly IActionVariant[]>


ContextMenuRendererFactory

Type

(items: readonly IActionVariant[], params: CreateContextMenuParams, onDestroy: () => void) => Promise<IContextMenuRenderer | null>

Type declaration

Signature

(items: readonly IActionVariant[], params: CreateContextMenuParams, onDestroy: Function) => Promise<IContextMenuRenderer | null>
Parameters
NameTypeDescription
itemsreadonly IActionVariant[]an array of items the library wants to display
paramsCreateContextMenuParamsan object representing where the user right-clicked on (only if there is an existing menu)
onDestroy() => voidfunction that you should call once a created menu is hidden/destroyed
Returns

Promise<IContextMenuRenderer | null>


CreateButtonOptions

Type

CreateHTMLButtonOptions | CreateTradingViewStyledButtonOptions


CustomStudyFormatter

Type

Omit<INumberFormatter, "parse">


CustomStudyFormatterFactory

Factory function that can be implemented to create custom study formatters.

Type

(format: CustomStudyFormatterFormat, symbolInfo: LibrarySymbolInfo | null, precision: string | undefined) => CustomStudyFormatter | null

Type declaration

Signature

(format: CustomStudyFormatterFormat, symbolInfo: LibrarySymbolInfo | null, precision: string | undefined) => CustomStudyFormatter | null
Parameters
NameType
formatCustomStudyFormatterFormat
symbolInfoLibrarySymbolInfo | null
precisionstring | undefined
Returns

CustomStudyFormatter | null


CustomTableFormatElementFunction

A function that takes an TableFormatterInputs object and returns a string or an HTMLElement.

Type

(inputs: TableFormatterInputs<T>) => undefined | string | HTMLElement

Type parameters

NameType
Textends TableFormatterInputValues = TableFormatterInputValues

Type declaration

Signature

(inputs: TableFormatterInputs<T>) => undefined | string | HTMLElement
Parameters
NameType
inputsTableFormatterInputs<T>
Returns

undefined | string | HTMLElement


CustomTimezoneId

Identifier for a custom timezone (string).

Type

Nominal<"CustomTimezoneId", string>


CustomTimezones

Type

"Africa/Cairo" | "Africa/Casablanca" | "Africa/Johannesburg" | "Africa/Lagos" | "Africa/Nairobi" | "Africa/Tunis" | "America/Anchorage" | "America/Argentina/Buenos_Aires" | "America/Bogota" | "America/Caracas" | "America/Chicago" | "America/El_Salvador" | "America/Juneau" | "America/Lima" | "America/Los_Angeles" | "America/Mexico_City" | "America/New_York" | "America/Phoenix" | "America/Santiago" | "America/Sao_Paulo" | "America/Toronto" | "America/Vancouver" | "Asia/Almaty" | "Asia/Ashkhabad" | "Asia/Bahrain" | "Asia/Bangkok" | "Asia/Chongqing" | "Asia/Colombo" | "Asia/Dhaka" | "Asia/Dubai" | "Asia/Ho_Chi_Minh" | "Asia/Hong_Kong" | "Asia/Jakarta" | "Asia/Jerusalem" | "Asia/Karachi" | "Asia/Kathmandu" | "Asia/Kolkata" | "Asia/Kuwait" | "Asia/Manila" | "Asia/Muscat" | "Asia/Nicosia" | "Asia/Qatar" | "Asia/Riyadh" | "Asia/Seoul" | "Asia/Shanghai" | "Asia/Singapore" | "Asia/Taipei" | "Asia/Tehran" | "Asia/Tokyo" | "Asia/Yangon" | "Atlantic/Reykjavik" | "Australia/Adelaide" | "Australia/Brisbane" | "Australia/Perth" | "Australia/Sydney" | "Europe/Amsterdam" | "Europe/Athens" | "Europe/Belgrade" | "Europe/Berlin" | "Europe/Bratislava" | "Europe/Brussels" | "Europe/Bucharest" | "Europe/Budapest" | "Europe/Copenhagen" | "Europe/Dublin" | "Europe/Helsinki" | "Europe/Istanbul" | "Europe/Lisbon" | "Europe/London" | "Europe/Luxembourg" | "Europe/Madrid" | "Europe/Malta" | "Europe/Moscow" | "Europe/Oslo" | "Europe/Paris" | "Europe/Prague" | "Europe/Riga" | "Europe/Rome" | "Europe/Stockholm" | "Europe/Tallinn" | "Europe/Vienna" | "Europe/Vilnius" | "Europe/Warsaw" | "Europe/Zurich" | "Pacific/Auckland" | "Pacific/Chatham" | "Pacific/Fakaofo" | "Pacific/Honolulu" | "Pacific/Norfolk" | "US/Mountain"


CustomTranslateFunction

Custom translation function

Type

(key: string, options?: CustomTranslateOptions, isTranslated?: boolean) => string | null

Type declaration

Signature

(key: string, options?: CustomTranslateOptions, isTranslated?: boolean) => string | null
Parameters
NameTypeDescription
keystringkey for string to be translated
options?CustomTranslateOptionsadditional translation options
isTranslated?booleanTrue, if the provide key is already translated
Returns

string | null


DOMCallback

Type

(data: DOMData) => void

Type declaration

Signature

(data: DOMData) => void
Parameters
NameType
dataDOMData
Returns

void


DateFormat

Type

keyof typeof dateFormatFunctions


DeepWriteable

Type

{ -readonly [P in keyof T]: DeepWriteable<T[P]> }

Type parameters

Name
T

Direction

The direction of an execution line. Either buy or sell.

Type

"buy" | "sell"


DrawingEventType

A event related to a drawing.

  • Note that the properties_changed event can be emitted before create event, and that the event isn't debounced (for example dragging a slider for a property will result in this event firing for each movement on the slider), you may want to debounce this within your code.
  • The move event is emitted when a drawing is moved as a whole, whilst the points_changed event is emitted when a single point of the drawing is moved. points_changed will always fire when move fires but not vice-versa.

Type

"click" | "move" | "remove" | "hide" | "show" | "create" | "properties_changed" | "points_changed"


DrawingOverrides

Override properties for drawings. Refer to the Drawing Overrides article for information on how to customize drawings.

The following constants are used within the default properties. You cannot use these names directly.

  • LINESTYLE
    • SOLID = 0
    • DOTTED = 1
    • DASHED = 2
    • LARGE_DASHED = 3
  • LINEEND
    • NORMAL = 0
    • ARROW = 1
    • CIRCLE = 2
  • MODE
    • BARS = 0
    • LINE = 1
    • OPENCLOSE = 2;
    • LINEOPEN = 3;
    • LINEHIGH = 4;
    • LINELOW = 5;
    • LINEHL2 = 6;
  • PITCHFORK_STYLE
    • ORIGINAL = 0
    • SCHIFF = 1
    • SCHIFF2 = 2
    • INSIDE = 3
  • STATS_POSITION
    • LEFT = 0
    • CENTER = 1
    • RIGHT = 2
  • RISK_DISPLAY_MODE
    • PERCENTAGE = 'percents'
    • MONEY = 'money'

Type

FivepointspatternLineToolOverrides | AbcdLineToolOverrides | AnchoredvwapLineToolOverrides | ArcLineToolOverrides | ArrowLineToolOverrides | ArrowmarkdownLineToolOverrides | ArrowmarkerLineToolOverrides | ArrowmarkleftLineToolOverrides | ArrowmarkrightLineToolOverrides | ArrowmarkupLineToolOverrides | BalloonLineToolOverrides | BarspatternLineToolOverrides | BeziercubicLineToolOverrides | BezierquadroLineToolOverrides | BrushLineToolOverrides | CalloutLineToolOverrides | CircleLineToolOverrides | CommentLineToolOverrides | CrosslineLineToolOverrides | CypherpatternLineToolOverrides | DisjointangleLineToolOverrides | ElliottcorrectionLineToolOverrides | ElliottdoublecomboLineToolOverrides | ElliottimpulseLineToolOverrides | ElliotttriangleLineToolOverrides | ElliotttriplecomboLineToolOverrides | EllipseLineToolOverrides | EmojiLineToolOverrides | ExecutionLineToolOverrides | ExtendedLineToolOverrides | FibchannelLineToolOverrides | FibcirclesLineToolOverrides | FibretracementLineToolOverrides | FibspeedresistancearcsLineToolOverrides | FibspeedresistancefanLineToolOverrides | FibtimezoneLineToolOverrides | FibwedgeLineToolOverrides | FlagmarkLineToolOverrides | FlatbottomLineToolOverrides | GanncomplexLineToolOverrides | GannfanLineToolOverrides | GannfixedLineToolOverrides | GannsquareLineToolOverrides | GhostfeedLineToolOverrides | HeadandshouldersLineToolOverrides | HighlighterLineToolOverrides | HorzlineLineToolOverrides | HorzrayLineToolOverrides | IconLineToolOverrides | ImageLineToolOverrides | InfolineLineToolOverrides | InsidepitchforkLineToolOverrides | NoteLineToolOverrides | NoteabsoluteLineToolOverrides | OrderLineToolOverrides | ParallelchannelLineToolOverrides | PathLineToolOverrides | PitchfanLineToolOverrides | PitchforkLineToolOverrides | PolylineLineToolOverrides | PositionLineToolOverrides | PredictionLineToolOverrides | PricelabelLineToolOverrides | ProjectionLineToolOverrides | RayLineToolOverrides | RectangleLineToolOverrides | RegressiontrendLineToolOverrides | RiskrewardlongLineToolOverrides | RiskrewardshortLineToolOverrides | RotatedrectangleLineToolOverrides | SchiffpitchforkLineToolOverrides | Schiffpitchfork2LineToolOverrides | SignpostLineToolOverrides | SinelineLineToolOverrides | StickerLineToolOverrides | TextLineToolOverrides | TextabsoluteLineToolOverrides | ThreedriversLineToolOverrides | TimecyclesLineToolOverrides | TrendangleLineToolOverrides | TrendbasedfibextensionLineToolOverrides | TrendbasedfibtimeLineToolOverrides | TrendlineLineToolOverrides | TriangleLineToolOverrides | TrianglepatternLineToolOverrides | VertlineLineToolOverrides


DrawingToolIdentifier

Type

"arrow" | "cursor" | "dot" | "eraser" | "LineTool5PointsPattern" | "LineToolABCD" | "LineToolArc" | "LineToolArrow" | "LineToolArrowMarkDown" | "LineToolArrowMarker" | "LineToolArrowMarkLeft" | "LineToolArrowMarkRight" | "LineToolArrowMarkUp" | "LineToolBarsPattern" | "LineToolBezierCubic" | "LineToolBezierQuadro" | "LineToolBrush" | "LineToolCallout" | "LineToolCircle" | "LineToolCircleLines" | "LineToolComment" | "LineToolCrossLine" | "LineToolCypherPattern" | "LineToolDateAndPriceRange" | "LineToolDateRange" | "LineToolDisjointAngle" | "LineToolElliottCorrection" | "LineToolElliottDoubleCombo" | "LineToolElliottImpulse" | "LineToolElliottTriangle" | "LineToolElliottTripleCombo" | "LineToolEllipse" | "LineToolExtended" | "LineToolFibChannel" | "LineToolFibCircles" | "LineToolFibRetracement" | "LineToolFibSpeedResistanceArcs" | "LineToolFibSpeedResistanceFan" | "LineToolFibSpiral" | "LineToolFibTimeZone" | "LineToolFibWedge" | "LineToolFixedRangeVolumeProfile" | "LineToolFlagMark" | "LineToolFlatBottom" | "LineToolGannComplex" | "LineToolGannFan" | "LineToolGannFixed" | "LineToolGannSquare" | "LineToolGhostFeed" | "LineToolHeadAndShoulders" | "LineToolHighlighter" | "LineToolHorzLine" | "LineToolHorzRay" | "LineToolInfoLine" | "LineToolInsidePitchfork" | "LineToolNote" | "LineToolNoteAbsolute" | "LineToolParallelChannel" | "LineToolPath" | "LineToolPitchfan" | "LineToolPitchfork" | "LineToolPolyline" | "LineToolPrediction" | "LineToolPriceLabel" | "LineToolPriceNote" | "LineToolPriceRange" | "LineToolProjection" | "LineToolRay" | "LineToolRectangle" | "LineToolRegressionTrend" | "LineToolRiskRewardLong" | "LineToolRiskRewardShort" | "LineToolRotatedRectangle" | "LineToolSchiffPitchfork" | "LineToolSchiffPitchfork2" | "LineToolSignpost" | "LineToolSineLine" | "LineToolText" | "LineToolTextAbsolute" | "LineToolThreeDrivers" | "LineToolTimeCycles" | "LineToolTrendAngle" | "LineToolTrendBasedFibExtension" | "LineToolTrendBasedFibTime" | "LineToolTrendLine" | "LineToolTriangle" | "LineToolTrianglePattern" | "LineToolVertLine"


Dropdown options which can be adjusted on an existing menu.

Type

Partial<Omit<DropdownParams, "align">>


EditObjectDialogObjectType

Type

"mainSeries" | "drawing" | "study" | "other"


EmptyCallback

Type

() => void

Type declaration

Signature

() => void
Returns

void


EntityId

Type

Nominal<string, "EntityId">


ErrorCallback

Type

(reason: string) => void

Type declaration

Signature

(reason: string) => void
Parameters
NameType
reasonstring
Returns

void


FieldDescriptor

Description of each field of exported data from the chart

Type

TimeFieldDescriptor | UserTimeFieldDescriptor | SeriesFieldDescriptor | StudyFieldDescriptor


FinancialPeriod

Type

"FY" | "FQ" | "FH" | "TTM"


FormatterName

Type

Nominal<string, "FormatterName">


GetMarksCallback

Type

(marks: T[]) => void

Type parameters

Name
T

Type declaration

Signature

(marks: T[]) => void
Parameters
NameType
marksT[]
Returns

void


GetNewsFunction

Type

(symbol: string, callback: (response: GetNewsResponse) => void) => void

Type declaration

Signature

(symbol: string, callback: Function) => void
Parameters
NameType
symbolstring
callback(response: GetNewsResponse) => void
Returns

void


GmtTimezoneId

GMT timezone ID.

In order to conform with the POSIX style, those zone names beginning with "Etc/GMT" have their sign reversed from the standard ISO 8601 convention. In the "Etc" area, zones west of GMT have a positive sign and those east have a negative sign in their name (e.g "Etc/GMT-14" is 14 hours ahead of GMT).

Type

\Etc/GMT${"+" | "-"}${number}${\:${number}\ | ""}\


GroupLockState

Type

"Locked" | "Unlocked" | "Partial"


GroupVisibilityState

Type

"Visible" | "Invisible" | "Partial"


HeaderWidgetButtonsMode

Mode can be of the following:

  • fullsize: always full-size buttons on the top toolbar
  • adaptive: adaptive/auto mode (fullsize if the window width allows and icons on small windows).
  • compact: icons only buttons on the top toolbar (favorites won't be shown)

Type

"fullsize" | "compact" | "adaptive"


HistoryCallback

Type

(bars: Bar[], meta?: HistoryMetadata) => void

Type declaration

Signature

(bars: Bar[], meta?: HistoryMetadata) => void
Parameters
NameType
barsBar[]
meta?HistoryMetadata
Returns

void


IActionVariant

Item variants within a context menu

Type

IAction | ISeparator


IBarArray

Type

[number, number, number, number, number, number]


IBasicDataFeed

Type

IDatafeedChartApi & IExternalDatafeed


IPineStudyResult

Type

IPineStudyResultTypes<IPineStudyResultSimple>


IPineStudyResultSimple

Type

StudyPrimitiveResult | ISeriesStudyResult | INonSeriesStudyBarsResult | IProjectionStudyResult | INonSeriesStudyResult


IPineStudyResultTypes

Type

TPineStudyResultSimple | PineStudyResultComposite<TPineStudyResultSimple>

Type parameters

Name
TPineStudyResultSimple

IProjectionBar

Type

[number, number, number, number, number, number] | [number, number, number, number, number, number, number]


ISeriesStudyResult

An array of bar values.

[time, open, high, low, close, volume, updatetime, isBarClosed, emptyBars, emptyBarsPrice]

Type

[time: number, open: number, high: number, low: number, close: number, volume: number, updatetime: number | undefined, isBarClosed: boolean | undefined, emptyBars: number[] | undefined, emptyBarsPrice: number | undefined]


InputFieldValidator

Input field validator

Type

(value: any) => InputFieldValidatorResult

Type declaration

Signature

(value: any) => InputFieldValidatorResult
Parameters
NameTypeDescription
valueanyvalue to be validated
Returns

InputFieldValidatorResult


InputFieldValidatorResult

Type

PositiveBaseInputFieldValidatorResult | NegativeBaseInputFieldValidatorResult


LanguageCode

Type

"ar" | "zh" | "ca_ES" | "en" | "fr" | "de" | "he_IL" | "id_ID" | "it" | "ja" | "ko" | "pl" | "pt" | "ru" | "es" | "sv" | "th" | "tr" | "vi" | "ms_MY" | "zh_TW"


LayoutType

Type

SingleChartLayoutType | MultipleChartsLayoutType


LegendMode

Type

"horizontal" | "vertical"


LibrarySessionId

Type

"regular" | "extended" | "premarket" | "postmarket"


LineStudyPlotStyleName

Plot Style. Used for plottype properties within Indicator overrides.

Type

"line" | "histogram" | "cross" | "area" | "columns" | "circles" | "line_with_breaks" | "area_with_breaks" | "step_line" | "step_line_with_breaks" | "step_line_with_diamonds"


LineToolsAndGroupsLoadRequestType

The type of data being requested from the IExternalSaveLoadAdapter.loadLineToolsAndGroups method.

Usually, the 'mainSeriesLineTools' is the requested type that is important for implementing the restoration of drawings associated with a chart.

Type

"allLineTools" | "lineToolsWithoutSymbol" | "studiesLineTools" | "mainSeriesLineTools"


MarkConstColors

Type

"red" | "green" | "blue" | "yellow"


MultipleChartsLayoutType

Type

"2h" | "2v" | "2-1" | "3s" | "3h" | "3v" | "4" | "6" | "8" | "1-2" | "3r" | "4h" | "4v" | "4s" | "5h" | "6h" | "7h" | "8h" | "1-3" | "2-2" | "2-3" | "1-4" | "5s" | "6c" | "8c"


Nominal

This is the generic type useful for declaring a nominal type, which does not structurally matches with the base type and the other types declared over the same base type

Usage:

Example

type Index = Nominal<number, 'Index'>;
// let i: Index = 42; // this fails to compile
let i: Index = 42 as Index; // OK

Example

type TagName = Nominal<string, 'TagName'>;

Type

T & { [species]: Name }

Type parameters

NameType
TT
Nameextends string

OmitActionId

Type

Omit<T, "actionId">

Type parameters

NameType
Textends Object

OnActionExecuteHandler

Type

(action: IAction) => void

Type declaration

Signature

(action: IAction) => void
Parameters
NameType
actionIAction
Returns

void


OnActionUpdateHandler

Type

(action: IAction) => void

Type declaration

Signature

(action: IAction) => void
Parameters
NameType
actionIAction
Returns

void


OnReadyCallback

Type

(configuration: DatafeedConfiguration) => void

Type declaration

Signature

(configuration: DatafeedConfiguration) => void
Parameters
NameType
configurationDatafeedConfiguration
Returns

void


Order

Type

PlacedOrder | BracketOrder


OrderLineLengthUnit

Type

"pixel" | "percentage"


OrderTableColumn

Type

AccountManagerColumn & { supportedStatusFilters?: OrderStatusFilter[] }


PageName

Type

"watchlist_details_news" | "data_window" | "object_tree"


PlotShapeId

Plot shape ID.

Type

"shape_arrow_down" | "shape_arrow_up" | "shape_circle" | "shape_cross" | "shape_xcross" | "shape_diamond" | "shape_flag" | "shape_square" | "shape_label_down" | "shape_label_up" | "shape_triangle_down" | "shape_triangle_up"


PositionLineLengthUnit

Type

"pixel" | "percentage"


PriceScaleSelectedCurrency

A price scale can either have a specific currency (string) or be a 'mix' of if multiple symbols with different currencies share the same scale.

Type

"Mixed" | string


PriceSource

Type

"open" | "high" | "low" | "close"


QuoteData

Type

QuoteOkData | QuoteErrorData


QuotesCallback

Callback to provide Quote data.

Type

(data: QuoteData[]) => void

Type declaration

Signature

(data: QuoteData[]) => void
Parameters
NameTypeDescription
dataQuoteData[]Quote Data
Returns

void


QuotesErrorCallback

Error callback for quote data request.

Type

(reason: string) => void

Type declaration

Signature

(reason: string) => void
Parameters
NameTypeDescription
reasonstringmessage describing the reason for the error
Returns

void


RawStudyMetaInfoId

Type

Nominal<string, "RawStudyMetaInfoId">


RawStudyMetaInformation

Type

Omit<RawStudyMetaInfo, "defaults" | "plots"> & { defaults?: Readonly<DeepPartial<StudyDefaults>> ; plots?: readonly Readonly<StudyPlotInformation>[] }


ResolutionString

Resolution or time interval is a time period of one bar. Advanced Charts supports tick, intraday (seconds, minutes, hours), and DWM (daily, weekly, monthly) resolutions. The table below describes how to specify different types of resolutions:

ResolutionFormatExample
TicksxT1T — one tick
SecondsxS1S — one second
Minutesx1 — one minute
Hoursx minutes60 — one hour
DaysxD1D — one day
WeeksxW1W — one week
MonthsxM1M — one month
YearsxM months12M — one year

Refer to Resolution for more information.

Type

Nominal<string, "ResolutionString">


ResolveCallback

Type

(symbolInfo: LibrarySymbolInfo) => void

Type declaration

Signature

(symbolInfo: LibrarySymbolInfo) => void
Parameters
NameType
symbolInfoLibrarySymbolInfo
Returns

void


RssNewsFeedItem

RSS news feed.

Type

RssNewsFeedInfo | RssNewsFeedInfo[]


SearchSymbolsCallback

Type

(items: SearchSymbolResultItem[]) => void

Type declaration

Signature

(items: SearchSymbolResultItem[]) => void
Parameters
NameType
itemsSearchSymbolResultItem[]
Returns

void


SeriesEventType

An event related to the series. Currently the only possible value for this argument is price_scale_changed

Type

"price_scale_changed"


SeriesFormat

Type

"price" | "volume"


SeriesFormatterFactory

Type

(symbolInfo: LibrarySymbolInfo | null, minTick: string) => ISymbolValueFormatter | null

Type declaration

Signature

(symbolInfo: LibrarySymbolInfo | null, minTick: string) => ISymbolValueFormatter | null
Parameters
NameType
symbolInfoLibrarySymbolInfo | null
minTickstring
Returns

ISymbolValueFormatter | null


SeriesPriceScale

Where to attach the price scale. Options are either to the left, right, next to an already existing price axis using a reference or no scale if there are no other scales on the main pane.

Type

"new-left" | "new-right" | "no-scale" | EntityId


SeriesStatusViewSymbolTextSource

Type

"ticker" | "description" | "ticker-and-description" | "long-description"


ServerTimeCallback

Type

(serverTime: number) => void

Type declaration

Signature

(serverTime: number) => void
Parameters
NameType
serverTimenumber
Returns

void


SetVisibleTimeRange

A time range to set. The end to value is optional.

When the optional to value is omitted then the value will fallback to the timestamp of the latest bar on the chart.

Type

Omit<VisibleTimeRange, "to"> & Partial<Pick<VisibleTimeRange, "to">>


ShapePoint

Drawing point

Type

StickedPoint | PricedPoint | TimePoint


ShapesGroupId

Type

Nominal<string, "ShapesGroupId">


SingleChartLayoutType

Type

"s"


SingleIndicatorOverrides

Type

FiftyTwoWeekHighLowIndicatorOverrides | AcceleratorOscillatorIndicatorOverrides | AccumulationDistributionIndicatorOverrides | AccumulativeSwingIndexIndicatorOverrides | AdvanceDeclineIndicatorOverrides | AnchoredVWAPIndicatorOverrides | ArnaudLegouxMovingAverageIndicatorOverrides | AroonIndicatorOverrides | AverageDirectionalIndexIndicatorOverrides | AveragePriceIndicatorOverrides | AverageTrueRangeIndicatorOverrides | AwesomeOscillatorIndicatorOverrides | BalanceofPowerIndicatorOverrides | BollingerBandsIndicatorOverrides | BollingerBandsBIndicatorOverrides | BollingerBandsWidthIndicatorOverrides | ChaikinMoneyFlowIndicatorOverrides | ChaikinOscillatorIndicatorOverrides | ChaikinVolatilityIndicatorOverrides | ChandeKrollStopIndicatorOverrides | ChandeMomentumOscillatorIndicatorOverrides | ChopZoneIndicatorOverrides | ChoppinessIndexIndicatorOverrides | CommodityChannelIndexIndicatorOverrides | CompareIndicatorOverrides | ConnorsRSIIndicatorOverrides | CoppockCurveIndicatorOverrides | CorrelationLogIndicatorOverrides | CorrelationCoefficientIndicatorOverrides | DetrendedPriceOscillatorIndicatorOverrides | DirectionalMovementIndicatorOverrides | DonchianChannelsIndicatorOverrides | DoubleEMAIndicatorOverrides | EMACrossIndicatorOverrides | EaseOfMovementIndicatorOverrides | EldersForceIndexIndicatorOverrides | EnvelopesIndicatorOverrides | FisherTransformIndicatorOverrides | FixedRangeIndicatorOverrides | GuppyMultipleMovingAverageIndicatorOverrides | HistoricalVolatilityIndicatorOverrides | HullMovingAverageIndicatorOverrides | IchimokuCloudIndicatorOverrides | KeltnerChannelsIndicatorOverrides | KlingerOscillatorIndicatorOverrides | KnowSureThingIndicatorOverrides | LeastSquaresMovingAverageIndicatorOverrides | LinearRegressionCurveIndicatorOverrides | LinearRegressionSlopeIndicatorOverrides | MACrossIndicatorOverrides | MAwithEMACrossIndicatorOverrides | MACDIndicatorOverrides | MajorityRuleIndicatorOverrides | MassIndexIndicatorOverrides | McGinleyDynamicIndicatorOverrides | MedianPriceIndicatorOverrides | MomentumIndicatorOverrides | MoneyFlowIndexIndicatorOverrides | MovingAverageIndicatorOverrides | MovingAverageAdaptiveIndicatorOverrides | MovingAverageChannelIndicatorOverrides | MovingAverageDoubleIndicatorOverrides | MovingAverageExponentialIndicatorOverrides | MovingAverageHammingIndicatorOverrides | MovingAverageMultipleIndicatorOverrides | MovingAverageTripleIndicatorOverrides | MovingAverageWeightedIndicatorOverrides | NetVolumeIndicatorOverrides | OnBalanceVolumeIndicatorOverrides | OverlayIndicatorOverrides | ParabolicSARIndicatorOverrides | PivotPointsStandardIndicatorOverrides | PriceChannelIndicatorOverrides | PriceOscillatorIndicatorOverrides | PriceVolumeTrendIndicatorOverrides | RateOfChangeIndicatorOverrides | RatioIndicatorOverrides | RegressionTrendIndicatorOverrides | RelativeStrengthIndexIndicatorOverrides | RelativeVigorIndexIndicatorOverrides | RelativeVolatilityIndexIndicatorOverrides | SMIErgodicIndicatorOscillatorIndicatorOverrides | SessionsIndicatorOverrides | SmoothedMovingAverageIndicatorOverrides | SpreadIndicatorOverrides | StandardDeviationIndicatorOverrides | StandardErrorIndicatorOverrides | StandardErrorBandsIndicatorOverrides | StochasticIndicatorOverrides | StochasticRSIIndicatorOverrides | SuperTrendIndicatorOverrides | TRIXIndicatorOverrides | TrendStrengthIndexIndicatorOverrides | TripleEMAIndicatorOverrides | TrueStrengthIndexIndicatorOverrides | TypicalPriceIndicatorOverrides | UltimateOscillatorIndicatorOverrides | VWAPIndicatorOverrides | VWMAIndicatorOverrides | VolatilityClosetoCloseIndicatorOverrides | VolatilityIndexIndicatorOverrides | VolatilityOHLCIndicatorOverrides | VolatilityZeroTrendClosetoCloseIndicatorOverrides | VolumeIndicatorOverrides | VolumeOscillatorIndicatorOverrides | VolumeProfileFixedRangeIndicatorOverrides | VolumeProfileVisibleRangeIndicatorOverrides | VortexIndicatorIndicatorOverrides | WilliamsRIndicatorOverrides | WilliamsAlligatorIndicatorOverrides | WilliamsFractalIndicatorOverrides | ZigZagIndicatorOverrides


StudyAvailableConstSources

Type

"open" | "high" | "low" | "close" | "hl2" | "hlc3" | "ohlc4" | "hlcc4"


StudyEventType

An event related to a study.

Type

"create" | "remove" | "price_scale_changed" | "paste_study"


StudyFilledAreaStyle

Type

StudyFilledAreaSolidColorStyle | StudyFilledAreaGradientColorStyle


StudyInputId

Type

Nominal<string, "StudyInputId">


StudyInputInfo

Type

StudyBooleanInputInfo | StudyTextInputInfo | StudySymbolInputInfo | StudyResolutionInputInfo | StudySessionInputInfo | StudySourceInputInfo | StudyNumericInputInfo | StudyPriceInputInfo | StudyColorInputInfo | StudyTimeInputInfo | StudyBarTimeInputInfo | StudyTextareaInputInfo


StudyInputInfoList

Type

readonly Readonly<StudyInputInfo>[]


StudyInputValue

The value of a study input.

Type

string | number | boolean


StudyMetaInfo

Type

DeepWriteable<RawStudyMetaInformation> & { id: string }


StudyOhlcPlotPreferences

Type

StudyOhlcPlotBarsStylePreferences | StudyOhlcPlotCandlesStylePreferences


StudyOverrideValueType

Type

string | number | boolean


StudyPlotDisplayMode

Type

Nominal<number, "StudyPlotDisplayTarget"> | StudyPlotDisplayTarget


StudyPlotInfo

Type

StudyPlotInformation


StudyPlotInformation

A description of a study plot.

Type

StudyArrowsPlotInfo | StudyCharsPlotInfo | StudyColorerPlotInfo | StudyRgbaColorerPlotInfo | StudyDataPlotInfo | StudyDataOffsetPlotInfo | StudyLinePlotInfo | StudyOhlcPlotInfo | StudyShapesPlotInfo | StudyBarColorerPlotInfo | StudyBgColorerPlotInfo | StudyTextColorerPlotInfo | StudyOhlcColorerPlotInfo | StudyCandleWickColorerPlotInfo | StudyCandleBorderColorerPlotInfo | StudyUpColorerPlotInfo | StudyDownColorerPlotInfo


StudyPlotPreferences

Study plot style preferences.

Type

StudyLinePlotPreferences | StudyShapesPlotPreferences | StudyCharsPlotPreferences | StudyArrowsPlotPreferences


StudyPlotValueFormat

Type

StudyPlotValueInheritFormat | StudyPlotValuePrecisionFormat


StudyPriceScale

Price scale to display a study on.

Possible values are:

  • new-left - attach the study to a new left price scale
  • new-right - attach the study to a new right price scale
  • no-scale - do not attach the study to any price scale. The study will be added in 'No Scale' mode
  • as-series - attach the study to the price scale where the main series is attached (it is only applicable the study is added to the pane with the main series)

Type

"new-left" | "new-right" | "no-scale" | "as-series"


StudyPrimitiveResult

Type

(number | StudyResultValueWithOffset)[]


SubscribeBarsCallback

Type

(bar: Bar) => void

Type declaration

Signature

(bar: Bar) => void
Parameters
NameType
barBar
Returns

void


SuggestedQtyChangedListener

Type

(newQty: number) => void

Type declaration

Signature

(newQty: number) => void
Parameters
NameType
newQtynumber
Returns

void


SupportedLineTools

Type

"text" | "anchored_text" | "note" | "anchored_note" | "signpost" | "double_curve" | "arc" | "icon" | "emoji" | "sticker" | "arrow_up" | "arrow_down" | "arrow_left" | "arrow_right" | "price_label" | "price_note" | "arrow_marker" | "flag" | "vertical_line" | "horizontal_line" | "cross_line" | "horizontal_ray" | "trend_line" | "info_line" | "trend_angle" | "arrow" | "ray" | "extended" | "parallel_channel" | "disjoint_angle" | "flat_bottom" | "anchored_vwap" | "pitchfork" | "schiff_pitchfork_modified" | "schiff_pitchfork" | "balloon" | "comment" | "inside_pitchfork" | "pitchfan" | "gannbox" | "gannbox_square" | "gannbox_fixed" | "gannbox_fan" | "fib_retracement" | "fib_trend_ext" | "fib_speed_resist_fan" | "fib_timezone" | "fib_trend_time" | "fib_circles" | "fib_spiral" | "fib_speed_resist_arcs" | "fib_channel" | "xabcd_pattern" | "cypher_pattern" | "abcd_pattern" | "callout" | "triangle_pattern" | "3divers_pattern" | "head_and_shoulders" | "fib_wedge" | "elliott_impulse_wave" | "elliott_triangle_wave" | "elliott_triple_combo" | "elliott_correction" | "elliott_double_combo" | "cyclic_lines" | "time_cycles" | "sine_line" | "long_position" | "short_position" | "forecast" | "date_range" | "price_range" | "date_and_price_range" | "bars_pattern" | "ghost_feed" | "projection" | "rectangle" | "rotated_rectangle" | "circle" | "ellipse" | "triangle" | "polyline" | "path" | "curve" | "cursor" | "dot" | "arrow_cursor" | "eraser" | "measure" | "zoom" | "brush" | "highlighter" | "regression_trend" | "fixed_range_volume_profile"


SymbolSearchCompleteOverrideFunction

function to override the symbol input from symbol search dialogs

Type

(symbol: string, searchResultItem?: SearchSymbolResultItem) => Promise<SymbolSearchCompleteData>

Type declaration

Signature

(symbol: string, searchResultItem?: SearchSymbolResultItem) => Promise<SymbolSearchCompleteData>
Parameters
NameTypeDescription
symbolstringinput from the symbol search
searchResultItem?SearchSymbolResultItem-
Returns

Promise<SymbolSearchCompleteData>


SymbolSource

Type

SymbolInputSymbolSource


SymbolType

Type

"stock" | "index" | "forex" | "futures" | "bitcoin" | "crypto" | "undefined" | "expression" | "spread" | "cfd" | "economic" | "equity" | "dr" | "bond" | "right" | "warrant" | "fund" | "structured" | "commodity" | "fundamental" | "spot" | "swap"


TableFormatTextFunction

A function that takes an TableFormatterInputs object and returns a string.

Type

(inputs: TableFormatterInputs<T>) => string

Type parameters

NameType
Textends TableFormatterInputValues = TableFormatterInputValues

Type declaration

Signature

(inputs: TableFormatterInputs<T>) => string
Parameters
NameType
inputsTableFormatterInputs<T>
Returns

string


TableFormatterInputValue

Type

any


TableFormatterInputValues

Type

TableFormatterInputValue[]


TextInputFieldValidator

Type

(value: string) => InputFieldValidatorResult

Type declaration

Signature

(value: string) => InputFieldValidatorResult
Parameters
NameType
valuestring
Returns

InputFieldValidatorResult


ThemeName

Type

"light" | "dark"


TickMarkType

Type

"Year" | "Month" | "DayOfMonth" | "Time" | "TimeWithSeconds" | "TimeWithMilliseconds"


TimeFrameValue

Type of timeframe defined in the UI. Can either be a single one TimeFramePeriodBack or a range TimeFrameTimeRange

Examples:

  1. a timeframe object, {type, value}:
    • type: period-back.
    • value: valid timeframe is a number with letter D for days and M for months.
  2. a range object, {type, from, to}
    • type: time-range.
    • from, to: UNIX timestamps, UTC.

Type

TimeFramePeriodBack | TimeFrameTimeRange


TimeScaleMarkShape

Type

"circle" | "earningUp" | "earningDown" | "earning"


TimeframeOption

Type

string | { from: number ; to: number }


Timezone

Type

"Etc/UTC" | CustomTimezones


TimezoneId

Type

CustomTimezones | "Etc/UTC" | "exchange"


TradableSolutions

TradableSolutions has one of the following keys:

  • changeAccount - id of a sub-account suitable for trading the symbol
  • changeSymbol - the symbol suitable for trading with current sub-account
  • openUrl - the object with URL to be opened and text for solution button

Type

ChangeAccountSolution | ChangeSymbolSolution | OpenUrlSolution


TradingDialogCustomField

Type

CheckboxFieldMetaInfo | TextWithCheckboxFieldMetaInfo | CustomComboBoxMetaInfo


TradingTerminalChartTypeFavorites

Chart type names for use within the favorites Widget Constructor option. This type is for Trading Platform, if you are looking for the Advanced Charts type then please see ChartTypeFavorites.

See Favorites for the Widget Constructor option where you can define these favorites, and TradingTerminalWidgetOptions.favorites for the Widget Constructor option.

Type

ChartTypeFavorites | "Renko" | "Kagi" | "Point & figure" | "Line Break"


TradingTerminalFeatureset

This is the list of all featuresets that work on Trading Platform (which is an extension of Advanced Charts)

Type

ChartingLibraryFeatureset | "chart_crosshair_menu" | "support_multicharts" | "header_layouttoggle" | "add_to_watchlist" | "open_account_manager" | "trading_notifications" | "multiple_watchlists" | "show_trading_notifications_history" | "always_pass_called_order_to_modify" | "drawing_templates" | "trading_account_manager" | "right_toolbar" | "order_panel" | "order_info" | "buy_sell_buttons" | "broker_button" | "show_order_panel_on_start" | "order_panel_close_button" | "order_panel_undock" | "chart_hide_close_position_button" | "chart_hide_close_order_button" | "watchlist_import_export" | "dom_widget" | "keep_object_tree_widget_in_right_toolbar" | "show_last_price_and_change_only_in_series_legend" | "legend_last_day_change" | "watchlist_context_menu " | "hide_right_toolbar" | "hide_right_toolbar_tabs" | "hide_price_scale_if_all_sources_hidden" | "show_symbol_logo_in_account_manager" | "watchlist_sections"


VisiblePlotsSet

Type

"ohlcv" | "ohlc" | "c"


WatchListSymbolListAddedCallback

Type

(listId: string, symbols: string[]) => void

Type declaration

Signature

(listId: string, symbols: string[]) => void
Parameters
NameType
listIdstring
symbolsstring[]
Returns

void


WatchListSymbolListChangedCallback

Type

(listId: string) => void

Type declaration

Signature

(listId: string) => void
Parameters
NameType
listIdstring
Returns

void


WatchListSymbolListRemovedCallback

Type

(listId: string) => void

Type declaration

Signature

(listId: string) => void
Parameters
NameType
listIdstring
Returns

void


WatchListSymbolListRenamedCallback

Type

(listId: string, oldName: string, newName: string) => void

Type declaration

Signature

(listId: string, oldName: string, newName: string) => void
Parameters
NameType
listIdstring
oldNamestring
newNamestring
Returns

void


WatchedValueCallback

Type

(value: T) => void

Type parameters

Name
T

Type declaration

Signature

(value: T) => void
Parameters
NameType
valueT
Returns

void


WatermarkContentProvider

Custom watermark content provider which should return an array of watermark lines to be displayed. Return null if you would like to use the default content.

Type

(data: WatermarkContentData) => WatermarkLine[] | null

Type declaration

Signature

(data: WatermarkContentData) => WatermarkLine[] | null
Parameters
NameType
dataWatermarkContentData
Returns

WatermarkLine[] | null


WidgetOverrides

Type

DrawingOverrides & { [key: string]: string | number | boolean; }

Variables

widget

Type

ChartingLibraryWidgetConstructor

Flags

Const

Functions

version

Returns a build version string. For example "CL v23.012 (internal id e0d59dc3 @ 2022-08-23T06:07:00.808Z)".

Signature

version() => string

Returns

The build version string.

string