.Candlestick()

The .Candlestick() method in Plotly’s graph_objects module is used to create candlestick charts, widely used for visualizing financial data. A candlestick chart displays four key data points for a specific time period:

1. Open: The starting value of the asset.
2. High: The highest value achieved during the time period.
3. Low: The lowest value during the period.
4. Close: The final value of the asset.

Candlestick charts are commonly used to identify trends and patterns in stock prices and forex, helping analysts and traders visualize market behavior and make informed decisions.

Syntax

import plotly.graph_objects as go

go.Candlestick(x=None, open=None, high=None, low=None, close=None, increasing=None, ...)

• x: Represents the x-axis values, typically dates or time intervals for the candlestick chart.
• open: Represents the opening price of the asset for each time period.
• high: Represents the highest price of the asset for each time period.
• low: Represents the lowest price of the asset for each time period.
• close: Represents the closing price of the asset for each time period.
• increasing: Customizes the appearance of candles in cases where the closing price is higher than the opening price. The line color, width, or other styles can be defined.

Note: The ellipsis (...) indicates that additional optional parameters can be specified to customize the candlestick chart further.

Example

The following code example creates a candlestick chart using Plotly’s .candlestick() method. The x-axis represents dates or time periods, and the y-axis displays the opening, highest, lowest, and closing prices for each time period.

import plotly.graph_objects as go

# Sample data
dates = ['2024-12-01', '2024-12-02', '2024-12-03']
open_prices = [100, 105, 110]
high_prices = [110, 115, 120]
low_prices = [95, 100, 105]
close_prices = [105, 110, 115]

# Create the figure
fig = go.Figure(data=[go.Candlestick(
    # Dates or time periods for the x-axis.
    x=dates,
    # Opening prices for each date.
    open=open_prices,
    # Highest prices for each date.
    high=high_prices,
    # Lowest prices for each date.
    low=low_prices,
    # Closing prices for each date.
    close=close_prices
)])

# Customize layout
fig.update_layout(
    title='Sample Candlestick Chart',
    xaxis_title='Date',
    yaxis_title='Price',
    xaxis_rangeslider_visible=False
)

# Display the figure
fig.show()

This example generates an interactive candlestick chart that displays the price movements over specific dates.

The above code generates the following output: