Skip to main content

Multi Chart

Type: multi_chart • Category: visualization

Description

Compose multiple layers (candle/line/renko) on a shared time axis

Parameters

NameTypeDescriptionRequiredDefault
widgetIdhiddenno
limitnumberno500
layersExprstringExpr -> list of layer configsno
layersarrayList of layer configs (each: type, rowsExpr/rows, mapping, style)no
appendbooleanAppend this single layer to existing widget layers (instead of replacing).nofalse
layerTypestringType of layer to addno
layerNamestringno
layerLimitnumberno500
layerRowsExprstringExpr -> list[dict] for the single layerno
openstringno
highstringno
lowstringno
closestringno
volumestringno
timestampstringno
valuestringLine/Renko value fieldno
boxSizenumberRenko box size (optional, auto if empty)no
colorstringLine colorno
widthnumberLine widthno1.5
opacitynumberLayer opacityno1
upColorstringCandle/Renko up colorno
downColorstringCandle/Renko down colorno
strokestringWick/Brick stroke colorno

Help

Multi Chart Worker - Multi-Layer Financial Visualization

Compose complex financial charts with multiple data layers on a shared time axis. Supports 19 different chart types for comprehensive technical analysis and data visualization.

Supported Layer Types:

Core Financial Charts:

  • Candle: OHLC candlestick charts with volume support
  • Line: Simple time series lines for trends and indicators
  • Renko: Brick-based charts showing price movements (time-deemphasized)
  • Bar: OHLC bars with open/close ticks and high/low wicks
  • Heikin Ashi: Smoothed candles averaging OHLC values

Advanced Technical Indicators:

  • Bollinger: Moving average with upper/lower standard deviation bands
  • Ichimoku: Complete Ichimoku cloud system (Tenkan, Kijun, Spans, Chikou)
  • Kagi: Trend-following lines with thickness changes on reversals
  • Point & Figure: X/O boxes with reversal rules (ignores time)

Specialized Charts:

  • Tick: Per-tick price series for micro-movements
  • Range Bar: Bars printed when price moves fixed range (variable time)
  • Equivolume: Candles with width encoding trading volume
  • Footprint: Order flow with bid/ask volumes per price level
  • Volume: Volume bars/areas (typically as bottom band)

Data Visualization:

  • Area: Line charts with filled areas under curves
  • Mountain: Gradient-filled area charts for stronger emphasis
  • Bubble: Scatter plots with size encoding values
  • Heatmap: Time * category intensity visualization
  • Horizontal Levels: Support/resistance lines at specified levels

Configuration Methods:

  • Bulk layers: layersExpr returns list of complete layer configurations
  • Single layer append: Add individual layers with layerType, layerRowsExpr, etc.
  • append: When true, adds to existing widget layers instead of replacing

Required Fields by Layer Type:

OHLC-based (Candle, Bar, Heikin Ashi, Equivolume, Footprint):

  • timestamp, open, high, low, close (volume optional)

Line-based (Line, Area, Mountain, Tick, Range Bar, Kagi, Point & Figure):

  • timestamp, value

Specialized:

  • Bollinger: timestamp, value (period, stdMult parameters)
  • Ichimoku: timestamp, open, high, low, close (tenkan, kijun, spanB periods)
  • Bubble: timestamp, value, size (colorValue optional)
  • Heatmap: timestamp, y (category), value
  • Footprint: timestamp, open, high, low, close, volume (optional buy/sell volumes, levels)
  • Volume: timestamp, volume

Styling Options:

  • Colors: color, upColor, downColor, stroke for visual customization
  • Width: Line thickness and opacity control
  • Layer opacity: Transparency settings for overlay effects
  • Theme: Classic Dark, Light, Blue Night, Monochrome
  • Compress gaps: Auto, Always, Never for handling missing data

Features:

  • Shared time axis: All layers aligned by timestamp for perfect synchronization
  • Interactive: Zoom, pan, crosshair, tooltips across all layers
  • Flexible data sources: Mix different data expressions per layer
  • Performance optimized: Efficient rendering of complex multi-layer charts
  • Auto-detection: Field mapping from data structure
  • Append mode: Add layers incrementally without replacing existing ones

Data Format Examples:

Candle Layer:

{
"timestamp": 1640995200000,
"open": 100.50,
"high": 105.25,
"low": 99.75,
"close": 104.80,
"volume": 1000000
}

Line Layer:

{
"timestamp": 1640995200000,
"value": 102.30
}

Bollinger Bands Layer:

{
"timestamp": 1640995200000,
"value": 102.30
}
// With parameters: period=20, stdMult=2

Ichimoku Layer:

{
"timestamp": 1640995200000,
"open": 100.50,
"high": 105.25,
"low": 99.75,
"close": 104.80
}
// With parameters: tenkan=9, kijun=26, spanB=52

Bubble Layer:

{
"timestamp": 1640995200000,
"value": 102.30,
"size": 1000000,
"colorValue": 0.15
}

Heatmap Layer:

{
"timestamp": 1640995200000,
"y": "AAPL",
"value": 0.85
}

Bulk Configuration:

layersExpr = [
{
"type": "candle",
"rowsExpr": "data.price_data",
"mapping": {"timestamp": "ts", "open": "o", "high": "h", "low": "l", "close": "c"},
"style": {"upColor": "green", "downColor": "red"}
},
{
"type": "line",
"rowsExpr": "data.moving_average",
"mapping": {"timestamp": "ts", "value": "ma"},
"style": {"color": "blue", "width": 2}
},
{
"type": "bollinger",
"rowsExpr": "data.prices",
"mapping": {"timestamp": "ts", "value": "close"},
"period": 20,
"stdMult": 2,
"style": {"upperColor": "red", "lowerColor": "green"}
}
]

Examples:

  • Price + Indicators: Overlay moving averages and Bollinger bands on candlestick charts
  • Multi-asset: Compare different stocks or cryptocurrencies on same time axis
  • Technical Analysis: Combine Ichimoku cloud with support/resistance levels
  • Volume Analysis: Add footprint charts with volume profile
  • Complex Strategies: Mix Renko bricks with tick data for detailed analysis
  • Portfolio Heatmap: Time-series heatmap of multiple asset performances

Use Cases:

  • Advanced technical analysis with multiple indicators
  • Multi-asset portfolio visualization and comparison
  • Complex trading strategies requiring multiple data overlays
  • Comparative market analysis across different timeframes
  • Professional chart pattern recognition and analysis
  • Risk management with multiple confirmation signals
  • Algorithmic trading strategy visualization

Performance Notes:

  • Supports up to 19 different layer types in single chart
  • Efficient rendering with configurable data limits per layer
  • Automatic data synchronization across all layers
  • Optimized for real-time data updates and large datasets