Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/anandanand84/technicalindicators

A javascript technical indicators written in typescript with pattern recognition right in the browser
https://github.com/anandanand84/technicalindicators

candle-stick candlestick-patterns-detection cryptocurrency head-and-shoulders stock-data stock-market stock-trading technical-analysis technical-indicators

Last synced: 26 days ago
JSON representation

A javascript technical indicators written in typescript with pattern recognition right in the browser

Lists

README 

        
[![Travis CI](https://img.shields.io/travis/anandanand84/technicalindicators.svg?style=flat-square)](https://travis-ci.org/anandanand84/technicalindicators)



# TechnicalIndicators



A javascript technical indicators written in typescript.



# Installation



## Node.js versions >= 10



``` bash

npm install --save technicalindicators

```



``` javascript

const SMA = require('technicalindicators').SMA;

```



## Node.js versions < 10



For nodejs version below 10 use 1.x versions of this library.



## Webpack



Make sure you have the following in your config file.



``` javascript

module.exports = {

  resolve: {

    mainFields: ["module", "main"]

  }

}



```



## Browser



For browsers install using npm, 



For ES6 browsers use



``` bash

npm install --save technicalindicators

```



```html



```



For ES5 support it is necessary to include the babel-polyfill and respective file browser.js otherwise you will get an error. For example see [index.html](https://github.com/anandanand84/technicalindicators/blob/master/index.html "index.html")



``` bash

npm install --save technicalindicators

npm install --save babel-polyfill

```



``` html



```



### Pattern detection



Pattern detection is removed from version 3.0, if you need pattern detection use v2.0



All indicators will be available in window object. So you can just use



``` javascript

sma({period : 5, values : [1,2,3,4,5,6,7,8,9], reversedInput : true});

```



or



``` javascript

SMA.calculate({period : 5, values : [1,2,3,4,5,6,7,8,9]});

```



# Playground



[Playground with code completion](http://anandanand84.github.io/technicalindicators/ "Playground")



# Crypto Trading hub



If you like this project. You'll love my other project [crypto trading hub](https://cryptotrading-hub.com/?utm_source=github&utm_medium=readme&utm_campaign=technicalindicators "Crypto trading hub")



1. Its free

1. Realtime price charts 

1. Unified trading experience across exchanges

1. Price alerts

1. Realtime crypto screening using javascript (Find coins making high and low in realtime or anything you can write using this library and javascript in realtime)

1. Trading from charts, 

1. Modify orders and ability to trade and create studies using javascript.



![Home](/images/home.png)

![Screener](/images/screener.png)

![Trade](/images/trade.png)



# Available Indicators



1. [Accumulation Distribution Line (ADL)](https://tonicdev.com/anandaravindan/adl "ADL").

1. [Average Directional Index (ADX)](https://github.com/anandanand84/technicalindicators/blob/master/test/directionalmovement/ADX.js "ADX").

1. [Average True Range (ATR)](https://tonicdev.com/anandaravindan/atr "ATR").

1. [Awesome Oscillator (AO)](https://github.com/anandanand84/technicalindicators/blob/master/test/oscillators/AwesomeOscillator.js "AO").

1. [Bollinger Bands (BB)](https://tonicdev.com/anandaravindan/bb "BB").

1. [Commodity Channel Index (CCI)](https://github.com/anandanand84/technicalindicators/blob/master/test/oscillators/CCI.js "CCI").

1. [Force Index (FI)](https://github.com/anandanand84/technicalindicators/blob/master/test/volume/ForceIndex.js "FI").

1. [Know Sure Thing (KST)](https://tonicdev.com/anandaravindan/kst "KST").

1. [Moneyflow Index (MFI)](https://github.com/anandanand84/technicalindicators/blob/master/test/volume/MFI.js "MFI").

1. [Moving Average Convergence Divergence (MACD)](https://tonicdev.com/anandaravindan/macd "MACD").

1. [On Balance Volume (OBV)](https://tonicdev.com/anandaravindan/obv "OBV").

1. [Parabolic Stop and Reverse (PSAR)](https://github.com/anandanand84/technicalindicators/blob/master/test/momentum/PSAR.js "PSAR").

1. [Rate of Change (ROC)](https://tonicdev.com/anandaravindan/roc "ROC").

1. [Relative Strength Index (RSI)](https://tonicdev.com/anandaravindan/rsi "RSI").

1. [Simple Moving Average (SMA)](https://tonicdev.com/anandaravindan/sma "SMA").

1. [Stochastic Oscillator (KD)](https://tonicdev.com/anandaravindan/stochastic "KD").

1. [Stochastic RSI (StochRSI)](https://tonicdev.com/anandaravindan/stochasticrsi "StochRSI").

1. [Triple Exponentially Smoothed Average (TRIX)](https://tonicdev.com/anandaravindan/trix "TRIX").

1. [Typical Price](https://github.com/anandanand84/technicalindicators/blob/master/test/chart_types/TypicalPrice.js "Typical Price").

1. [Volume Weighted Average Price (VWAP)](https://github.com/anandanand84/technicalindicators/blob/master/test/volume/VWAP.js "VWAP").

1. [Volume Profile (VP)](https://github.com/anandanand84/technicalindicators/blob/master/test/volume/VolumeProfile.js "VP").

1. [Exponential Moving Average (EMA)](https://tonicdev.com/anandaravindan/ema "EMA").

1. [Weighted Moving Average (WMA)](https://tonicdev.com/anandaravindan/wma "WMA").

1. [Wilder’s Smoothing (Smoothed Moving Average, WEMA)](https://tonicdev.com/anandaravindan/wema "WEMA").

1. [WilliamsR (W%R)](https://tonicdev.com/anandaravindan/williamsr "W%R").

1. [Ichimoku Cloud](https://github.com/anandanand84/technicalindicators/blob/master/test/ichimoku/IchimokuCloud.js "Ichimoku Cloud").



# Other Utils



1. [Average Gain](https://github.com/anandanand84/technicalindicators/blob/master/test/Utils/AverageGain.js "")

1. [Average Loss](https://github.com/anandanand84/technicalindicators/blob/master/test/Utils/AverageLoss.js "")

1. [Cross Up](https://github.com/anandanand84/technicalindicators/blob/master/test/Utils/CrossUp.js "")

1. [Cross Down](https://github.com/anandanand84/technicalindicators/blob/master/test/Utils/CrossDown.js "")

1. [Cross Over](https://github.com/anandanand84/technicalindicators/blob/master/test/Utils/CrossOver.js "")

1. [Highest](https://github.com/anandanand84/technicalindicators/blob/master/test/Utils/Highest.js "")

1. [Lowest](https://github.com/anandanand84/technicalindicators/blob/master/test/Utils/Lowest.js "")

1. [Standard Deviation](https://github.com/anandanand84/technicalindicators/blob/master/test/Utils/SD.js "")

1. [Sum](https://github.com/anandanand84/technicalindicators/blob/master/test/Utils/Sum.js "")



# Chart Types



1. [Renko (renko)](https://github.com/anandanand84/technicalindicators/blob/master/test/chart_types/Renko.js)

1. [Heikin-Ashi (HA)](https://github.com/anandanand84/technicalindicators/blob/master/test/chart_types/HeikinAshi.js)



# CandleStick Pattern



1. [Abandoned Baby](https://runkit.com/anandaravindan/abandoned-baby).

1. [Bearish Engulfing Pattern](https://runkit.com/aarthiaradhana/bearishengulfingpattern).

1. [Bullish Engulfiing Pattern](https://runkit.com/aarthiaradhana/bullishengulfingpattern).

1. [Dark Cloud Cover](https://runkit.com/aarthiaradhana/darkcloudcover).

1. [Downside Tasuki Gap](https://runkit.com/aarthiaradhana/downsidetasukigap).

1. [Doji](https://runkit.com/aarthiaradhana/doji).

1. [DragonFly Doji](https://runkit.com/aarthiaradhana/dragonflydoji).

1. [GraveStone Doji](https://runkit.com/aarthiaradhana/gravestonedoji).

1. [BullishHarami](https://runkit.com/aarthiaradhana/bullishharami).

1. [Bearish Harami Cross](https://runkit.com/aarthiaradhana/bearishharamicross).

1. [Bullish Harami Cross](https://runkit.com/aarthiaradhana/bullishharamicross).

1. [Bullish Marubozu](https://runkit.com/aarthiaradhana/bullishmarubozu).

1. [Bearish Marubozu](https://runkit.com/aarthiaradhana/bearishmarubozu).

1. [Evening Doji Star](https://runkit.com/aarthiaradhana/eveningdojistar).

1. [Evening Star](https://runkit.com/aarthiaradhana/eveningstar).

1. [Bearish Harami](https://runkit.com/aarthiaradhana/bearishharami).

1. [Piercing Line](https://runkit.com/aarthiaradhana/piercingline).

1. [Bullish Spinning Top](https://runkit.com/aarthiaradhana/bullishspinningtop).

1. [Bearish Spinning Top](https://runkit.com/aarthiaradhana/bearishspinningtop).

1. [Morning Doji Star](https://runkit.com/aarthiaradhana/morningdojistar).

1. [Morning Star](https://runkit.com/aarthiaradhana/morningstar).

1. [Three Black Crows](https://runkit.com/aarthiaradhana/threeblackcrows).

1. [Three White Soldiers](https://runkit.com/aarthiaradhana/threewhitesoldiers).

1. [Bullish Hammer](https://runkit.com/nerdacus/technicalindicator-bullishhammer).

1. [Bearish Hammer](https://runkit.com/nerdacus/technicalindicator-bearishhammer).

1. [Bullish Inverted Hammer](https://runkit.com/nerdacus/technicalindicator-bullishinvertedhammer).

1. [Bearish Inverted Hammer](https://runkit.com/nerdacus/technicalindicator-bearishinvertedhammer).

1. [Hammer Pattern](https://runkit.com/nerdacus/technicalindicator-hammerpattern).

1. [Hammer Pattern (Unconfirmed)](https://runkit.com/nerdacus/technicalindicator-hammerpatternunconfirmed).

1. [Hanging Man](https://runkit.com/nerdacus/technicalindicator-hangingman).

1. [Hanging Man (Unconfirmed)](https://runkit.com/nerdacus/technicalindicator-hangingmanunconfirmed).

1. [Shooting Star](https://runkit.com/nerdacus/technicalindicator-shootingstar).

1. [Shooting Star (Unconfirmed)](https://runkit.com/nerdacus/technicalindicator-shootingstarunconfirmed).

1. [Tweezer Top](https://runkit.com/nerdacus/technicalindicator-tweezertop).

1. [Tweezer Bottom](https://runkit.com/nerdacus/technicalindicator-tweezerbottom).



or



Search for all bullish or bearish using



``` javascript

var twoDayBullishInput = {

  open: [23.25,15.36],

  high: [25.10,30.87],

  close: [21.44,27.89],

  low: [20.82,14.93],

}



var bullish = require('technicalindicators').bullish;



bullish(twoDayBullishInput) //true

```



# API



There are three ways you can use to get the indicator results.



## calculate



Every indicator has a static method `calculate` which can be used to calculate the indicator without creating an object.



``` javascript

const sma = require('technicalindicators').sma;

var prices = [1,2,3,4,5,6,7,8,9,10,12,13,15];

var period = 10;

sma({period : period, values : prices})

```



or



``` javascript

const SMA = require('technicalindicators').SMA;

var prices = [1,2,3,4,5,6,7,8,9,10,12,13,15];

var period = 10;

SMA.calculate({period : period, values : prices})

```



## nextValue



`nextValue` method is used to get the next indicator value.



``` javascript

var sma = new SMA({period : period, values : []});

var results = [];

prices.forEach(price => {

  var result = sma.nextValue(price);

  if(result)

    results.push(result)

});

```



## getResult



This a merge of calculate and nextValue. The usual use case would be



1. Initialize indicator with available price value



1. Get results for initialized values



1. Use nextValue to get next indicator values for further tick.



    ``` javascript

    var sma = new SMA({period : period, values : prices});

    sma.getResult(); // [5.5, 6.6, 7.7, 8.9]

    sma.nextValue(16); // 10.1

    ```



    Note: Calling nextValue will not update getResult() value.



### Precision



This uses regular javascript numbers, so there can be rounding errors which are negligible for a technical indicators, you can set precision by using the below config. By default there is no precision set.



  ``` javascript

  const technicalIndicators = require('technicalindicators');

  technicalIndicators.setConfig('precision', 10);

  ```



# Contribute



Create issues about anything you want to report, change of API's, or request for adding new indicators. You can also create pull request with new indicators.



## Environment dependencies



Typescript: Use typescript 2.0.0 other you might get max call stack reached error.



``` npm install -g [email protected] ```



TechnicalIndicators depends on the [`canvas` package](https://npmjs.com/canvas), which requires some dependencies to be installed. You can find the instructions to do that [here](https://github.com/Automattic/node-canvas#installation). If you do not install these dependencies, expect to get this error message during the installation of TechnicalIndicators:



```

> [email protected] install /Users/balupton/Projects/trading/technicalindicators/node_modules/canvas

> node-gyp rebuild



./util/has_lib.sh: line 31: pkg-config: command not found

gyp: Call to './util/has_lib.sh freetype' returned exit status 0 while in binding.gyp. while trying to load binding.gyp

```



## Setup



``` bash

git clone [email protected]:anandanand84/technicalindicators.git  # or use your fork

cd technicalindicators

npm run start

```



## Running tests and getting coverage



``` bash

npm test

npm run cover

```



## Adding new indicators



1. Add tests for the indicator and make them pass.  

   (It would be better if a sample of the stockcharts excel is used for the test case.)

1. Add the indicator to the `index.js` and `src/index.ts`

1. Run build scripts: `npm run build-lib && npm run generateDts && npm run start`

1. Add it to `README.md`, with the link to the runkit url containing the sample.

1. Add indicator it to keywords in `package.json` and `bower.json`

1. Send a Pull Request.



## Verify Documentation



``` bash

node testdocs.js

open "http://localhost:5444/testdocs.html"

```



# Donate

1. XRB: `xrb_1shh8i77upiq4bjzi3ajik9ofq14bbcucshoapi3m7f8d74dc5k31o56yj5r`

1. ETH: `0x0B56580Eb25f3F7e366dDA697161d314C17Bcb6a`

1. LTC: `LLTUhKBRKs9sbW9F8MFQm7VVdZ1dJnXzGc`

1. BTC: `1FGeJHoj7tjeLrm4JNtyPWTdBKPJjcqP6Y`

1. BCH: `1AUFc8CEfHVjnoixbqTbX62WV8DZkpC1DU`