Skip to content

deepentropy/lightweight-charts-indicators

Repository files navigation

lightweight-charts-indicators

Live Demo

446 technical analysis indicators for TradingView's lightweight-charts library — 82 standard indicators, 317 community indicators, and 44 candlestick patterns. PineScript v6 compatible with full drawing primitive support (lines, boxes, labels, tables).

Installation

npm install lightweight-charts-indicators oakscriptjs lightweight-charts

Quick Start

import { SMA, RSI, MACD, BollingerBands } from 'lightweight-charts-indicators';
import type { Bar } from 'oakscriptjs';

const bars: Bar[] = [
  { time: 1, open: 100, high: 105, low: 95, close: 102, volume: 1000 },
  // ... more bars
];

// Simple Moving Average
const smaResult = SMA.calculate(bars, { len: 14 });

// RSI
const rsiResult = RSI.calculate(bars, { length: 14 });

// MACD
const macdResult = MACD.calculate(bars, { fastLength: 12, slowLength: 26, signalLength: 9 });

// Bollinger Bands
const bbResult = BollingerBands.calculate(bars, { length: 20, mult: 2 });

Lightweight-Charts Integration Example

Here's a complete example showing how to integrate indicators with TradingView's lightweight-charts:

import { createChart, ColorType, LineSeries, CandlestickSeries } from 'lightweight-charts';
import { SMA, RSI, BollingerBands } from 'lightweight-charts-indicators';
import type { Bar } from 'oakscriptjs';

// Sample OHLCV data
const bars: Bar[] = [
  { time: 1609459200, open: 100, high: 105, low: 98, close: 103, volume: 1000 },
  { time: 1609545600, open: 103, high: 108, low: 101, close: 107, volume: 1200 },
  { time: 1609632000, open: 107, high: 110, low: 104, close: 105, volume: 900 },
  // ... more bars
];

// Create the main chart
const chartContainer = document.getElementById('chart')!;
const chart = createChart(chartContainer, {
  layout: {
    background: { type: ColorType.Solid, color: '#1e1e1e' },
    textColor: '#d1d4dc',
  },
  width: 800,
  height: 400,
});

// Add candlestick series
const candlestickSeries = chart.addSeries(CandlestickSeries);
candlestickSeries.setData(bars.map(bar => ({
  time: bar.time as number,
  open: bar.open,
  high: bar.high,
  low: bar.low,
  close: bar.close,
})));

// Calculate and add SMA overlay
const smaResult = SMA.calculate(bars, { len: 20, src: 'close' });
const smaSeries = chart.addSeries(LineSeries, { color: '#2962FF', lineWidth: 2 });
smaSeries.setData(smaResult.plots.plot0);

// Calculate and add Bollinger Bands
const bbResult = BollingerBands.calculate(bars, { length: 20, mult: 2 });
const bbUpperSeries = chart.addSeries(LineSeries, { color: '#787B86', lineWidth: 1 });
const bbMiddleSeries = chart.addSeries(LineSeries, { color: '#FF6D00', lineWidth: 1 });
const bbLowerSeries = chart.addSeries(LineSeries, { color: '#787B86', lineWidth: 1 });
bbUpperSeries.setData(bbResult.plots.plot0);  // Upper band
bbMiddleSeries.setData(bbResult.plots.plot1); // Basis (middle)
bbLowerSeries.setData(bbResult.plots.plot2);  // Lower band

// Create a separate pane for RSI (oscillator)
const rsiContainer = document.getElementById('rsi-chart')!;
const rsiChart = createChart(rsiContainer, {
  layout: {
    background: { type: ColorType.Solid, color: '#1e1e1e' },
    textColor: '#d1d4dc',
  },
  width: 800,
  height: 150,
});

const rsiResult = RSI.calculate(bars, { length: 14, src: 'close' });
const rsiSeries = rsiChart.addSeries(LineSeries, { color: '#7E57C2', lineWidth: 2 });
rsiSeries.setData(rsiResult.plots.plot0);

// Sync the time scales
chart.timeScale().subscribeVisibleLogicalRangeChange(range => {
  if (range) rsiChart.timeScale().setVisibleLogicalRange(range);
});

Available Indicators (446)

Moving Averages

Indicator Export Description
Simple Moving Average SMA Arithmetic mean over a specified period
Exponential Moving Average EMA Weighted average giving more weight to recent prices
Weighted Moving Average WMA Linearly increasing weights
Smoothed Moving Average (RMA) RMA Wilder smoothing (alpha = 1/length)
Double EMA DEMA Reduces lag by applying EMA twice
Triple EMA TEMA Further reduces lag with triple exponential smoothing
Hull Moving Average HMA Reduces lag while maintaining smoothness
Least Squares Moving Average LSMA Uses linear regression to fit a line
Arnaud Legoux Moving Average ALMA Gaussian distribution to reduce lag
Volume Weighted Moving Average VWMA Moving average weighted by volume
Smoothed Moving Average SMMA Wilder smoothing moving average
McGinley Dynamic McGinleyDynamic Adaptive moving average that adjusts to market speed
MA Cross MACross Two moving averages for crossover signals
Moving Average Ribbon MARibbon Multiple MAs showing trend direction and momentum
Zero Lag LSMA ZLSMA Double linreg to cancel LSMA lag

