> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ninjatrader.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ninjatrader.com/_mcp/server.

# Properties

## Definition

Represents various **ChartBar** properties configured from the Chart's **Data Series** menu.

The properties on this page indicate what have been configured by the user, and is NOT necessarily representative of what is actually contained on the chart. For example, a user may have requested 120 days of chart data; however, only 60 days of bar data are actually returned from their provider.

![ChartBars\_DataSeries](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/ninjatrader-public.docs.buildwithfern.com/35b80ea49e5421660faf846a7e3ff6f15c83819ea8a98f05fa373cdbfcd09491/docs/assets/developer/desktop-sdk/references/chartbars-properties-chartbars-dataseries.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260729%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260729T070502Z&X-Amz-Expires=604800&X-Amz-Signature=1b3e1aeb1b050372c19255a6238f0693e7adbce0923d4f3526f9407fe82ac280&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

These are UI properties which are designed to be set by a user. Attempting to modify these values through a custom script is NOT guaranteed to take effect.

## Properties

| Property              | Description                                                                                                                                                                                                                                                                                                                                                                                          |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AutoScale             | A bool indicating if the Chart Data Series participates in the chart's auto scaling methods                                                                                                                                                                                                                                                                                                          |
| BarsBack              | An int representing the Chart's Data Series configured "Bars to load" when the RangeType.Bars is selected                                                                                                                                                                                                                                                                                            |
| BarsPeriod            | The **BarsPeriod** object configured for Chart's Data Series                                                                                                                                                                                                                                                                                                                                         |
| CenterPriceOnScale    | A bool indicating if the Chart's Data Series should center the last traded price on the chart scale                                                                                                                                                                                                                                                                                                  |
| ChartStyle            | The **ChartStyle** object configured for the Chart's Data Series                                                                                                                                                                                                                                                                                                                                     |
| ChartStyleType        | A **ChartStyleType** enum indicating the type of chart style configured. System defaults include:<br />**ChartStyleType.Box**<br />**ChartStyleType.CandleStick**<br />**ChartStyleType.LineOnClose**<br />**ChartStyleType.OHLC**<br />**ChartStyleType.PointAndFigure**<br />**ChartStyleType.KagiLine**<br />**ChartStyleType.OpenClose**<br />**ChartStyleType.Mountain**                        |
| DaysBack              | An int representing the Chart's Data Series configured "Days to load" when the RangeType.Days is selected                                                                                                                                                                                                                                                                                            |
| DisplayInDataBox      | A bool indicating if the Chart's Data Series value should display in the Chart's **Data Box**                                                                                                                                                                                                                                                                                                        |
| DisplayName           | A string representing the Chart's Data Series instrument and period                                                                                                                                                                                                                                                                                                                                  |
| From                  | A DateTime representing the Chart's Data Series configured "Start Date" when the RangeType.CustomRange is configured.                                                                                                                                                                                                                                                                                |
| Instrument            | A string representing the Chart's Data Series instrument                                                                                                                                                                                                                                                                                                                                             |
| IsStableSession       | A bool indicating the Chart's Data Series **Break EOD** option is configured                                                                                                                                                                                                                                                                                                                         |
| IsTickReplay          | A bool indicating the Chart's Data Series **Tick Replay** option is configured                                                                                                                                                                                                                                                                                                                       |
| Label                 | A string representing the configured Chart's Data Series "Label"                                                                                                                                                                                                                                                                                                                                     |
| LongExecutionBrush    | A **Brush** object representing the Chart's Data Series "Color for execution - buy" brush configured                                                                                                                                                                                                                                                                                                 |
| PaintPriceMarker      | A bool indicating the Chart's Data Series Price Marker "Visible" option is configured                                                                                                                                                                                                                                                                                                                |
| Panel                 | An int indicating which Chart's Data Series "Panel" the **ChartBars** are configured                                                                                                                                                                                                                                                                                                                 |
| PlotExecutions        | A **ChartExecutionStyle** enum representing "Plot executions" option. Possible values include:<br />**ChartExecutionStyle.DoNotPlot**<br />**ChartExecutionStyle.MarkersOnly**<br />**ChartExecutionStyle.TextAndMarker**                                                                                                                                                                            |
| PositionPenLoser      | A **Stroke** object representing the Chart's Data Series "NinjaScript strategy unprofitable trade line"                                                                                                                                                                                                                                                                                              |
| PositionPenWinner     | A **Stroke** object representing the Chart's Data Series "NinjaScript strategy profitable trade line"                                                                                                                                                                                                                                                                                                |
| PriceMarker           | A **PriceMarker** object representing various brushes used to paint the Chart's Data Series "Price marker"                                                                                                                                                                                                                                                                                           |
| RangeType             | A **RangeType** enum indicating the "Load data based on" value configured on the Data Series. Possible values include:<br />**RangeType.Bars**<br />**RangeType.Days**<br />**RangeType.CustomRange**                                                                                                                                                                                                |
| ScaleJustification    | A **ScaleJustification** enum indicating the "Scale justification" option configured on the Chart's Data Series. Possible values include:<br />**ScaleJustification.Right**<br />**ScaleJustification.Left**<br />**ScaleJustification.Overlay**                                                                                                                                                     |
| ShortExecutionBrush   | A **Brush** object representing the Chart's Data Series "Color for execution - sell" brush configured                                                                                                                                                                                                                                                                                                |
| ShowGlobalDrawObjects | A bool indicating the Chart's Data Series "Show global draw object" option is configured                                                                                                                                                                                                                                                                                                             |
| To                    | A DateTime representing the configured "End Date" used with any RangeType                                                                                                                                                                                                                                                                                                                            |
| TradingHoursBreakLine | A **TradingHoursBreakLine** object representing the **stroke** used and **TradingHoursBreakLineVisible** enum used for the Chart's Data Series "Trading hours break line". Possible **TradingHoursBreakLine.TradingHoursBreakLineVisible** values include:<br />**TradingHoursBreakLineVisible.AllSessions**<br />**TradingHoursBreakLineVisible.EodOnly**<br />**TradingHoursBreakLineVisible.Off** |
| TradingHoursData      | A string representing the Chart's Data Series configured "Trading hours" option                                                                                                                                                                                                                                                                                                                      |