Skip to content

bennycode/trading-signals

Repository files navigation

Trading Signals

Language Details Code Coverage License Package Version

Technical indicators and overlays to run technical analysis with JavaScript / TypeScript.

Motivation

The "trading-signals" library provides a TypeScript implementation for common technical indicators with arbitrary-precision decimal arithmetic.

The main focus of this library is on the accuracy of calculations, but using the provided faster implementations you can also use it where performance is important.

All indicators can be updated over time by streaming data (prices or candles) to the update method. Some indicators also provide static batch methods for further performance improvements when providing data up-front during a backtest or historical data import.

Benefits & Features

  • Accurate. Indicators with intervals will return a result only when the period is reached.
  • Convenient. Indicators with intervals will save their all-time highs and lows.
  • Fast. If you need high throughput, you can use the included faster implementations.
  • Flexible. All advanced indicators support different smoothing overlays (WSMA, etc.).
  • Live. It allows for the replacement of values, enabling live charting.
  • Modern. Uses ECMAScript Modules (ESM) syntax.
  • Precise. Better accuracy than calculating with primitive numbers thanks to big.js.
  • Robust. Checked against common division by zero mistakes.
  • Tested. Code coverage is 100%. No surprises when using it.
  • Typed. Source code is 100% TypeScript. No need to install external typings.
  • Verified. All results are verified with other libraries to guarantee correctness.
  • Versatile. Indicators can be updated up-front or by streaming prices.

Technical Indicator Types

  • Trend indicators: Measure the direction of a trend (uptrend, downtrend or sideways trend)
  • Volume indicators: Measure the strength of a trend (based on volume)
  • Volatility indicators: Measure how much disagreement there is in the market based on price (statistical measure of its dispersion)
  • Momentum indicators: Measure the strength of a trend (based on price / speed of price movement)

Supported Technical Indicators

  1. Acceleration Bands (ABANDS)
  2. Accelerator Oscillator (AC)
  3. Average Directional Index (ADX)
  4. Average True Range (ATR)
  5. Awesome Oscillator (AO)
  6. Bollinger Bands (BBANDS)
  7. Bollinger Bands Width (BBW)
  8. Center of Gravity (CG)
  9. Commodity Channel Index (CCI)
  10. Directional Movement Index (DMI / DX)
  11. Double Exponential Moving Average (DEMA)
  12. Dual Moving Average (DMA)
  13. Exponential Moving Average (EMA)
  14. Mean Absolute Deviation (MAD)
  15. Momentum (MOM / MTM)
  16. Moving Average Convergence Divergence (MACD)
  17. On-Balance Volume (OBV)
  18. Rate-of-Change (ROC)
  19. Relative Strength Index (RSI)
  20. Simple Moving Average (SMA)
  21. Stochastic Oscillator (STOCH)
  22. Stochastic RSI (STOCHRSI)
  23. True Range (TR)
  24. Weighted Moving Average (WMA)
  25. Wilder's Smoothed Moving Average (WSMA / WWS / SMMA / MEMA)

Utility Methods:

  1. Average / Mean
  2. Standard Deviation
  3. Rolling Standard Deviation

Usage

import {Big, SMA} from 'trading-signals';

const sma = new SMA(3);

// You can add numbers individually:
sma.update(40);
sma.update(30);
sma.update(20);

// You can add multiple numbers at once:
sma.updates([20, 40, 80]);

// You can add strings:
sma.update('10');

// You can replace a previous value (useful for live charts):
sma.replace('40');

// You can add arbitrary-precision decimals:
sma.update(new Big(30));

// You can get the result in various formats:
console.log(sma.getResult().toFixed(2)); // "40.00"
console.log(sma.getResult().toFixed(4)); // "40.0000"

When to use update(...)?

You have to call an indicator's update method to enter input data. The update method may or may not return a result from the indicator depending on whether the minimum amount of input data has been reached.

When to use getResult()?

You can call getResult() at any point in time, but it throws errors unless an indicator has received the minimum amount of data. If you call getResult(), before an indicator has received the required amount of input values, a NotEnoughDataError will be thrown.

Example:

import {SMA} from 'trading-signals';

// Our interval is 3, so we need 3 input values
const sma = new SMA(3);

// We supply 2 input values
sma.update(10);
sma.update(40);

try {
  // We will get an error, because the minimum amount of inputs is 3
  sma.getResult();
} catch (error) {
  console.log(error.constructor.name); // "NotEnoughDataError"
}

// We will supply the 3rd input value
sma.update(70);

// Now, we will receive a proper result
console.log(sma.getResult().valueOf()); // "40"

Most of the time, the minimum amount of data depends on the interval / time period used.

Performance

Arbitrary-precision decimal arithmetic

JavaScript is very bad with numbers. When calculating 0.1 + 0.2 it shows you 0.30000000000000004, but the truth is 0.3.

JavaScript arithmetic

As specified by the ECMAScript standard, all arithmetic in JavaScript uses double-precision floating-point arithmetic, which is only accurate until certain extent. To increase the accuracy and avoid miscalculations, the trading-signals library uses big.js which offers arbitrary-precision decimal arithmetic. However, this arbitrary accuracy comes with a downside: Calculations with it are not as performant as with the primitive data type number.

Faster implementations

To get the best of both worlds (high accuracy & high performance), you will find two implementations of each indicator (e.g. SMA & FasterSMA). The standard implementation uses big.js and the Faster-prefixed version uses common number types. Use the standard one when you need high accuracy and use the Faster-one when you need high performance:

import {FasterSMA} from './SMA/SMA';

const fasterSMA = new FasterSMA(5);
console.log(fasterSMA.updates([1, 2, 3, 4, 5]));
import {FasterStochasticRSI, FasterSMA} from 'trading-signals';

const fasterStochRSI = new FasterStochasticRSI(3, FasterSMA);
fasterStochRSI.update(1);
fasterStochRSI.update(2);
fasterStochRSI.update(3);
fasterStochRSI.update(4);
fasterStochRSI.update(5);
fasterStochRSI.update(6);

console.log(fasterStochRSI.getResult());

Benchmarks

You can run yarn start:benchmark to see the runtime performance of each technical indicator on your machine. This will give you an understanding of which indicators can be calculated faster than others.

Disclaimer

The information and publications of trading-signals do not constitute financial advice, investment advice, trading advice or any other form of advice. All results from trading-signals are intended for information purposes only.

It is very important to do your own analysis before making any investment based on your own personal circumstances. If you need financial advice or further advice in general, it is recommended that you identify a relevantly qualified individual in your jurisdiction who can advise you accordingly.

Alternatives

Maintainers

Benny Neugebauer on Stack Exchange

⭐️ Become a TypeScript rockstar! ⭐️

This package was built by Benny Code. Checkout my TypeScript course to become a coding rockstar!

License

This project is MIT licensed.