Oscillators

Indicator Export Description
Relative Strength Index RSI Momentum oscillator (0-100) measuring price changes
Stochastic Stochastic Compares closing price to price range
Stochastic RSI StochRSI Stochastic applied to RSI values
Commodity Channel Index CCI Measures variation from statistical mean
Williams %R WilliamsPercentRange Momentum showing overbought/oversold levels
Awesome Oscillator AwesomeOscillator Market momentum using SMA difference
Chande Momentum Oscillator ChandeMO Momentum on a scale of -100 to +100
Detrended Price Oscillator DPO Removes trend to identify cycles
Relative Vigor Index RVI Measures conviction of price action
SMI Ergodic Indicator SMIErgodic TSI-based momentum with signal line
SMI Ergodic Oscillator SMIErgodicOscillator SMI minus signal as histogram
True Strength Index TSI Double-smoothed momentum oscillator
Woodies CCI WoodiesCCI CCI with turbo for faster signals
Bollinger Bands %B BBPercentB Price position relative to BB (0=lower, 1=upper)
Fisher Transform FisherTransform Gaussian distribution for clearer turning points
Ultimate Oscillator UltimateOscillator Multi-timeframe weighted momentum
Rank Correlation Index RCI Correlation between price rank and time rank
RCI Ribbon RCIRibbon Multiple RCI lines for trend visualization
Relative Volatility Index RelativeVolatilityIndex Volatility-based oscillator
Chop Zone ChopZone Colored zone indicator for market choppiness
CCT Bollinger Band Oscillator CCTBBO Normalized BB position (0-100) with signal line
KDJ KDJ Extended Stochastic with J line (3K - 2D)
WaveTrend WaveTrend Channel index oscillator with cross signals
Forecast Oscillator ForecastOscillator Percentage deviation from linear regression
Schaff Trend Cycle SchaffTrendCycle Double stochastic smoothing of MACD

Momentum

Indicator Export Description
MACD MACD Relationship between two EMAs
Momentum Momentum Rate of change of price
Rate of Change ROC Percentage change over a period
Balance of Power BOP Strength of buyers vs sellers
Bull Bear Power BullBearPower Buying/selling pressure relative to EMA
Elder Force Index ElderForceIndex Combines price and volume
Price Oscillator (PPO) PriceOscillator MACD as percentage for comparison
Coppock Curve CoppockCurve Long-term momentum using ROC and WMA
TRIX TRIX Triple EMA rate of change, filters noise
Connors RSI ConnorsRSI Composite of RSI, streak, and percentile rank
KST KST Know Sure Thing - weighted ROC sum
MACD 4C MACD4C MACD histogram with 4-color coding
Squeeze Momentum SqueezeMomentum BB/KC squeeze with momentum oscillator
Impulse MACD ImpulseMACD ZLEMA vs SMMA channel impulse

Trend

Indicator Export Description
Average Directional Index ADX Measures trend strength regardless of direction
Directional Movement Index DMI +DI, -DI, and ADX for trend direction/strength
Ichimoku Cloud IchimokuCloud Comprehensive trend system with support/resistance
Parabolic SAR ParabolicSAR Trend-following with entry/exit points
Supertrend Supertrend ATR-based dynamic support/resistance
Aroon Aroon Trend strength by time since high/low
BBTrend BBTrend Measures trend using Bollinger Bands
Choppiness Index Choppiness Market choppiness vs trending
Mass Index MassIndex Identifies reversals via high-low range
Vortex Indicator VortexIndicator Identifies trend start and direction
Williams Alligator WilliamsAlligator Three smoothed MAs for trend detection
Zig Zag ZigZag Connects pivot highs and lows
Trend Strength Index TrendStrengthIndex Trend strength based on directional movement
Chande Kroll Stop ChandeKrollStop ATR-based trailing stop system
Williams Fractals WilliamsFractals Identifies reversal points in price
Moon Phases MoonPhases New and full moon markers
TWAP TWAP Time-weighted average price
Coral Trend CoralTrend Cascaded EMA filter for smooth trend detection
Chandelier Exit ChandelierExit ATR-based trailing stop system
Donchian Trend Ribbon DonchianTrendRibbon Multi-layer Donchian breakout composite score

Volatility

