# lightweight-charts-indicators

**Repository Path**: lmia/lightweight-charts-indicators

## Basic Information

- **Project Name**: lightweight-charts-indicators
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-03
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# lightweight-charts-indicators

**[Live Demo](https://deepentropy.github.io/lightweight-charts-indicators/)**

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

```bash
npm install lightweight-charts-indicators oakscriptjs lightweight-charts
```

## Quick Start

```typescript
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:

```typescript
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](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:

```typescript
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`:

```typescript
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

```bash
npm run build
```

## Testing

```bash
npm test
```

## License

MIT