Ohlc

barStyle

The tick style: ohlc, hlc, or hilo.

data

A price array with time, open, high, low, and close.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

• CandlestickData

  Type definition

width

Chart width in pixels. If the container width changes, update width from a ResizeObserver.

height

Chart height in pixels. Allow space for axes, titles, and the legend.

brandLogo

The default is the Syidax symbol and wordmark. With the Pro chart.branding entitlement, set none to remove it or provide a PNG, JPEG, or WebP data URL to replace it.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

brandPosition

The corner where the logo is anchored. Community and Pro both support all four corners, using the same position on screen and in image exports.

xAxis

Configure the horizontal axis type, categories, range, and formatting. For a category axis, match the categories order to the value array indices. Charts supporting multiple axes can accept an axis array.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

• CartesianAxisInput

  Type definition

yAxis

Configure the vertical axis range, ticks, labels, and direction. Use consistent units for comparisons, and consider a zero baseline when comparing bar lengths.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

• YAxisInput

  Type definition

gridLines

Allowed values: auto, off. Default: undefined.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

• CartesianGridLinesInput

  Type definition

crosshair

Crosshair that follows the cursor across the plot (forwarded; the inner crosshairMove bubbles through the host).

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

• CartesianCrosshairInput

  Type definition

zoom

Zoom (Storybook parity 2026-09-10) — the candlestick's shared cartesian zoom, forwarded; the inner zoomChange bubbles through the host.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

• CartesianZoomInput

  Type definition

xMin

Set as an HTML attribute or JavaScript property. type: number.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

xMax

Set as an HTML attribute or JavaScript property. type: number.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

yMin

Set as an HTML attribute or JavaScript property. type: number.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

yMax

Set as an HTML attribute or JavaScript property. type: number.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

padding

Set as an HTML attribute or JavaScript property. type: number.

upColor

Set as an HTML attribute or JavaScript property. type: string.

downColor

Set as an HTML attribute or JavaScript property. type: string.

flatColor

Set as an HTML attribute or JavaScript property. type: string.

candleWidth

The tick length's share of the bar pitch (the candle body ratio; 0.7 by default).

candleMinPx

Set as an HTML attribute or JavaScript property. type: number.

candleMaxPx

Set as an HTML attribute or JavaScript property. type: number.

wickWidth

The spine and tick thickness in CSS px.

tickLength

(carry-over D5) — the open / close tick length in CSS px (default: the body half-width).

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

fillAlpha

(carry-over D5) — the band fill alpha 0 … 1 (default 0.12).

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

bodyMinPx

Set as an HTML attribute or JavaScript property. type: number.

bodyStyle

Candle-only lanes, forwarded for parity (an OHLC bar has no body to hollow).

• CandlestickBodyStyle

  Type definition

bodyBorderPx

Set as an HTML attribute or JavaScript property. type: number.

wickColor

Set as an HTML attribute or JavaScript property. type: string.

antialias

Allowed values: auto, off, on. Default: 'auto'.

• CandlestickAntialias

  Type definition

pixelSnap

Set as an HTML attribute or JavaScript property. type: boolean.

timeScale

Allowed values: linear, ordinal. Default: 'ordinal'.

• CandlestickTimeScale

  Type definition

session

Pass as a JavaScript property. type: CandlestickSessionInput | string.

• CandlestickSessionInput

  Type definition

labelLocale

Set as an HTML attribute or JavaScript property. type: string.

volume

Allowed values: off, pane. Default: 'off'.

• CandlestickVolumeMode

  Type definition

volumeHeight

Set as an HTML attribute or JavaScript property. type: number.

volumeUpColor

Set as an HTML attribute or JavaScript property. type: string.

volumeDownColor

Set as an HTML attribute or JavaScript property. type: string.

volumeAlpha

Set as an HTML attribute or JavaScript property. type: number.

overlays

Pass as a JavaScript property. type: CandlestickOverlayInput | string.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

