CandlestickChart [{{date1,{open1,high1,low1,close1}},…}]
makes a chart with candles representing open, high, low, and close prices for each date.
CandlestickChart [{"name",daterange}]
makes a candlestick chart for the financial entity "name" over the date range daterange.
CandlestickChart
CandlestickChart [{{date1,{open1,high1,low1,close1}},…}]
makes a chart with candles representing open, high, low, and close prices for each date.
CandlestickChart [{"name",daterange}]
makes a candlestick chart for the financial entity "name" over the date range daterange.
Details and Options
- The dates datei are considered an ordered sequence of events, and are not shown on an absolute time scale.
- The date formats for datei are the same as used in DateListPlot .
- The "name" and daterange are the same as used in FinancialData .
- Data elements for CandlestickChart can be given in the following forms:
-
{datei,ohlci} a pure date and open-high-low-close (OHLC) pairwi[{datei,ohlci},…] a date OHLC and wrapper wiformi->mi a date OHLC with metadata mi
- Data not given in these forms is taken to be missing, and is typically excluded when generating the chart.
- Data for CandlestickChart can be given in the following forms:
-
{e1,e2,…},{"name",daterange} data without overall wrapperw[{e1,e2,…}], w[{"name",daterange}] data with overall wrapper
- CandlestickChart [Tabular […]cspec] extracts and plots values from the tabular object using the column specification cspec.
- The following forms of column specifications cspec are allowed for plotting tabular data:
-
{coldate,{colopen,colhigh,collow,colclose}} plot values from columns {colopen,…,colclose} against dates from coldate
- The following wrappers can be used for data elements:
-
- In CandlestickChart , Labeled and Placed allow the following positions:
-
"Open","High","Low","Close" open, high, low, and close positions in the candlestick{{bx,by},{lx,ly}} scaled position {lx,ly} in the label at scaled position {bx,by} in the candlestick
- CandlestickChart has the same options as Graphics , with the following additions and changes: [List of all options]
-
- The arguments supplied to ChartElementFunction are the box region {{xmin,xmax},{ymin,ymax}}, {datei,{oi,hi,li,ci}}, and metadata {m1,m2,…}.
- A list of built-in settings for ChartElementFunction can be obtained from ChartElementData["CandlestickChart"].
- Common settings for ChartElementFunction include "Candlestick", "OHLC", and "HLC".
- The arguments supplied to ColorFunction are date,open,high,low,close,close-open.
- With ScalingFunctions->sy the function sy is applied to all prices (open, high, low, close). ScalingFunctions only affects the display and none of the controls.
- Style and other specifications from options and other constructs in CandlestickChart are effectively applied in the order TrendStyle , ColorFunction , Style and other wrappers, and ChartElementFunction , with later specifications overriding earlier ones.
-
ImageMargins 0. the margins to leave around the graphicPreserveImageOptions Automatic whether to preserve image options when displaying new versions of the same graphic
List of all options
Examples
open all close allBasic Examples (2)
Chart the prices from a list of values:
Use three months of prices from FinancialData entities:
Specify a date range:
Scope (26)
Data and Wrappers (12)
Automatically get quarterly data from today:
Get data from a specific date range:
Get data from FinancialData :
The data may include units:
Specify the units to use:
Data can be TimeSeries , EventSeries , or TemporalData :
Use wrappers on individual data:
Use wrappers on entire datasets:
Wrappers can be nested:
Override the default tooltips:
Use PopupWindow to provide additional drilldown information:
Button can be used to trigger any action:
Tabular Data (1)
Get tabular data:
Plot the open, high, low and close prices of a stock as a candlestick:
Plot the prices using a stick form:
Styling and Appearance (9)
Specify styles for up and down trends:
Use named preset styles:
ChartBaseStyle can be used to set a style for all chart elements:
Style can be used to override styles:
Use built-in, programmatically generated bars:
Space between candlesticks is automatically adjusted based on the number of data points:
Appearance changes based on the number of data points:
Use a theme with simple ticks and grid lines in a bright color scheme:
Use a theme with a dark background in a high-contrast color scheme:
Options (64)
AspectRatio (3)
By default, AspectRatio uses a fixed ratio of height to width for the chart:
Make the height the same as the width with AspectRatio 1:
AspectRatio Full adjusts the height and width to tightly fit inside other constructs:
Axes (4)
By default, Axes are drawn:
Use Axes False to turn off axes:
Use AxesOrigin to specify where the axes intersect:
Turn each axis on individually:
AxesLabel (2)
Axes are not labeled by default:
Place a label on the axis:
AxesOrigin (3)
The position of the axes is determined automatically:
Specify an explicit date as origin for the axes:
Use named positions for the axis:
BarSpacing (4)
Use automatically determined spacing between candlesticks:
Use no spacing:
Use symbolic presets:
Use explicit spacing between candlesticks:
ChartBaseStyle (5)
Use ChartBaseStyle to style candlesticks:
ChartBaseStyle combines with TrendStyle :
TrendStyle may override settings for ChartBaseStyle :
Style may override settings for ChartBaseStyle :
ChartBaseStyle combines with ColorFunction :
ChartElementFunction (3)
Get a list of built-in settings for ChartElementFunction :
For detailed settings, use Palettes ▶ ChartElementSchemes:
Write a custom ChartElementFunction :
ColorFunction (4)
Color the candlesticks by scaled date, open, high, low, close, or trend value:
Color by the size and direction of price changes:
Color by a trigger point:
ColorFunction overrides styles in TrendStyle :
ColorFunctionScaling (3)
By default, scaled values are used:
Use ColorFunctionScaling->False to get unscaled values:
Use unscaled dates to color the candlesticks according to the day of the week:
EventLabels (6)
GridLines (4)
GridLines are used by default:
Turn off date grid lines:
Turn off price grid lines:
Place grid lines at month or year boundaries:
Use dotted grid lines for months and red grid lines for years:
GridLinesStyle (3)
By default, GridLinesStyle uses dotted grid lines with emphasized year grid lines:
Style grid lines:
GridLines overrides GridLinesStyle :
Method (4)
The default mouseover effect is a bouncing ball and axis highlight:
Use no mouseover effect:
Use only the bouncing ball:
Style the bouncing ball with "HighlightStyle":
Use only the axis highlight:
Style the axis highlight:
Specify the height in pixels for the axis highlight:
PerformanceGoal (3)
Generate a candlestick chart with interactive highlighting:
Emphasize performance by disabling interactive behaviors:
Typically, less memory is required for non-interactive charts:
PlotRange (3)
CandlestickChart automatically draws all price dates:
Limit to a specific date range:
PlotRange only includes dates for which there is data:
PlotTheme (2)
Use a theme with simple ticks and grid lines in a bright color scheme:
Change the trend style and use fading OHLC:
ScalingFunctions (2)
Prices are normally shown on a linear scale:
Show prices on a logarithmic scale:
TrendStyle (6)
TrendStyle uses green for up trends and red for down trends by default:
Use black for up trends and red for down trends:
Use named styles:
TrendStyle combines with ChartBaseStyle :
With TrendStyle set to None , the base style is used for up trends and empty bars are used for down trends:
TrendStyle->style uses style for up trends and empty bars for down trends:
Properties & Relations (4)
Use TradingChart to visualize and analyze financial data:
Use InteractiveTradingChart to visualize and interactively analyze financial data:
Use PointFigureChart , LineBreakChart , RenkoChart , and KagiChart to analyze the relation of financial prices and time:
Use DateListPlot to visualize financial data:
History
Introduced in 2010 (8.0) | Updated in 2012 (9.0) ▪ 2014 (10.0) ▪ 2025 (14.2)
Text
Wolfram Research (2010), CandlestickChart, Wolfram Language function, https://reference.wolfram.com/language/ref/CandlestickChart.html (updated 2025).
CMS
Wolfram Language. 2010. "CandlestickChart." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2025. https://reference.wolfram.com/language/ref/CandlestickChart.html.
APA
Wolfram Language. (2010). CandlestickChart. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/CandlestickChart.html
BibTeX
@misc{reference.wolfram_2025_candlestickchart, author="Wolfram Research", title="{CandlestickChart}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/CandlestickChart.html}", note=[Accessed: 16-November-2025]}
BibLaTeX
@online{reference.wolfram_2025_candlestickchart, organization={Wolfram Research}, title={CandlestickChart}, year={2025}, url={https://reference.wolfram.com/language/ref/CandlestickChart.html}, note=[Accessed: 16-November-2025]}