Indicator Export Description
Average True Range ATR Average range between high and low
Average Day Range ADR Average daily price range
Standard Deviation StandardDeviation Measures price volatility
Historical Volatility HistoricalVolatility Annualized standard deviation of log returns
Bollinger BandWidth BBBandWidth Width of Bollinger Bands as percentage
Bollinger Bars BollingerBars Colored candles based on BB position

Channels & Bands

Indicator Export Description
Bollinger Bands BollingerBands Volatility bands using standard deviation
Keltner Channels KeltnerChannels Volatility envelope using EMA and ATR
Donchian Channels DonchianChannels Highest high and lowest low over period
Envelope Envelope Moving average with fixed percentage bands
Median Median Median price with ATR bands

Volume

Indicator Export Description
On Balance Volume OBV Cumulative volume based on price direction
Money Flow Index MFI Volume-weighted RSI
Price Volume Trend PVT Cumulative volume weighted by price changes
Volume Oscillator VolumeOscillator Percentage difference between volume EMAs
Chaikin Money Flow ChaikinMF Buying/selling pressure using price and volume
Chaikin Oscillator ChaikinOscillator Momentum of Accumulation/Distribution line
Ease of Movement EaseOfMovement Price change relative to volume
Klinger Oscillator KlingerOscillator Volume-based long-term money flow
Net Volume NetVolume Difference between up and down volume
Volume Delta VolumeDelta Difference between buying and selling volume
Cumulative Volume Delta CumulativeVolumeDelta Running total of volume delta
Relative Volume at Time RelativeVolumeAtTime Current volume vs historical average
Colored Volume Bars ColoredVolume Volume colored by price/volume trend
OBV MACD OBVMACD MACD applied to On Balance Volume

Community Indicators (317)

317 community indicators ported from TradingView PineScript sources, covering trend systems, divergence detectors, multi-MA strategies, volume analysis, market structure, and more. Full list in docs/INDICATOR_INVENTORY_COMMUNITY.md.

Categories include: Hyper Trend, AlphaTrend, HalfTrend, QQE MOD, Hull Suite, SuperTrend variants, Market Structure Trailing Stop, Liquidity Levels, Order Blocks, ZigZag Fibonacci, Trendlines with Breaks, and many more.

Drawing primitive support: Lines (LineDrawingData), Boxes (BoxData), Labels (LabelData), Tables (TableData), Markers, Bar Colors, Background Colors, and Plot Candles.

Candlestick Patterns (44)

All 44 patterns from TradingView's standard candlestick pattern library, rendered as chart markers.

Pattern Signal Candles
Abandoned Baby Bullish / Bearish 3
Dark Cloud Cover Bearish 2
Doji Neutral 1
Doji Star Bullish / Bearish 2
Downside Tasuki Gap Bearish 3
Dragonfly Doji Bullish 1
Engulfing Bullish / Bearish 2
Evening Doji Star Bearish 3
Evening Star Bearish 3
Falling Three Methods Bearish 5
Falling Window Bearish 2
Gravestone Doji Bearish 1
Hammer Bullish 1
Hanging Man Bearish 1
Harami Bullish / Bearish 2
Harami Cross Bullish / Bearish 2
Inverted Hammer Bullish 1
Kicking Bullish / Bearish 2
Long Lower Shadow Bullish 1
Long Upper Shadow Bearish 1
Marubozu Black Bearish 1
Marubozu White Bullish 1
Morning Doji Star Bullish 3
Morning Star Bullish 3
On Neck Bearish 2
Piercing Bullish 2
Rising Three Methods Bullish 5
Rising Window Bullish 2
Shooting Star Bearish 1
Spinning Top Black Neutral 1
Spinning Top White Neutral 1
Three Black Crows Bearish 3
Three White Soldiers Bullish 3
Tri-Star Bullish / Bearish 3
Tweezer Bottom Bullish 2
Tweezer Top Bearish 2
Upside Tasuki Gap Bullish 3

Output Format

All indicators return an IndicatorResult object:

interface IndicatorResult {
  metadata: {
    title: string;
    shortTitle: string;
    overlay: boolean;  // true = display on price chart, false = separate pane
  };
  plots: {
    plot0: Array<{ time: number; value: number }>;
    plot1?: Array<{ time: number; value: number }>;
    // ... additional plots as needed
  };
}

Indicator Registry

For dynamic indicator selection (e.g., building a UI), use the indicatorRegistry:

import { indicatorRegistry } from 'lightweight-charts-indicators';

// List all indicators
indicatorRegistry.forEach(indicator => {
  console.log(`${indicator.name} (${indicator.category})`);
});

// Get indicator by ID
const sma = indicatorRegistry.find(i => i.id === 'sma');
const result = sma?.calculate(bars, sma.defaultInputs);

// Filter by category
const oscillators = indicatorRegistry.filter(i => i.category === 'Oscillators');

Building

npm run build

Testing

npm test

License

MIT

About

446 technical analysis indicators for TradingView's lightweight-charts library

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors