---

description: How to make interactive candlestick charts in Python with Plotly. Six examples of candlestick charts with Pandas, time series, and yahoo finance data.

name: Candlestick Charts

has_thumbnail: true

<span class="c"># Make increasing ohlc sticks and customize their color and name</span>

<span class="n">fig_increasing</span> <span class="o">=</span> <span class="n">FF</span><span class="o">.</span><span class="n">create_candlestick</span><span class="p">(</span><span class="n">df</span><span class="o">.</span><span class="n">Open</span><span class="p">,</span> <span class="n">df</span><span class="o">.</span><span class="n">High</span><span class="p">,</span> <span class="n">df</span><span class="o">.</span><span class="n">Low</span><span class="p">,</span> <span class="n">df</span><span class="o">.</span><span class="n">Close</span><span class="p">,</span> <span class="n">dates</span><span class="o">=</span><span class="n">df</span><span class="o">.</span><span class="n">index</span><span class="p">,</span>

<span class="n">direction</span><span class="o">=</span><span class="s">&#39;increasing&#39;</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s">&#39;AAPL&#39;</span><span class="p">,</span>

<span class="n">line</span><span class="o">=</span><span class="n">Line</span><span class="p">(</span><span class="n">color</span><span class="o">=</span><span class="s">&#39;rgb(150, 200, 250)&#39;</span><span class="p">))</span>

<span class="c"># Make decreasing ohlc sticks and customize their color and name</span>

<span class="c"># Create Line of open values</span>

<span class="n">add_line</span> <span class="o">=</span> <span class="n">Scatter</span><span class="p">(</span>

<span class="n">line</span><span class="o">=</span><span class="n">Line</span><span class="p">(</span><span class="n">color</span><span class="o">=</span><span class="s">&#39;black&#39;</span><span class="p">)</span>

<span class="p">)</span>

create_candlestick(open, high, low, close, dates=None, direction=&apos;both&apos;, **kwargs)

BETA function that creates a candlestick chart

:param (list) open: opening values

:param (list) high: high values

:param (list) low: low values

These kwargs describe other attributes about the ohlc Scatter trace

such as the color or the legend name. For more information on valid

kwargs call help(plotly.graph_objs.Scatter)

:rtype (dict): returns a representation of candlestick chart figure.

Example 1: Simple candlestick chart from a Pandas DataFrame

&#96;&#96;&#96;

import plotly.plotly as py

from plotly.tools import FigureFactory as FF

from datetime import datetime

import pandas.io.data as web

df = web.DataReader(&quot;aapl&quot;, &apos;yahoo&apos;, datetime(2007, 10, 1), datetime(2009, 4, 1))

fig = FF.create_candlestick(df.Open, df.High, df.Low, df.Close, dates=df.index)

py.plot(fig, filename=&apos;finance/aapl-candlestick&apos;, validate=False)

&#96;&#96;&#96;

Example 2: Add text and annotations to the candlestick chart

&#96;&#96;&#96;

fig = FF.create_candlestick(df.Open, df.High, df.Low, df.Close, dates=df.index)

})

py.plot(fig, filename=&apos;finance/aapl-recession-candlestick&apos;, validate=False)

&#96;&#96;&#96;

Example 3: Customize the candlestick colors

&#96;&#96;&#96;

import plotly.plotly as py

from plotly.tools import FigureFactory as FF

from plotly.graph_objs import Line, Marker

from datetime import datetime

import pandas.io.data as web

df = web.DataReader(&quot;aapl&quot;, &apos;yahoo&apos;, datetime(2008, 1, 1), datetime(2009, 4, 1))

# Make increasing candlesticks and customize their color and name

fig_increasing = FF.create_candlestick(df.Open, df.High, df.Low, df.Close, dates=df.index,

direction=&apos;increasing&apos;, name=&apos;AAPL&apos;,

marker=Marker(color=&apos;rgb(150, 200, 250)&apos;),

line=Line(color=&apos;rgb(150, 200, 250)&apos;))

# Make decreasing candlesticks and customize their color and name

fig_decreasing = FF.create_candlestick(df.Open, df.High, df.Low, df.Close, dates=df.index,

direction=&apos;decreasing&apos;,

marker=Marker(color=&apos;rgb(128, 128, 128)&apos;),

line=Line(color=&apos;rgb(128, 128, 128)&apos;))

# Initialize the figure

fig = fig_increasing

# Add decreasing data with .extend()

fig[&apos;data&apos;].extend(fig_decreasing[&apos;data&apos;])

py.iplot(fig, filename=&apos;finance/aapl-candlestick-custom&apos;, validate=False)

&#96;&#96;&#96;

Example 4: Candlestick chart with datetime objects

&#96;&#96;&#96;

import plotly.plotly as py

from plotly.tools import FigureFactory as FF

from datetime import datetime

# Add data

open_data = [33.0, 33.3, 33.5, 33.0, 34.1]

high_data = [33.1, 33.3, 33.6, 33.2, 34.8]

datetime(year=2013, month=12, day=10),

datetime(year=2014, month=1, day=10),

datetime(year=2014, month=2, day=10)]

# Create ohlc

fig = FF.create_candlestick(open_data, high_data,

low_data, close_data, dates=dates)

py.iplot(fig, filename=&apos;finance/simple-candlestick&apos;, validate=False)

&#96;&#96;&#96;

---

description: How to make interactive OHLC charts in Python with Plotly. Six examples of OHLC charts with Pandas, time series, and yahoo finance data.

title: Python OHLC Charts | plotly

has_thumbnail: true

create_ohlc(open, high, low, close, dates=None, direction=&apos;both&apos;, **kwargs)

BETA function that creates an ohlc chart

:param (list) open: opening values

:param (list) high: high values

:param (list) low: low values

These kwargs describe other attributes about the ohlc Scatter trace

such as the color or the legend name. For more information on valid

kwargs call help(plotly.graph_objs.Scatter)

:rtype (dict): returns a representation of an ohlc chart figure.

Example 1: Simple OHLC chart from a Pandas DataFrame

&#96;&#96;&#96;

import plotly.plotly as py

from plotly.tools import FigureFactory as FF

import pandas.io.data as web

df = web.DataReader(&quot;aapl&quot;, &apos;yahoo&apos;, datetime(2008, 8, 15), datetime(2008, 10, 15))

fig = FF.create_ohlc(df.Open, df.High, df.Low, df.Close, dates=df.index)

py.plot(fig, filename=&apos;finance/aapl-ohlc&apos;)

&#96;&#96;&#96;

Example 2: Add text and annotations to the OHLC chart

&#96;&#96;&#96;

import plotly.plotly as py

from plotly.tools import FigureFactory as FF

import pandas.io.data as web

df = web.DataReader(&quot;aapl&quot;, &apos;yahoo&apos;, datetime(2008, 8, 15), datetime(2008, 10, 15))

fig = FF.create_ohlc(df.Open, df.High, df.Low, df.Close, dates=df.index)

# Update the fig - all options here: https://plot.ly/python/reference/#Layout

fig[&apos;layout&apos;].update({

&apos;title&apos;: &apos;The Great Recession&apos;,

&apos;showarrow&apos;: False, &apos;xanchor&apos;: &apos;left&apos;

}]

})

py.plot(fig, filename=&apos;finance/aapl-recession-ohlc&apos;, validate=False)

&#96;&#96;&#96;

Example 3: Customize the OHLC colors

&#96;&#96;&#96;

import plotly.plotly as py

from plotly.tools import FigureFactory as FF

from plotly.graph_objs import Line, Marker

from datetime import datetime

import pandas.io.data as web

df = web.DataReader(&quot;aapl&quot;, &apos;yahoo&apos;, datetime(2008, 1, 1), datetime(2009, 4, 1))

# Make increasing ohlc sticks and customize their color and name

fig_increasing = FF.create_ohlc(df.Open, df.High, df.Low, df.Close, dates=df.index,

direction=&apos;increasing&apos;, name=&apos;AAPL&apos;,

line=Line(color=&apos;rgb(150, 200, 250)&apos;))

# Make decreasing ohlc sticks and customize their color and name

fig_decreasing = FF.create_ohlc(df.Open, df.High, df.Low, df.Close, dates=df.index,

direction=&apos;decreasing&apos;,

line=Line(color=&apos;rgb(128, 128, 128)&apos;))

# Initialize the figure

fig = fig_increasing

# Add decreasing data with .extend()

fig[&apos;data&apos;].extend(fig_decreasing[&apos;data&apos;])

py.iplot(fig, filename=&apos;finance/aapl-ohlc-colors&apos;, validate=False)

&#96;&#96;&#96;

Example 4: OHLC chart with datetime objects

&#96;&#96;&#96;

import plotly.plotly as py

from plotly.tools import FigureFactory as FF

from datetime import datetime

# Add data

open_data = [33.0, 33.3, 33.5, 33.0, 34.1]

high_data = [33.1, 33.3, 33.6, 33.2, 34.8]

datetime(year=2013, month=12, day=10),

datetime(year=2014, month=1, day=10),

datetime(year=2014, month=2, day=10)]

# Create ohlc

fig = FF.create_ohlc(open_data, high_data,

low_data, close_data, dates=dates)

py.iplot(fig, filename=&apos;finance/simple-ohlc&apos;, validate=False)

&#96;&#96;&#96;