talib-binding

A synchronous TA-Lib bindings for Node.js & TypeScript.

Install

var yarn:

``bash
yarn add talib-binding
`

var npm:

`bash
npm install talib-binding --save
`

$3

Before install this module, you may need to install windows-build-tools by run:

`bash
npm install --global --production windows-build-tools
`

Usage

1. All the functions are exported, you can call it in the same form to c api, but there are some difference:
- the startIdx and endIdx is placed at the end of the function signature, and is optional.
- the return value is the computed result, if result is one array, will be it, else will be a nested array to contains all output arrays.
- if the ta-lib function returns a error code, will throw a error.
2. Additionally, you can pass a Record[] to extract its fields rather than input double array such as inHigh, inLow, etc. And if the input field is a implicit field of the records, you need to input a string to specifying which one field will be extract as it.
3. The types for TypeScript is generated, you can use this it in TypeScript projects.

Example

- call in the same form of TA-Lib:
`typescript
import * as talib from 'talib-binding'

talib.SAR(
[2, 3, 4, 5], / inHigh /
[1, 2, 3, 4], / inLow /
0.02, / optAcceleration_Factor, optional /
0.2, / optAF_Maximum, optional /
0, / startIdx, optional /
3 / endIdx, optional /
)
`
- pass a Record array as the first parameter, the library will extract the field value automatically, if the function contains some implicit parameter name, you need to pass the name string to extract it. The implicit parameter means that the param is not one of High, Low, Open, Close, and Volume, just like inReal, more detailed information could be found in the TypeScript function signatures.
`typescript
import * as talib from 'talib-binding'

const records = [
{Time: 0, Open: 1, High: 2, Low: 1, Close: 2, Volume: 1},
{Time: 0, Open: 2, High: 3, Low: 2, Close: 3, Volume: 1},
{Time: 0, Open: 3, High: 4, Low: 3, Close: 4, Volume: 1},
{Time: 0, Open: 4, High: 5, Low: 4, Close: 5, Volume: 1},
]

talib.SAR(records)

// The COS function contains implicit parameter name, you need to call it as follow:
talib.COS(records, 'Volume')
`
- if function return a single array, the return value will be it, else will be a nested array.
`typescript
import * as talib from 'talib-binding'

const outReal = talib.SAR([2, 3, 4, 5], [1, 2, 3, 4])
console.log(outReal)
// [ 1, 1.04, 1.1584 ]

const [outUp, outMid, outLow] = talib.ACCBANDS([2, 3, 4, 5], [1, 2, 3, 4], [2, 3, 4, 5], 3)
console.log(outUp, outMid, outLow)
// [ 5.45079365079365, 6.302645502645503 ]
// [ 3, 4 ]
// [ 0.4507936507936508, 1.3026455026455028 ]
`
- if TA function returns a error, OR startIdx/endIdx out of range, will throw it:
`typescript
import * as talib from 'talib-binding'

talib.ACCBANDS([2, 3, 4, 5], [1, 2, 3, 4], [2, 3, 4, 5], 10)
// throw RangeError: startIdx or endIdx out of range
`

Notes

- Some API need to use TA_MAType, which is exported as MATypes in the binding. For example:
`typescript
import * as talib from 'talib-binding'

talib.MA([1, 2, 3], void 0, talib.MATypes.SMA)
`

Contributing

Clone the repo at first:

`bash
git clone https://github.com/acrazing/talib-binding-node && cd talib-binding-node
`

All the files end with generated.* is generated by src/generate.ts. Maybe you need to view it
to get detailed information.

License

- This project published under MIT License.
- The TA-Lib` is published under LICENSE.