--- title: "CandlestickChart" language: "en" type: "Symbol" summary: "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." keywords: - high low open close - hloc plot - hloc chart - high low close - hlc plot - hlc chart - candlestick - japanese candlestick - stock chart - stock plot - financial chart - financial plot - spinning top - shaved head - shaved bottom - grave stone - Doji - close cut - hanging man - shooting star - abandoned baby - hammer - inverted hammer - bearish harami - bullish harami - upside gap two crowns - dark cloud cover - tweezers bottoms - three mountain tops - three Buddha top - Homma Munehisa - commodities chart - currency chart - derivatives chart canonical_url: "https://reference.wolfram.com/language/ref/CandlestickChart.html" source: "Wolfram Language Documentation" related_guides: - title: "Financial Visualization" link: "https://reference.wolfram.com/language/guide/FinancialVisualization.en.md" - title: "Financial Computation" link: "https://reference.wolfram.com/language/guide/Finance.en.md" - title: "Charting and Information Visualization" link: "https://reference.wolfram.com/language/guide/ChartingAndInformationVisualization.en.md" - title: "Date & Time" link: "https://reference.wolfram.com/language/guide/DateAndTime.en.md" - title: "Date & Time Visualization" link: "https://reference.wolfram.com/language/guide/DateAndTimeVisualization.en.md" related_functions: - title: "TradingChart" link: "https://reference.wolfram.com/language/ref/TradingChart.en.md" - title: "InteractiveTradingChart" link: "https://reference.wolfram.com/language/ref/InteractiveTradingChart.en.md" - title: "DateListPlot" link: "https://reference.wolfram.com/language/ref/DateListPlot.en.md" - title: "FinancialData" link: "https://reference.wolfram.com/language/ref/FinancialData.en.md" - title: "BarChart" link: "https://reference.wolfram.com/language/ref/BarChart.en.md" - title: "KagiChart" link: "https://reference.wolfram.com/language/ref/KagiChart.en.md" - title: "RenkoChart" link: "https://reference.wolfram.com/language/ref/RenkoChart.en.md" - title: "PointFigureChart" link: "https://reference.wolfram.com/language/ref/PointFigureChart.en.md" - title: "LineBreakChart" link: "https://reference.wolfram.com/language/ref/LineBreakChart.en.md" --- # 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) pair | | {datei, Quantity[ohlci, ui]} | a date OHLC with units | | wi[{datei, ohlci}, …] | a date OHLC and wrapper wi | | formi -> 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 wrapper | | TimeSeries[…], EventSeries[…], TemporalData[…] | time series, event series, and temporal data | | w[{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: {Subscript[``col``, ``date``], {Subscript[``col``, ``open``], Subscript[``col``, ``high``], Subscript[``col``, ``low``], Subscript[``col``, ``close``]}} plot values from columns ``{colopen, …, colclose}`` against dates from ``coldate`` * The following wrappers can be used for data elements: | | | | -------------------- | ---------------------------------------------------------- | | Annotation[e, label] | provide an annotation | | Button[e, action] | define an action to execute when the element is clicked | | EventHandler[e, …] | define a general event handler for the element | | Hyperlink[e, uri] | make the element act as a hyperlink | | Labeled[e, …] | display the element with labeling | | PopupWindow[e, cont] | attach a popup window to the element | | StatusArea[e, label] | display in the status area when the element is moused over | | Style[e, opts] | show the element using the specified styles | | Tooltip[e, label] | attach an arbitrary tooltip to the element | * In ``CandlestickChart``, ``Labeled`` and ``Placed`` allow the following positions: | | | | -------------------------------- | ------------------------------------------------------------------------------------ | | Top, Bottom, Left, Right, Center | positions within candlestick | | Above, Below, Before, After | positions outside candlestick | | "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: [] | | | | | --------------------- | ----------------- | ------------------------------------------------------- | | AspectRatio | 1 / GoldenRatio | overall ratio of width to height | | Axes | True | whether to draw axes | | BarSpacing | Automatic | spacing between candles | | ChartBaseStyle | Automatic | overall style for candles | | ChartElementFunction | Automatic | how to generate raw graphics for candlesticks | | ColorFunction | Automatic | how to color candles | | ColorFunctionScaling | True | whether to normalize arguments to ColorFunction | | DateFunction | Automatic | how to convert dates to standard form | | EventLabels | None | events to label | | GridLines | Automatic | grid lines to draw | | GridLinesStyle | Automatic | style for grid lines | | PerformanceGoal | \$PerformanceGoal | aspects of performance to try to optimize | | PlotTheme | \$PlotTheme | overall theme for the chart | | ScalingFunctions | None | how to scale the $y$ axis | | TargetUnits | Automatic | units to display in the chart | | TrendStyle | Automatic | how to style up and down trends | * 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"``. [image] * 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. ### List of all options | | | | | ---------------------- | ----------------- | ---------------------------------------------------------------------------------- | | AlignmentPoint | Center | the default point in the graphic to align with | | AspectRatio | 1 / GoldenRatio | overall ratio of width to height | | Axes | True | whether to draw axes | | AxesLabel | None | axes labels | | AxesOrigin | Automatic | where axes should cross | | AxesStyle | {} | style specifications for the axes | | Background | None | background color for the plot | | BarSpacing | Automatic | spacing between candles | | BaselinePosition | Automatic | how to align with a surrounding text baseline | | BaseStyle | {} | base style specifications for the graphic | | ChartBaseStyle | Automatic | overall style for candles | | ChartElementFunction | Automatic | how to generate raw graphics for candlesticks | | ColorFunction | Automatic | how to color candles | | ColorFunctionScaling | True | whether to normalize arguments to ColorFunction | | ContentSelectable | Automatic | whether to allow contents to be selected | | CoordinatesToolOptions | Automatic | detailed behavior of the coordinates tool | | DateFunction | Automatic | how to convert dates to standard form | | Epilog | {} | primitives rendered after the main plot | | EventLabels | None | events to label | | FormatType | TraditionalForm | the default format type for text | | Frame | False | whether to put a frame around the plot | | FrameLabel | None | frame labels | | FrameStyle | {} | style specifications for the frame | | FrameTicks | Automatic | frame ticks | | FrameTicksStyle | {} | style specifications for frame ticks | | GridLines | Automatic | grid lines to draw | | GridLinesStyle | Automatic | style for grid lines | | ImageMargins | 0. | the margins to leave around the graphic | | ImagePadding | All | what extra padding to allow for labels etc. | | ImageSize | Automatic | the absolute size at which to render the graphic | | LabelStyle | {} | style specifications for labels | | Method | Automatic | details of graphics methods to use | | PerformanceGoal | \$PerformanceGoal | aspects of performance to try to optimize | | PlotLabel | None | an overall label for the plot | | PlotRange | All | range of values to include | | PlotRangeClipping | False | whether to clip at the plot range | | PlotRangePadding | Automatic | how much to pad the range of values | | PlotRegion | Automatic | the final display region to be filled | | PlotTheme | \$PlotTheme | overall theme for the chart | | PreserveImageOptions | Automatic | whether to preserve image options when displaying new versions of the same graphic | | Prolog | {} | primitives rendered before the main plot | | RotateLabel | True | whether to rotate y labels on the frame | | ScalingFunctions | None | how to scale the $y$ axis | | TargetUnits | Automatic | units to display in the chart | | Ticks | Automatic | axes ticks | | TicksStyle | {} | style specifications for axes ticks | | TrendStyle | Automatic | how to style up and down trends | ## Examples (96) ### Basic Examples (2) Chart the prices from a list of values: ```wl In[1]:= data = FinancialData["BAC", "OHLC", {{2009, 5, 1}, {2010, 4, 30}}]; In[2]:= CandlestickChart[data] Out[2]= [image] ``` --- Use three months of prices from ``FinancialData`` entities: ```wl In[1]:= CandlestickChart["SP500"] Out[1]= [image] ``` Specify a date range: ```wl In[2]:= CandlestickChart[{"SP500", {{2009, 1, 1}, {2009, 5, 31}}}] Out[2]= [image] ``` ### Scope (26) #### Data and Wrappers (12) Automatically get quarterly data from today: ```wl In[1]:= CandlestickChart["DOW"] Out[1]= [image] ``` --- Get data from a specific date range: ```wl In[1]:= CandlestickChart[{"IBM", {{2009, 10, 1}, {2010, 3, 31}}}] Out[1]= [image] ``` --- Get data from ``FinancialData`` : ```wl In[1]:= data = FinancialData["IBM", "OHLC", {{2009, 10, 1}, {2010, 3, 31}}]; In[2]:= CandlestickChart[data] Out[2]= [image] ``` --- The data may include units: ```wl In[1]:= data = FinancialData["AAPL", "OHLC", {{2010, 1, 1}, {2010, 2, 28}}]; In[2]:= CandlestickChart[data, AxesLabel -> Automatic] Out[2]= [image] ``` --- Specify the units to use: ```wl In[1]:= data = FinancialData["AAPL", "OHLC", {{2010, 1, 1}, {2010, 2, 28}}]; In[2]:= CandlestickChart[data, AxesLabel -> Automatic, TargetUnits -> "Euros"] Out[2]= [image] ``` --- Data can be ``TimeSeries``, ``EventSeries``, or ``TemporalData`` : ```wl In[1]:= data = EventSeries[FinancialData["BAC", "OHLC", {{2014, 1}, {2014, 4}}]] Out[1]= TemporalData[EventSeries, {{QuantityArray[StructuredArray`StructuredData[{62, 4}, {CompressedData["«970»"], "USDollars", {{1}, {2}}}]]}, CompressedData["«394»"], 1, {"Discrete", 1}, {"Discrete", 1}, 4, {MetaInformation -> {"FinancialProperty" -> {"Open", "High", "Low", "Close"}}, ResamplingMethod -> None, TemporalRegularity -> Automatic, ValueDimensions -> 4}}, True, 14.3] In[2]:= CandlestickChart[data] Out[2]= [image] ``` --- Use wrappers on individual data: ```wl In[1]:= CandlestickChart[{{{2010, 1, 4}, {626.95, 629.51, 624.24, 626.75}}, {{2010, 1, 5}, {627.18, 627.84, 621.54, 623.99}}, Style[{{2010, 1, 6}, {625.86, 625.86, 606.36, 608.26}}, FaceForm[Yellow]], {{2010, 1, 7}, {609.4, 610., 592.65, 594.1}}, {{2010, 1, 8}, {592., 603.25, 589.11, 602.02}}, {{2010, 1, 11}, {604.46, 604.46, 594.04, 601.11}}}] Out[1]= [image] ``` --- Use wrappers on entire datasets: ```wl In[1]:= CandlestickChart[Style[{{{2010, 1, 4}, {626.95, 629.51, 624.24, 626.75}}, {{2010, 1, 5}, {627.18, 627.84, 621.54, 623.99}}, {{2010, 1, 6}, {625.86, 625.86, 606.36, 608.26}}, {{2010, 1, 7}, {609.4, 610., 592.65, 594.1}}, {{2010, 1, 8}, {592., 603.25, 589.11, 602.02}}, {{2010, 1, 11}, {604.46, 604.46, 594.04, 601.11}}}, EdgeForm[Dashed]]] Out[1]= [image] ``` --- Wrappers can be nested: ```wl In[1]:= CandlestickChart[Style[{{{2010, 1, 4}, {626.95, 629.51, 624.24, 626.75}}, {{2010, 1, 5}, {627.18, 627.84, 621.54, 623.99}}, Style[{{2010, 1, 6}, {625.86, 625.86, 606.36, 608.26}}, FaceForm[Yellow]], {{2010, 1, 7}, {609.4, 610., 592.65, 594.1}}, {{2010, 1, 8}, {592., 603.25, 589.11, 602.02}}, {{2010, 1, 11}, {604.46, 604.46, 594.04, 601.11}}}, EdgeForm[Dashed]]] Out[1]= [image] ``` --- Override the default tooltips: ```wl In[1]:= CandlestickChart[{{{2010, 1, 4}, {626.95, 629.51, 624.24, 626.75}}, {{2010, 1, 5}, {627.18, 627.84, 621.54, 623.99}}, Tooltip[{{2010, 1, 6}, {625.86, 625.86, 606.36, 608.26}}, "label"], {{2010, 1, 7}, {609.4, 610., 592.65, 594.1}}, {{2010, 1, 8}, {592., 603.25, 589.11, 602.02}}, {{2010, 1, 11}, {604.46, 604.46, 594.04, 601.11}}}] Out[1]= [image] ``` --- Use ``PopupWindow`` to provide additional drilldown information: ```wl In[1]:= CandlestickChart[PopupWindow[{{{2010, 1, 4}, {626.95, 629.51, 624.24, 626.75}}, {{2010, 1, 5}, {627.18, 627.84, 621.54, 623.99}}, {{2010, 1, 6}, {625.86, 625.86, 606.36, 608.26}}, {{2010, 1, 7}, {609.4, 610., 592.65, 594.1}}, {{2010, 1, 8}, {592., 603.25, 589.11, 602.02}}, {{2010, 1, 11}, {604.46, 604.46, 594.04, 601.11}}}, DateListPlot[FinancialData["AAPL", "Jan. 1, 2005"], PlotLabel -> "AAPL"]]] Out[1]= [image] ``` --- ``Button`` can be used to trigger any action: ```wl In[1]:= CandlestickChart[{{{2010, 1, 4}, {626.95, 629.51, 624.24, 626.75}}, {{2010, 1, 5}, {627.18, 627.84, 621.54, 623.99}}, Button[{{2010, 1, 6}, {625.86, 625.86, 606.36, 608.26}}, Speak["Close at 608.26"]], {{2010, 1, 7}, {609.4, 610., 592.65, 594.1}}, {{2010, 1, 8}, {592., 603.25, 589.11, 602.02}}, {{2010, 1, 11}, {604.46, 604.46, 594.04, 601.11}}}] Out[1]= [image] ``` #### Tabular Data (1) Get tabular data: ```wl In[1]:= stock = ToTabular[IconizedObject[«stock data»], "Columns", <|"ColumnKeys" -> {"date", "open", "high", "low", "close", "volume"}|>] Out[1]= Tabular[Association["RawSchema" -> Association["ColumnProperties" -> Association["date" -> Association["ElementType" -> TypeSpecifier["Date"]["Integer64", "Day", "Gregorian", -6.]], "open" -> Association["ElementType" -> TypeSpecif ... 89, "Shares"], Quantity[142912018, "Shares"], Quantity[135618756, "Shares"], Quantity[112701315, "Shares"], Quantity[104623895, "Shares"], Quantity[92784279, "Shares"], Quantity[102541023, "Shares"]}]]}}]]]] ``` Plot the open, high, low and close prices of a stock as a candlestick: ```wl In[2]:= CandlestickChart[stock -> {"date", {"open", "high", "low", "close"}}] Out[2]= [image] ``` Plot the prices using a stick form: ```wl In[3]:= CandlestickChart[stock -> {"date", {"open", "high", "low", "close"}}, ChartElementFunction -> "OHLC"] Out[3]= [image] ``` #### Styling and Appearance (9) Specify styles for up and down trends: ```wl In[1]:= CandlestickChart[{"C", {{2010, 1, 1}, {2010, 1, 15}}}, TrendStyle -> {Green, Red}] Out[1]= [image] ``` --- Use named preset styles: ```wl In[1]:= CandlestickChart[{"AAPL", {{2010, 1, 1}, {2010, 1, 15}}}, TrendStyle -> "RedGreen"] Out[1]= [image] In[2]:= CandlestickChart[{"JPM", {{2010, 1, 1}, {2010, 1, 15}}}, TrendStyle -> "BlackWhite"] Out[2]= [image] ``` --- ``ChartBaseStyle`` can be used to set a style for all chart elements: ```wl In[1]:= CandlestickChart[{"AAPL", {{2010, 1, 1}, {2010, 1, 15}}}, TrendStyle -> {Green, Red}, ChartBaseStyle -> EdgeForm[]] Out[1]= [image] ``` --- ``Style`` can be used to override styles: ```wl In[1]:= CandlestickChart[Style[{{{2010, 1, 4}, {626.95, 629.51, 624.24, 626.75}}, {{2010, 1, 5}, {627.18, 627.84, 621.54, 623.99}}, {{2010, 1, 6}, {625.86, 625.86, 606.36, 608.26}}, {{2010, 1, 7}, {609.4, 610., 592.65, 594.1}}, {{2010, 1, 8}, {592., 603.25, 589.11, 602.02}}, {{2010, 1, 11}, {604.46, 604.46, 594.04, 601.11}}}, EdgeForm[None]], ChartBaseStyle -> EdgeForm[Dashed]] Out[1]= [image] ``` --- Use built-in, programmatically generated bars: ```wl In[1]:= ChartElementData["CandlestickChart"] Out[1]= {"ArrowCandlestick", "Candlestick", "FadingCandlestick", "FadingOHLC", "GlassCandlestick", "HLC", "OHLC"} In[2]:= Table[CandlestickChart[{"IBM", {{2010, 1, 1}, {2010, 1, 15}}}, ChartElementFunction -> f], {f, {"FadingOHLC", "GlassCandlestick"}}] Out[2]= {[image], [image]} ``` --- Space between candlesticks is automatically adjusted based on the number of data points: ```wl In[1]:= {CandlestickChart[{"MSFT", {{2010, 1, 1}, {2010, 1, 15}}}], CandlestickChart[{"MSFT", {{2010, 1, 1}, {2010, 2, 1}}}]} Out[1]= {[image], [image]} ``` --- Appearance changes based on the number of data points: ```wl In[1]:= {CandlestickChart[{"MSFT", {{2010, 1, 1}, {2010, 1, 15}}}], CandlestickChart[{"MSFT", {{2009, 2, 1}, {2010, 2, 1}}}, PlotRange -> {{{2010, 1, 1}, {2010, 1, 15}}, All}], CandlestickChart[{"MSFT", {{2008, 2, 1}, {2010, 2, 1}}}, PlotRange -> {{{2010, 1, 1}, {2010, 1, 15}}, All}]} Out[1]= {[image], [image], [image]} ``` --- Use a theme with simple ticks and grid lines in a bright color scheme: ```wl In[1]:= CandlestickChart[{"JPM", {{2010, 4, 1}, {2010, 4, 13}}}, PlotTheme -> "Business", BarSpacing -> Tiny] Out[1]= [image] ``` --- Use a theme with a dark background in a high-contrast color scheme: ```wl In[1]:= CandlestickChart[{"JPM", {{2010, 4, 1}, {2010, 4, 13}}}, PlotTheme -> "Marketing", BarSpacing -> Tiny] Out[1]= [image] ``` #### Labeling (4) Use ``Labeled`` to add a label to a candlestick: ```wl In[1]:= CandlestickChart[{{{2010, 1, 4}, {626.95, 629.51, 624.24, 626.75}}, {{2010, 1, 5}, {627.18, 627.84, 621.54, 623.99}}, Labeled[{{2010, 1, 6}, {625.86, 625.86, 606.36, 608.26}}, "label"], {{2010, 1, 7}, {609.4, 610., 592.65, 594.1}}, {{2010, 1, 8}, {592., 603.25, 589.11, 602.02}}, {{2010, 1, 11}, {604.46, 604.46, 594.04, 601.11}}}] Out[1]= [image] ``` --- Use symbolic positions for label placement: ```wl In[1]:= Table[CandlestickChart[{{{2010, 2, 9}, {539.54, 541.53, 535.07, 536.44}}, {{2010, 2, 10}, {534.07, 537.79, 523.69, 534.45}}, Labeled[{{2010, 2, 11}, {530.32, 545.49, 526.5, 540.4}}, "label", p], {{2010, 2, 12}, {532.97, 537.15, 530.5, 533.12}}, {{2010, 2, 16}, {536.87, 544.13, 534.3, 541.3}}}, PlotLabel -> p], {p, {Bottom, Center, Top}}] Out[1]= {[image], [image], [image]} In[2]:= Table[CandlestickChart[{{{2010, 2, 9}, {539.54, 541.53, 535.07, 536.44}}, {{2010, 2, 10}, {534.07, 537.79, 523.69, 534.45}}, Labeled[{{2010, 2, 11}, {530.32, 545.49, 526.5, 540.4}}, "label", p], {{2010, 2, 12}, {532.97, 537.15, 530.5, 533.12}}, {{2010, 2, 16}, {536.87, 544.13, 534.3, 541.3}}}, PlotLabel -> p], {p, {Above, Below}}] Out[2]= {[image], [image]} In[3]:= Table[CandlestickChart[{{{2010, 2, 9}, {539.54, 541.53, 535.07, 536.44}}, {{2010, 2, 10}, {534.07, 537.79, 523.69, 534.45}}, Labeled[{{2010, 2, 11}, {530.32, 545.49, 526.5, 540.4}}, "label", p], {{2010, 2, 12}, {532.97, 537.15, 530.5, 533.12}}, {{2010, 2, 16}, {536.87, 544.13, 534.3, 541.3}}}, PlotLabel -> p], {p, {"High", "Low", "Open", "Close"}}] Out[3]= {[image], [image], [image], [image]} ``` --- Label a list of date events: ```wl In[1]:= CandlestickChart[{"BAC", {{2010, 2, 9}, {2010, 2, 17}}}, EventLabels -> {{2010, 2, 9} -> "label1", {2010, 2, 11} -> "label2", {2010, 2, 16} -> "label3"}] Out[1]= [image] ``` --- Use ``Placed`` to control the positioning of labels, using the same positions as for ``Labeled``: ```wl In[1]:= CandlestickChart[{"WFC", {{2010, 2, 9}, {2010, 2, 17}}}, EventLabels -> {{2010, 2, 9} -> Placed["label1", Above], {2010, 2, 11} -> Placed["label2", "Low"], {2010, 2, 16} -> Placed["label3", Bottom]}] Out[1]= [image] ``` ### Options (64) #### AspectRatio (3) By default, ``AspectRatio`` uses a fixed ratio of height to width for the chart: ```wl In[1]:= CandlestickChart[{"SP500", {{2019, 1, 1}, {2020, 5, 31}}}, TrendStyle -> {Green, Red}] Out[1]= [image] ``` --- Make the height the same as the width with ``AspectRatio -> 1`` : ```wl In[1]:= CandlestickChart[{"SP500", {{2019, 1, 1}, {2020, 5, 31}}}, TrendStyle -> {Green, Red}, AspectRatio -> 1] Out[1]= [image] ``` --- ``AspectRatio -> Full`` adjusts the height and width to tightly fit inside other constructs: ```wl In[1]:= plot = CandlestickChart[{"SP500", {{2019, 1, 1}, {2020, 5, 31}}}, TrendStyle -> {Green, Red}, AspectRatio -> Full]; In[2]:= {Framed[Pane[plot, {120, 100}]], Framed[Pane[plot, {100, 100}]], Framed[Pane[plot, {100, 50}]]} Out[2]= {[image], [image], [image]} ``` #### Axes (4) By default, ``Axes`` are drawn: ```wl In[1]:= CandlestickChart[{"TSLA", {{2019, 1}, {2021, 1}}}] Out[1]= [image] ``` --- Use ``Axes -> False`` to turn off axes: ```wl In[1]:= CandlestickChart[{"TSLA", {{2019, 10}, {2021, 1}}}, Axes -> False] Out[1]= [image] ``` --- Use ``AxesOrigin`` to specify where the axes intersect: ```wl In[1]:= CandlestickChart[{"TSLA", {{2019, 10}, {2021, 1}}}, AxesOrigin -> {{2019, 01, 1}, 1}] Out[1]= [image] ``` --- Turn each axis on individually: ```wl In[1]:= {CandlestickChart[{"TSLA", {{2019, 10}, {2021, 1}}}, Axes -> {True, False}], CandlestickChart[{"TSLA", {{2019, 10}, {2021, 1}}}, Axes -> {False, True}]} Out[1]= {[image], [image]} ``` #### AxesLabel (2) Axes are not labeled by default: ```wl In[1]:= CandlestickChart[{"TSLA", {{2019, 1}, {2021, 1}}}] Out[1]= [image] ``` --- Place a label on the $y$ axis: ```wl In[1]:= CandlestickChart[{"TSLA", {{2019, 1}, {2021, 1}}}, AxesLabel -> "$"] Out[1]= [image] ``` #### AxesOrigin (3) The position of the axes is determined automatically: ```wl In[1]:= CandlestickChart[{"AAPL", {{2010, 2, 9}, {2010, 2, 27}}}] Out[1]= [image] ``` --- Specify an explicit date as origin for the axes: ```wl In[1]:= CandlestickChart[{"AAPL", {{2010, 2, 9}, {2010, 2, 27}}}, AxesOrigin -> {{2010, 2, 28}, Automatic}] Out[1]= [image] ``` --- Use named positions for the $y$ axis: ```wl In[1]:= Table[CandlestickChart[{"AAPL", {{2010, 2, 9}, {2010, 2, 27}}}, AxesOrigin -> {i, Automatic}, PlotLabel -> i], {i, {Left, Right}}] Out[1]= {[image], [image]} ``` #### BarSpacing (4) Use automatically determined spacing between candlesticks: ```wl In[1]:= Table[CandlestickChart[{"IBM", {{2010, 1, 1}, DatePlus[{2010, 1, 1}, {w, "Week"}]}}, BarSpacing -> Automatic], {w, {1, 2, 4, 8}}] Out[1]= {[image], [image], [image], [image]} ``` --- Use no spacing: ```wl In[1]:= CandlestickChart[{"IBM", {{2010, 1}, {2010, 1, 15}}}, BarSpacing -> None] Out[1]= [image] ``` --- Use symbolic presets: ```wl In[1]:= Table[CandlestickChart[{"IBM", {{2010, 1}, {2010, 1, 15}}}, BarSpacing -> s, PlotLabel -> s], {s, {Tiny, Small, Medium, Large}}] Out[1]= {[image], [image], [image], [image]} ``` --- Use explicit spacing between candlesticks: ```wl In[1]:= Table[CandlestickChart[{"IBM", {{2010, 1}, {2010, 1, 15}}}, BarSpacing -> s, PlotLabel -> s], {s, {0.1, 0.5, 1, 2}}] Out[1]= {[image], [image], [image], [image]} ``` #### ChartBaseStyle (5) Use ``ChartBaseStyle`` to style candlesticks: ```wl In[1]:= CandlestickChart[{"IBM", {{2010, 1}, {2010, 1, 15}}}, ChartBaseStyle -> Directive[EdgeForm[Dashed], Black]] Out[1]= [image] In[2]:= CandlestickChart[{"IBM", {{2010, 1}, {2010, 1, 15}}}, ChartBaseStyle -> Directive[Thick, Dotted]] Out[2]= [image] ``` --- ``ChartBaseStyle`` combines with ``TrendStyle``: ```wl In[1]:= CandlestickChart[{"IBM", {{2010, 1}, {2010, 1, 15}}}, TrendStyle -> {Blue, Orange}, ChartBaseStyle -> EdgeForm[Dashed]] Out[1]= [image] ``` --- ``TrendStyle`` may override settings for ``ChartBaseStyle``: ```wl In[1]:= CandlestickChart[{"IBM", {{2010, 1}, {2010, 1, 15}}}, TrendStyle -> {Directive[LightGreen, EdgeForm[Green]], Directive[LightRed, EdgeForm[Red]]}, ChartBaseStyle -> Directive[EdgeForm[Dashed], Black]] Out[1]= [image] ``` --- ``Style`` may override settings for ``ChartBaseStyle`` : ```wl In[1]:= CandlestickChart[Style[{{{2010, 1, 4}, {626.95, 629.51, 624.24, 626.75}}, {{2010, 1, 5}, {627.18, 627.84, 621.54, 623.99}}, {{2010, 1, 6}, {625.86, 625.86, 606.36, 608.26}}, {{2010, 1, 7}, {609.4, 610., 592.65, 594.1}}, {{2010, 1, 8}, {592., 603.25, 589.11, 602.02}}, {{2010, 1, 11}, {604.46, 604.46, 594.04, 601.11}}, {{2010, 1, 12}, {597.65, 598.16, 588., 590.48}}, {{2010, 1, 13}, {576.49, 588.38, 573.9, 587.09}}, {{2010, 1, 14}, {583.9, 594.2, 582.81, 589.85}}, {{2010, 1, 15}, {593.34, 593.56, 578.04, 580.}}}, EdgeForm[Blue]], ChartBaseStyle -> EdgeForm[Dashed]] Out[1]= [image] ``` --- ``ChartBaseStyle`` combines with ``ColorFunction`` : ```wl In[1]:= CandlestickChart[{"IBM", {{2010, 1, 1}, {2010, 1, 15}}}, ChartBaseStyle -> Directive[EdgeForm[Dashed], Black], ColorFunction -> (ColorData["RedGreenSplit"][#6]&)] Out[1]= [image] ``` #### ChartElementFunction (3) Get a list of built-in settings for ``ChartElementFunction`` : ```wl In[1]:= ChartElementData["CandlestickChart"] Out[1]= {"ArrowCandlestick", "Candlestick", "FadingCandlestick", "FadingOHLC", "GlassCandlestick", "HLC", "OHLC"} ``` --- For detailed settings, use Palettes ▶ ChartElementSchemes : ```wl In[1]:= Table[CandlestickChart[{"IBM", {{2010, 1}, {2010, 1, 15}}}, ChartElementFunction -> f, PlotLabel -> f], {f, {"FadingCandlestick", "GlassCandlestick", "ArrowCandlestick", "FadingOHLC"}}] Out[1]= {[image], [image], [image], [image]} In[2]:= Table[CandlestickChart[{"IBM", {{2010, 1}, {2010, 1, 31}}}, ChartElementFunction -> f, PlotLabel -> f], {f, {"OHLC", "HLC"}}] Out[2]= {[image], [image]} ``` --- Write a custom ``ChartElementFunction`` : ```wl In[1]:= zigzag[{{x0_, x1_}, {y0_, y1_}}, {o_, h_, l_, c_}, __] := If[o < c, Line[Transpose[{x0 + {0, 1 / 3, 2 / 3, 1} * (x1 - x0), {o, l, h, c}}]], Line[Transpose[{x0 + {0, 1 / 3, 2 / 3, 1} * (x1 - x0), {o, h, l, c}}]]] In[2]:= CandlestickChart[{"IBM", {{2010, 1}, {2010, 1, 31}}}, ChartElementFunction -> zigzag, BarSpacing -> Tiny] Out[2]= [image] ``` #### ColorFunction (4) Color the candlesticks by scaled ``date``, ``open``, ``high``, ``low``, ``close``, or ``trend`` value: ```wl In[1]:= Table[CandlestickChart[{"IBM", {{2010, 1}, {2010, 1, 15}}}, ColorFunction -> Function[{date, open, high, low, close, trend}, Evaluate[ColorData["DeepSeaColors"][cf]]], PlotLabel -> cf], {cf, {date, open, high, low, close, trend}}] Out[1]= {[image], [image], [image], [image], [image], [image]} ``` --- Color by the size and direction of price changes: ```wl In[1]:= CandlestickChart[{"IBM", {{2010, 1}, {2010, 1, 15}}}, ColorFunction -> (ColorData["RedGreenSplit"][#6]&)] Out[1]= [image] ``` --- Color by a trigger point: ```wl In[1]:= CandlestickChart[{"IBM", {{2009, 12, 15}, {2010, 1, 15}}}, ColorFunction -> Function[{date, open, high, low, close, trend}, If[close > 122, Orange, Opacity[0.3]]], ColorFunctionScaling -> False] Out[1]= [image] ``` --- ``ColorFunction`` overrides styles in ``TrendStyle``: ```wl In[1]:= CandlestickChart[{"IBM", {{2009, 12, 15}, {2010, 1, 15}}}, TrendStyle -> {Blue, Orange}, ColorFunction -> (ColorData["RedGreenSplit"][#6]&)] Out[1]= [image] ``` #### ColorFunctionScaling (3) By default, scaled values are used: ```wl In[1]:= CandlestickChart[{"IBM", {{2010, 1}, {2010, 1, 15}}}, ColorFunction -> Function[{date, open, high, low, close, trend}, ColorData["Rainbow"][open]]] Out[1]= [image] ``` --- Use ``ColorFunctionScaling -> False`` to get unscaled values: ```wl In[1]:= CandlestickChart[{"IBM", {{2009, 12, 15}, {2010, 1, 15}}}, ColorFunctionScaling -> False, ColorFunction -> Function[{date, open, high, low, close, trend}, If[open < 120, {Opacity[0.25]}, None]]] Out[1]= [image] ``` --- Use unscaled dates to color the candlesticks according to the day of the week: ```wl In[1]:= CandlestickChart[{"IBM", {{2009, 12, 15}, {2010, 1, 15}}}, ColorFunctionScaling -> False, ColorFunction -> Function[{date, open, high, low, close, trend}, Switch[DateString[date, "DayName"], "Monday", Yellow, "Tuesday", Green, "Wednesday", Blue, "Thursday", Purple, "Friday", Red]]] Out[1]= [image] ``` #### EventLabels (6) Label a date event: ```wl In[1]:= CandlestickChart[{"IBM", {{2010, 1, 1}, {2010, 1, 15}}}, EventLabels -> {{2010, 1, 6} -> Column[{"↑", "label"}, Center]}] Out[1]= [image] ``` --- Use ``Placed`` to control label placement outside the candlestick: ```wl In[1]:= Table[CandlestickChart[{"IBM", {{2010, 1, 1}, {2010, 1, 15}}}, EventLabels -> {{2010, 1, 6} -> Placed["label", i]}, PlotLabel -> i], {i, {Above, Below, Before, After}}] Out[1]= {[image], [image], [image], [image]} ``` --- Use positions inside the candlestick: ```wl In[1]:= Table[CandlestickChart[{"IBM", {{2010, 1, 1}, {2010, 1, 15}}}, EventLabels -> {{2010, 1, 8} -> Placed["◆", i]}, PlotLabel -> i], {i, {Top, Bottom}}] Out[1]= {[image], [image]} ``` --- Place labels at the open, high, low, and close prices: ```wl In[1]:= Table[CandlestickChart[{"IBM", {{2010, 2, 9}, {2010, 2, 16}}}, EventLabels -> {{2010, 2, 11} -> Placed["◆", i]}, PlotLabel -> i], {i, {"Open", "Close", "High", "Low"}}] Out[1]= {[image], [image], [image], [image]} ``` --- Use callouts: ```wl In[1]:= Table[CandlestickChart[{"IBM", {{2010, 1, 1}, {2010, 1, 15}}}, EventLabels -> {{2010, 1, 6} -> Placed["label", i]}, PlotLabel -> i], {i, {"CalloutHigh", "CalloutLow", "CalloutOpen", "CalloutClose"}}] Out[1]= {[image], [image], [image], [image]} ``` --- Use ``Placed`` to control label appearance: ```wl In[1]:= Table[CandlestickChart[{"IBM", {{2010, 1, 1}, {2010, 1, 15}}}, EventLabels -> {{2010, 1, 6} -> Placed["label", i, "GlassBubble"]}, PlotLabel -> i], {i, {"CalloutHigh", "CalloutLow", "CalloutOpen", "CalloutClose"}}] Out[1]= {[image], [image], [image], [image]} ``` #### GridLines (4) ``GridLines`` are used by default: ```wl In[1]:= CandlestickChart[{"IBM", {{2009, 12}, {2010, 3}}}] Out[1]= [image] ``` --- Turn off date grid lines: ```wl In[1]:= CandlestickChart[{"IBM", {{2009, 12}, {2010, 3}}}, GridLines -> {None, Automatic}] Out[1]= [image] ``` Turn off price grid lines: ```wl In[2]:= CandlestickChart[{"IBM", {{2009, 12}, {2010, 3}}}, GridLines -> {Automatic, None}] Out[2]= [image] ``` --- Place grid lines at month or year boundaries: ```wl In[1]:= Table[CandlestickChart[{"IBM", {{2010, 3, 20}, {2010, 4, 10}}}, GridLines -> {i, Automatic}], {i, {"Month", "Year"}}] Out[1]= {[image], [image]} ``` --- Use dotted grid lines for months and red grid lines for years: ```wl In[1]:= CandlestickChart[{"IBM", {{2009, 10, 20}, {2010, 4, 10}}}, GridLines -> {{{"Year", Directive[Dashing[{}], Red]}, "Month"}, Automatic}] Out[1]= [image] ``` #### GridLinesStyle (3) By default, ``GridLinesStyle`` uses dotted grid lines with emphasized year grid lines: ```wl In[1]:= CandlestickChart[{"IBM", {{2009, 11, 1}, {2010, 5, 20}}}] Out[1]= [image] ``` --- Style grid lines: ```wl In[1]:= CandlestickChart[{"IBM", {{2009, 11, 1}, {2010, 5, 20}}}, GridLinesStyle -> {Blue, Dotted}] Out[1]= [image] ``` --- ``GridLines`` overrides ``GridLinesStyle`` : ```wl In[1]:= CandlestickChart[{"IBM", {{2009, 11, 1}, {2010, 5, 20}}}, GridLines -> {{{"Month", Blue}}, None}, GridLinesStyle -> Red] Out[1]= [image] ``` #### Method (4) The default mouseover effect is a bouncing ball and axis highlight: ```wl In[1]:= CandlestickChart[{"AAPL", {{2010, 5, 1}, {2010, 5, 20}}}, Method -> {"MouseoverEffect" -> Automatic}] Out[1]= [image] ``` --- Use no mouseover effect: ```wl In[1]:= CandlestickChart[{"SP500", {{2010, 5, 1}, {2010, 5, 20}}}, Method -> {"MouseoverEffect" -> None}] Out[1]= [image] ``` --- Use only the bouncing ball: ```wl In[1]:= CandlestickChart[{"C", {{2010, 5, 1}, {2010, 5, 20}}}, Method -> {"MouseoverEffect" -> "BouncingBall"}] Out[1]= [image] ``` Style the bouncing ball with ``"HighlightStyle"`` : ```wl In[2]:= CandlestickChart[{"JPM", {{2010, 5, 1}, {2010, 5, 20}}}, Method -> {"HighlightStyle" -> Directive[PointSize[Large], Yellow], "MouseoverEffect" -> "BouncingBall"}] Out[2]= [image] ``` --- Use only the axis highlight: ```wl In[1]:= CandlestickChart[{"WFC", {{2010, 5, 1}, {2010, 5, 20}}}, Method -> {"MouseoverEffect" -> "AxisHighlight"}] Out[1]= [image] ``` Style the axis highlight: ```wl In[2]:= CandlestickChart[{"AAPL", {{2010, 5, 1}, {2010, 5, 20}}}, Method -> {"AxisHighlightStyle" -> Yellow}] Out[2]= [image] ``` Specify the height in pixels for the axis highlight: ```wl In[3]:= CandlestickChart[{"IBM", {{2010, 5, 1}, {2010, 5, 20}}}, Method -> {"AxisHighlightHeight" -> 5, "AxisHighlightStyle" -> Orange}] Out[3]= [image] ``` #### PerformanceGoal (3) Generate a candlestick chart with interactive highlighting: ```wl In[1]:= CandlestickChart[{"IBM", {{2009, 12, 15}, {2010, 1, 15}}}, PerformanceGoal -> "Quality"] Out[1]= [image] ``` --- Emphasize performance by disabling interactive behaviors: ```wl In[1]:= CandlestickChart[{"IBM", {{2009, 12, 15}, {2010, 1, 15}}}, PerformanceGoal -> "Speed"] Out[1]= [image] ``` --- Typically, less memory is required for non-interactive charts: ```wl In[1]:= Table[ByteCount@CandlestickChart[{"IBM", {{2009, 12, 15}, {2010, 1, 15}}}, PerformanceGoal -> p], {p, {"Quality", "Speed"}}] Out[1]= {66328, 31072} ``` #### PlotRange (3) ``CandlestickChart`` automatically draws all price dates: ```wl In[1]:= CandlestickChart[{"AAPL", {{2010, 2}, {2010, 5}}}] Out[1]= [image] ``` --- Limit to a specific date range: ```wl In[1]:= CandlestickChart[{"AAPL", {{2010, 2}, {2010, 5}}}, PlotRange -> {{{2010, 3, 1}, {2010, 3, 12}}, Automatic}] Out[1]= [image] ``` --- ``PlotRange`` only includes dates for which there is data: ```wl In[1]:= CandlestickChart[{"AAPL", {{2010, 2, 1}, {2010, 3, 31}}}, PlotRange -> {{{2010, 2, 1}, {2010, 4, 30}}, Automatic}] Out[1]= [image] ``` #### PlotTheme (2) Use a theme with simple ticks and grid lines in a bright color scheme: ```wl In[1]:= CandlestickChart[{"AAPL", {{2014, 2, 1}, {2014, 3, 30}}}, PlotTheme -> "Business"] Out[1]= [image] ``` --- Change the trend style and use fading OHLC: ```wl In[1]:= CandlestickChart[{"AAPL", {{2014, 2, 1}, {2014, 3, 30}}}, PlotTheme -> "Business", TrendStyle -> "PurpleGold", ChartElementFunction -> "FadingOHLC"] Out[1]= [image] ``` #### ScalingFunctions (2) Prices are normally shown on a linear scale: ```wl In[1]:= CandlestickChart[{"AAPL", {{2000, 1, 1}, {2006, 1, 1}}}] Out[1]= [image] ``` --- Show prices on a logarithmic scale: ```wl In[1]:= CandlestickChart[{"AAPL", {{2000, 1, 1}, {2006, 1, 1}}}, ScalingFunctions -> "Log"] Out[1]= [image] ``` #### TrendStyle (6) ``TrendStyle`` uses green for up trends and red for down trends by default: ```wl In[1]:= CandlestickChart[{"FORD", {{2010, 1, 1}, {2010, 1, 31}}}] Out[1]= [image] ``` --- Use black for up trends and red for down trends: ```wl In[1]:= CandlestickChart[{"FORD", {{2010, 1, 1}, {2010, 1, 31}}}, TrendStyle -> {Black, Red}] Out[1]= [image] ``` --- Use named styles: ```wl In[1]:= Table[CandlestickChart[{"FORD", {{2010, 1, 1}, {2010, 1, 31}}}, TrendStyle -> ts, PlotLabel -> ts], {ts, {"BlueYellow", "PurpleGold", "BrownYellow", "Blue", "Gold", "BlackSilver"}}] Out[1]= {[image], [image], [image], [image], [image], [image]} ``` --- ``TrendStyle`` combines with ``ChartBaseStyle`` : ```wl In[1]:= CandlestickChart[{"FORD", {{2010, 1, 1}, {2010, 1, 31}}}, TrendStyle -> {EdgeForm[Green], EdgeForm[Red]}, ChartBaseStyle -> FaceForm[]] Out[1]= [image] ``` --- With ``TrendStyle`` set to ``None``, the base style is used for up trends and empty bars are used for down trends: ```wl In[1]:= CandlestickChart[{"FORD", {{2010, 1, 1}, {2010, 1, 31}}}, TrendStyle -> None] Out[1]= [image] ``` --- ``TrendStyle -> style`` uses ``style`` for up trends and empty bars for down trends: ```wl In[1]:= CandlestickChart[{"FORD", {{2010, 1, 1}, {2010, 1, 31}}}, TrendStyle -> Purple] Out[1]= [image] ``` ### Properties & Relations (4) Use ``TradingChart`` to visualize and analyze financial data: ```wl In[1]:= TradingChart[{"IBM", {{2010, 1, 1}, {2010, 6, 1}}}, {"SMA", "V"}] Out[1]= [image] ``` --- Use ``InteractiveTradingChart`` to visualize and interactively analyze financial data: ```wl In[1]:= InteractiveTradingChart[{"AAPL", {{2009, 6, 1}, {2010, 6, 1}}}] Out[1]= [image] ``` --- Use ``PointFigureChart``, ``LineBreakChart``, ``RenkoChart``, and ``KagiChart`` to analyze the relation of financial prices and time: ```wl In[1]:= {PointFigureChart["AAPL"], LineBreakChart["AAPL"], RenkoChart["AAPL"], KagiChart["AAPL"]} Out[1]= {[image], [image], [image], [image]} ``` --- Use ``DateListPlot`` to visualize financial data: ```wl In[1]:= DateListPlot[FinancialData["MSFT", {{2010, 1, 1}, {2010, 6, 1}}]] Out[1]= [image] ``` ## See Also * [`TradingChart`](https://reference.wolfram.com/language/ref/TradingChart.en.md) * [`InteractiveTradingChart`](https://reference.wolfram.com/language/ref/InteractiveTradingChart.en.md) * [`DateListPlot`](https://reference.wolfram.com/language/ref/DateListPlot.en.md) * [`FinancialData`](https://reference.wolfram.com/language/ref/FinancialData.en.md) * [`BarChart`](https://reference.wolfram.com/language/ref/BarChart.en.md) * [`KagiChart`](https://reference.wolfram.com/language/ref/KagiChart.en.md) * [`RenkoChart`](https://reference.wolfram.com/language/ref/RenkoChart.en.md) * [`PointFigureChart`](https://reference.wolfram.com/language/ref/PointFigureChart.en.md) * [`LineBreakChart`](https://reference.wolfram.com/language/ref/LineBreakChart.en.md) ## Related Guides * [Financial Visualization](https://reference.wolfram.com/language/guide/FinancialVisualization.en.md) * [Financial Computation](https://reference.wolfram.com/language/guide/Finance.en.md) * [Charting and Information Visualization](https://reference.wolfram.com/language/guide/ChartingAndInformationVisualization.en.md) * [Date & Time](https://reference.wolfram.com/language/guide/DateAndTime.en.md) * [Date & Time Visualization](https://reference.wolfram.com/language/guide/DateAndTimeVisualization.en.md) ## History * [Introduced in 2010 (8.0)](https://reference.wolfram.com/language/guide/SummaryOfNewFeaturesIn80.en.md) \| [Updated in 2012 (9.0)](https://reference.wolfram.com/language/guide/SummaryOfNewFeaturesIn90.en.md) ▪ [2014 (10.0)](https://reference.wolfram.com/language/guide/SummaryOfNewFeaturesIn100.en.md) ▪ [2025 (14.2)](https://reference.wolfram.com/language/guide/SummaryOfNewFeaturesIn142.en.md)