• CandlestickOverlayInput

  Type definition

chartTitle

The title inside the chart. Explain the data's unit and meaning alongside it.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

chartSubtitle

The subtitle inside the chart.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

enableMouseTracking

Set as an HTML attribute or JavaScript property. type: boolean.

tooltip

Tooltip settings for pointer-driven values, position, and content.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

• CartesianTooltipInput

  Type definition

tooltipEnabled

Set as an HTML attribute or JavaScript property. type: boolean.

tooltipFormat

Pass as a JavaScript property. type: (detail: CandlestickPointEventDetail) => string.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

• CandlestickPointEventDetail

  Type definition

animated

Whether to animate initial display and data changes.

animationDuration

Animation duration in milliseconds.

animationEasing

Allowed values: linear, ease-out, ease-in, ease-in-out. Default: 'ease-out'.

• CandlestickEasing

  Type definition

animationType

Allowed values: initial, update. Default: undefined.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

• CandlestickAnimationType

  Type definition

streamSource

A stream source for live data. Check the contract for the specific type.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

• CandlestickStreamSource

  Type definition

streamMax

The maximum number of streaming data points to retain.

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

streamWindow

The newest N streamed bars the chart renders (the whole buffer when unset).

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

engine

Renderer selection: auto, standard, or pro. Engine selection is separate from permission to use a Pro chart type.

• CandlestickEngineMode

  Type definition

unavailable

Allowed values: fallback, error. Default: 'fallback'.

• CandlestickUnavailableBehaviour

  Type definition

getDataTable

Current normalized table, including the retained stream; independent of GPU availability.

getDataTable(): Promise<ChartDataTable>

Return type: Promise<ChartDataTable>. Call the method after element registration and await its Promise result.

• ChartDataTable

  Type definition

redraw

Redraw the chart using its current data and options. Inspect the rendered result after the returned Promise resolves.

redraw(): Promise<CandlestickRenderResult>

Return type: Promise<CandlestickRenderResult>. Call the method after element registration and await its Promise result.

• CandlestickRenderResult

  Type definition

getActiveTier

An asynchronous method. Check the argument and return types below.

getActiveTier(): Promise<CandlestickEngineTier>

Return type: Promise<CandlestickEngineTier>. Call the method after element registration and await its Promise result.

• CandlestickEngineTier

  Type definition

getUnavailableReason

Why the WebGPU renderer could not run (the fallback notice's reason); undefined when nothing fell back.

getUnavailableReason(): Promise<string | undefined>

Return type: Promise<string | undefined>. Call the method after element registration and await its Promise result.

setData

Replace the bar set.

setData(data: CandlestickData): Promise<void>

Return type: Promise<void>. Call the method after element registration and await its Promise result.

• CandlestickData

  Type definition

appendPoint

Append one value to the stream. Check the argument type and the licensing requirements for streaming.

appendPoint(bar: CandlestickBarInput): Promise<void>

Return type: Promise<void>. Call the method after element registration and await its Promise result.

• CandlestickBarInput

  Type definition

appendBatch

Append multiple values to the stream. Check the argument type and the licensing requirements for streaming.

appendBatch(bars: ReadonlyArray<CandlestickBarInput>): Promise<void>

Return type: Promise<void>. Call the method after element registration and await its Promise result.

• CandlestickBarInput

  Type definition

shift

Drop the oldest streamed categories (the data boxes are not the stream).

shift(count: number): Promise<void>

Return type: Promise<void>. Call the method after element registration and await its Promise result.

replace

Swap the streamed set (replace([]) clears it); the base values never leave. Without chart.streaming the dies upsert into the base like a batch (quietly: no appended, no binChanged, as a ring replace).

replace(bars: ReadonlyArray<CandlestickBarInput>): Promise<void>

Return type: Promise<void>. Call the method after element registration and await its Promise result.

• CandlestickBarInput

  Type definition

getStreamSource

The stream session's source (Chart Pro): like the stream methods it waits for a license still being confirmed.

getStreamSource(): Promise<CandlestickStreamSource | undefined>

Return type: Promise<CandlestickStreamSource | undefined>. Call the method after element registration and await its Promise result.

• CandlestickStreamSource

  Type definition

setAnimation

An asynchronous method. Check the argument and return types below.

setAnimation(options: { duration?: number; easing?: CandlestickEasing; enabled?: boolean; type?: CandlestickAnimationType }): Promise<void>

Return type: Promise<void>. Call the method after element registration and await its Promise result.

• CandlestickEasing

  Type definition

• CandlestickAnimationType

  Type definition

pauseAnimation

Pause the current animation.

pauseAnimation(): Promise<void>

Return type: Promise<void>. Call the method after element registration and await its Promise result.

resumeAnimation

Resume a paused animation.

resumeAnimation(): Promise<void>

Return type: Promise<void>. Call the method after element registration and await its Promise result.

replayAnimation

Replay the initial sweep from min → value(s). No-op when animation is off / reduced.

replayAnimation(): Promise<void>

Return type: Promise<void>. Call the method after element registration and await its Promise result.

hitTest

The box under a host-local CSS point (the nearest slot, within half a pitch), or null.

hitTest(cssX: number, cssY: number): Promise<CandlestickPointEventDetail | null>

Return type: Promise<CandlestickPointEventDetail | null>. Call the method after element registration and await its Promise result.

• CandlestickPointEventDetail

  Type definition

getBar

The normalised bar at an index (null outside).

getBar(index: number): Promise<CandlestickBar | null>

Return type: Promise<CandlestickBar | null>. Call the method after element registration and await its Promise result.

• CandlestickBar

  Type definition

getBarAt

The bar nearest to a time (null for an empty series).

getBarAt(time: number): Promise<(CandlestickBar & { index: number }) | null>

Return type: Promise<(CandlestickBar & { index: number }) | null>. Call the method after element registration and await its Promise result.

• CandlestickBar

  Type definition

getBarCount

An asynchronous method. Check the argument and return types below.

getBarCount(): Promise<number>

Return type: Promise<number>. Call the method after element registration and await its Promise result.

getExtent

An asynchronous method. Check the argument and return types below.

getExtent(): Promise<CandlestickExtent>

Return type: Promise<CandlestickExtent>. Call the method after element registration and await its Promise result.

• CandlestickExtent

  Type definition

getDomain

The data domain the grid spans.

getDomain(): Promise<CandlestickDomain>

Return type: Promise<CandlestickDomain>. Call the method after element registration and await its Promise result.

• CandlestickDomain

  Type definition

getVisibleRange

The bars the plot shows: the x-axis window, narrowed by the zoom when one is in place.

getVisibleRange(): Promise<CandlestickVisibleRange>

Return type: Promise<CandlestickVisibleRange>. Call the method after element registration and await its Promise result.

• CandlestickVisibleRange

  Type definition

showTooltipAtIndex

open the tooltip on a box (the facade's showTooltipAtPoint routes here); null off the boxes or with the tooltip off.

showTooltipAtIndex(index: number): Promise<CartesianTooltipEventDetail | null>

Return type: Promise<CartesianTooltipEventDetail | null>. Call the method after element registration and await its Promise result.

• CartesianTooltipEventDetail

  Type definition

hideTooltip

Close the currently visible tooltip.

hideTooltip(): Promise<void>

Return type: Promise<void>. Call the method after element registration and await its Promise result.

focusBarAt

move the keyboard focus ring to a bar (null outside the visible window); emits pointHover like the walk.

focusBarAt(index: number): Promise<CandlestickPointEventDetail | null>

Return type: Promise<CandlestickPointEventDetail | null>. Call the method after element registration and await its Promise result.

• CandlestickPointEventDetail

  Type definition

getOverlays

the overlays: each settled spec with where its PRIMARY line exists and what is visible (the outputs and the band ride on the spec).

getOverlays(): Promise<CandlestickOverlayState[]>

Return type: Promise<CandlestickOverlayState[]>. Call the method after element registration and await its Promise result.

• CandlestickOverlayState

  Type definition

getOverlayValues

the overlay values at a bar index: the primary output under the overlay id, the others under id.key (null through a warm-up).

getOverlayValues(index: number): Promise<Record<string, number | null>>

Return type: Promise<Record<string, number | null>>. Call the method after element registration and await its Promise result.

getPanes

the panes: the price pane, the volume pane when it exists, the separator, and why there is none.

getPanes(): Promise<CandlestickPaneRects>

Return type: Promise<CandlestickPaneRects>. Call the method after element registration and await its Promise result.

• CandlestickPaneRects

  Type definition

getTimeScale

the time scale of the visible range: the kind, the slots, the spacing and the ordinal ticks.

getTimeScale(): Promise<CandlestickTimeScaleState>

Return type: Promise<CandlestickTimeScaleState>. Call the method after element registration and await its Promise result.

• CandlestickTimeScaleState

  Type definition

zoomTo

zoom to explicit windows: x / y as { min, max } or [min, max] (null clears that orientation); xAxis / yAxis name the axis by id or slot index (default: the primary axis).

zoomTo(request: CartesianZoomRequest): Promise<CartesianZoomChangeEventDetail | null>

Return type: Promise<CartesianZoomChangeEventDetail | null>. Call the method after element registration and await its Promise result.

• CartesianZoomChangeEventDetail

  Type definition

• CartesianZoomRequest

  Type definition

zoomBy

scale the current windows by factor (< 1 zooms in) around anchorFraction (0..1, default centre).

zoomBy(factor: number, anchorFraction?: number): Promise<CartesianZoomChangeEventDetail | null>

Return type: Promise<CartesianZoomChangeEventDetail | null>. Call the method after element registration and await its Promise result.

• CartesianZoomChangeEventDetail

  Type definition

panBy

slide the zoomed windows by data units ({ x?, y? }); a no-op at the full extent.

panBy(delta: { x?: number; y?: number }): Promise<CartesianZoomChangeEventDetail | null>

Return type: Promise<CartesianZoomChangeEventDetail | null>. Call the method after element registration and await its Promise result.

• CartesianZoomChangeEventDetail

  Type definition

resetZoom

Reset the zoomed or panned range to the original data range.

resetZoom(): Promise<CartesianZoomChangeEventDetail | null>

Return type: Promise<CartesianZoomChangeEventDetail | null>. Call the method after element registration and await its Promise result.

• CartesianZoomChangeEventDetail

  Type definition

getZoom

Read the current zoom range. Check the return type's nullability and the range for each axis.

getZoom(): Promise<CartesianZoomState | null>

Return type: Promise<CartesianZoomState | null>. Call the method after element registration and await its Promise result.

• CartesianZoomState

  Type definition

getZoomExtent

the full extent (and key) of the primary — or the named — master axes (null before the first layout).

getZoomExtent(request?: CartesianZoomExtentRequest): Promise<CartesianZoomExtentDetail | null>

Return type: Promise<CartesianZoomExtentDetail | null>. Call the method after element registration and await its Promise result.

• CartesianZoomExtentDetail

  Type definition

• CartesianZoomExtentRequest

  Type definition

getEngineStatus

Requested engine vs what runs, and why (CHART-ADD-08): the inner candlestick's own status once it is mounted (it gates chart.type.ohlc and chart.type.candlestick); before that, this proxy's chart.type.ohlc decision, read without side effects.

getEngineStatus(): Promise<ChartEngineStatus>

Return type: Promise<ChartEngineStatus>. Call the method after element registration and await its Promise result.

• ChartEngineStatus

  Type definition