Styles¶

Wickly ships with six built-in styles and a make_style() helper for creating custom palettes — mirroring the mplfinance styling API.

Built-in styles¶

Use any of the following names with the style parameter of wickly.plot():

Style	Up colour	Down colour	Background	Notes
`"default"`	🟢 `#26a69a`	🔴 `#ef5350`	`#ffffff`	Teal / red on white
`"charles"`	🟢 `#006340`	🔴 `#a02128`	`#ffffff`	Classic green / maroon
`"mike"`	`#000000`	🔵 `#0080ff`	⚫ `#0a0a23`	Dark-mode blue theme
`"yahoo"`	🟢 `#00c853`	🔴 `#ff1744`	`#ffffff`	Yahoo Finance colours
`"classic"`	`#ffffff`	`#000000`	`#ffffff`	Black-and-white
`"nightclouds"`	🟢 `#00e676`	🔴 `#ff5252`	⚫ `#1e1e2f`	Dark-mode green / red

Listing all available styles¶

import wickly
print(wickly.available_styles())
# ['default', 'charles', 'mike', 'yahoo', 'classic', 'nightclouds']

Using a style¶

Pass the style name as a string:

wickly.plot(df, type="candle", style="nightclouds")

Creating a custom style¶

Use wickly.make_style() to derive a new style from any built-in base:

my_style = wickly.make_style(
    base_mpf_style="nightclouds",
    up_color="#00ff00",
    down_color="#ff0000",
    bg_color="#111111",
    grid_color="#222222",
    mavcolors=["cyan", "magenta", "yellow"],
)

wickly.plot(df, style=my_style)

Style dictionary keys¶

Every style is a plain dict with the following keys:

Key	Description
`up_color`	Candle body fill when close ≥ open
`down_color`	Candle body fill when close < open
`edge_up`	Candle border colour (up)
`edge_down`	Candle border colour (down)
`wick_up`	Wick colour (up)
`wick_down`	Wick colour (down)
`volume_up`	Volume bar colour (up)
`volume_down`	Volume bar colour (down)
`bg_color`	Chart background colour
`grid_color`	Grid line colour
`text_color`	Axis label / title colour
`alpha`	Overall opacity (0.0 – 1.0)
`mavcolors`	List of colours for moving-average lines

You can also pass a raw dict directly to the style parameter of plot() — missing keys are filled from the "default" style.