Candles print one by one while the camera rides the newest through a breakout.

$npx kinetograph add candlestick-chart
Source

Props

Every prop has a default, so the component renders as it is. Change any of them in Studio or in code.

  • data

    list

    The candles, oldest first. Open, high, low, close.

  • startDate

    string = "2026-02-02"

    Date of the first candle, YYYY-MM-DD. Candles fall on weekdays.

  • title

    string = "ACME"

    Heading.

  • subtitle

    string = "Daily price, last 44 sessions"

    Muted line under the heading.

  • mode

    light | dark = "light"

    Colour theme: light or dark.

  • palette

    primary | monochrome | ocean | sunset | grove | vivid = "primary"

    Chart palette: primary (indigo, yellow, fuchsia, mist, black), monochrome, ocean, sunset, grove or vivid.

  • format.prefix

    string

    Before the number, e.g. "$".

  • format.suffix

    string

    After the number, e.g. "%" or "k".

  • format.decimals

    integer

    Digits after the decimal point.

  • format.group

    string

    Thousands separator, a comma by default. Empty for none.

  • printSeconds

    number = 4

    How long the candles take to print.

  • holdSeconds

    number = 1.6

    How long the last frame holds.

  • camera.tightZoom

    number = 2.6

    Zoom while riding the newest candle.

  • camera.wideZoom

    number = 1

    Zoom of the whole chart.

  • camera.lead

    number = 300

    Screen pixels the camera leads the newest candle by.

  • camera.motionBlur

    number = 1

    Strength of the motion blur on the fast moves; 0 turns it off.

  • camera.rackFocus

    number = 4

    Blur in pixels on the grid and labels while the shot is tight.

  • camera.drift

    number = 3

    Handheld drift in pixels on the holds.

Compositions

  • CandlestickChart