Candlestick — OHLC Time Series
Signature
sp.candlestick(title, labels, open, high, low, close, *, variant="basic", palette=None, **kwargs) -> Chart
Description
sp.candlestick() is the unified entry point for the entire candlestick-chart family. A candlestick chart shows OHLC (Open, High, Low, Close) bars over time and is the de facto standard for financial markets, crypto, commodities, energy spot prices and any time-series with intra-period spread. The variant keyword switches the visual style without touching the data — including derived views like Heikin-Ashi smoothing, close-only line, mountain area and high-low range bars.
Color convention — by default green = up (
close >= open) and red = down. Override withpalette=[up_color, down_color]. Bars are rendered left-to-right in input order; usesort_order="asc"to sort by close price.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
title | str | required | Chart title |
labels | list[str] | required | Period labels (e.g. dates) |
open | list[float] | required | Opening price per period |
high | list[float] | required | Highest price per period |
low | list[float] | required | Lowest price per period |
close | list[float] | required | Closing price per period |
variant | str | "basic" | Visual style (see table) |
palette | list[int] | None | [up_color, down_color] (defaults: green/red) |
gridlines | bool | False | Horizontal price gridlines |
x_label | str | "" | X-axis label |
y_label | str | "" | Y-axis label |
sort_order | str | "none" | "none", "asc", "desc" (by close) |
width | int | 1100 | Canvas width (px) |
height | int | 500 | Canvas height (px) |
Returns
Chart — object with .html property and .show() method.
Signature
sp.candlestick(title, labels, open, high, low, close, *, variant="basic", palette=None, **kwargs) -> Chart
Description
sp.candlestick() est le point d entree unifie pour toute la famille des chandeliers. Un graphique en chandeliers affiche des barres OHLC (Ouverture, Haut, Bas, Cloture) dans le temps et constitue le standard de fait pour les marches financiers, la crypto, les matieres premieres, le spot energie et toute serie temporelle avec spread intra-periode. Le mot-cle variant change le style sans toucher aux donnees — y compris des vues derivees comme le lissage Heikin-Ashi, la ligne de cloture, l aire mountain et les barres haut-bas.
Convention de couleur — par defaut vert = hausse (
close >= open) et rouge = baisse. Surchargez avecpalette=[couleur_hausse, couleur_baisse]. Les barres sont rendues de gauche a droite dans l ordre d entree ;sort_order="asc"pour trier par prix de cloture.
Parametres
| Parametre | Type | Defaut | Description |
|---|---|---|---|
title | str | requis | Titre du graphique |
labels | list[str] | requis | Libelles de periode (ex. dates) |
open | list[float] | requis | Prix d ouverture par periode |
high | list[float] | requis | Prix le plus haut par periode |
low | list[float] | requis | Prix le plus bas par periode |
close | list[float] | requis | Prix de cloture par periode |
variant | str | "basic" | Style visuel (voir tableau) |
palette | list[int] | None | [hausse, baisse] (defaut : vert/rouge) |
gridlines | bool | False | Lignes de grille horizontales |
x_label | str | "" | Libelle axe X |
y_label | str | "" | Libelle axe Y |
sort_order | str | "none" | "none", "asc", "desc" (par cloture) |
width | int | 1100 | Largeur du canvas (px) |
height | int | 500 | Hauteur du canvas (px) |
Retour
Chart — objet avec une propriete .html et une methode .show().