Gráficos de candlestick

Quatro preços em uma imagem

Um gráfico de linhas dos fechamentos joga fora a maior parte de um dia. Um candle guarda quatro preços de uma vez: abertura, máxima, mínima e fechamento. O corpo grosso vai da abertura ao fechamento e é colorido pela direção (verde quando o fechamento é igual ou maior que a abertura, vermelho caso contrário). O pavio fino vai da mínima à máxima. Num relance você vê para onde o dia foi, que amplitude teve e se compradores ou vendedores venceram.

import numpy as np
import pandas as pd

df = pd.DataFrame(
    {
        "open":  [100.0, 103.0, 102.0, 104.0],
        "high":  [104.0, 105.0, 106.0, 104.5],
        "low":   [ 99.0, 101.0, 101.5, 101.0],
        "close": [103.0, 102.0, 105.5, 104.0],
    },
    index=pd.bdate_range("2026-03-02", periods=4),
)

# Green when the day closed at or above its open, red otherwise: one np.where on whole columns
colors = np.where(df["close"] >= df["open"], "green", "red")
print(colors.tolist())   # ['green', 'red', 'green', 'green']

Calcular o corpo

Um corpo é um retângulo. Começa no menor entre a abertura e o fechamento (df[["open", "close"]].min(axis=1) pega o mínimo linha a linha) e sua altura é a diferença absoluta abs(close - open). Um dia que abre e fecha ao mesmo preço tem corpo de altura 0: um doji, um candle de indecisão. Comparar o corpo com a amplitude total high - low diz o quanto o dia foi decisivo, e fazer isso em colunas inteiras acha todos os dojis de um ano em uma linha.

body = pd.DataFrame({
    "bottom": df[["open", "close"]].min(axis=1),    # the lower of open and close, row by row
    "height": (df["close"] - df["open"]).abs(),
})
print(body)
#             bottom  height
# 2026-03-02   100.0     3.0
# 2026-03-03   102.0     1.0
# 2026-03-04   102.0     3.5
# 2026-03-05   104.0     0.0

# Body as a share of the day's range: the last day is a doji
share = body["height"] / (df["high"] - df["low"])
print(share.round(2).tolist())          # [0.6, 0.25, 0.78, 0.0]
print((share <= 0.1).tolist())          # [False, False, False, True]

Desenhar: pavios e barras

O matplotlib não tem uma chamada para candles, mas duas simples bastam. ax.vlines(x, ymin, ymax) desenha de uma vez uma linha vertical para cada x: são os pavios, da mínima à máxima. ax.bar(x, height, bottom=..., width=0.6, color=...) desenha uma barra para cada x a partir de bottom: são os corpos, e color aceita uma lista com uma cor por barra. Coloque os candles nas posições 0, 1, 2, ... (np.arange(len(df))) e não em datas, para que fins de semana não deixem buracos. Passar colunas inteiras evita qualquer laço sobre os dias.

import matplotlib
matplotlib.use("Agg")
import matplotlib.pyplot as plt

fig, ax = plt.subplots()
x = np.arange(len(df))
ax.vlines(x, df["low"], df["high"], color="black", linewidth=1)                       # the wicks
ax.bar(x, body["height"], bottom=body["bottom"], width=0.6, color=colors)               # the bodies

print(len(ax.collections), len(ax.patches))            # 1 4   one set of wicks, four bodies
print([p.get_y() for p in ax.patches])                  # [100.0, 102.0, 102.0, 104.0]   body bottoms
print(ax.collections[0].get_segments()[0].tolist())     # [[0.0, 99.0], [0.0, 104.0]]    the first wick, low to high

# Candles whose body is at most 10% of the day's range are dojis
doji = share <= 0.1
print(df.index[doji].strftime("%d %b").tolist())   # ['05 Mar']

• Um candle mostra abertura, máxima, mínima e fechamento: um corpo da abertura ao fechamento, um pavio da mínima à máxima.
• A base do corpo é min(open, close) linha a linha (min(axis=1)), a altura abs(close - open); um corpo de 0 é um doji.
• Desenhe todos os pavios com uma só chamada ax.vlines e todos os corpos com uma só chamada ax.bar (lista de cores); sem laço sobre os dias.

A seguir: os histogramas e as distribuições, para contar com que frequência os retornos caem em cada faixa.

Lab: o que é avaliado

• Colorir cada candle pela direção com candle_colors25 pts
• Medir o corpo de cada candle com candle_body25 pts
• Encontrar os dias de indecisão com doji_days25 pts
• Desenhar os candles em um Axes com draw_candles25 pts