@nvjs/data-gen v0.5.1

Data generator for NightVision charts

Install

npm i @nvjs/data-gen

Use

import Degen from '@nvjs/data-gen'

async function main() {

    let degen = new Degen()
    let data = await degen.get('APEUSDT', '15m', 420)

    console.log(data)
}

main()

Examples

// returns a simple ochlv dataset
get('APEUSDT', '1h', 4200)

// Text-based data constructor
get(`
    indexBased;
    $Candles {
        name=Ape Tether US Binance | data=@(APEUSDT, 1h, 420)
    }
    + Spline {name=EMA, 10 | data=ema(close, 10)}
    + Spline {name=EMA, 20 | data=ema(close, 20)};
    Spline {
        name=RSI, 14 |
        data=rsi(close, 14) |
        settings={ precision: 2 }
    };
    #pane0 { scales: { A: { precision: 2 } } };
`)

• indexBased sets the index-based mode
• $ means that Candles is the main overlay.
• @ loads data from Binance
• rsi(), ema() calculate TA with ta.js lib
• # is for the pane settings

Lines should be separated with ;. Each line is either:

• Overlay1 + Overlay2 + ... + OverlayN
• indexBased flag
• pane settings descriptor

Overlay props are separated with |:

Spline { name = EMA, 20 | data = ema(close, 20) }

Advanced Examples

// You can filter the main data to only one component:
get(`
    Spline {
        name=Ape Tether US Binance |
        data=@(APEUSDT, 1h, 420, close)
    };
`)

// Or you can get a separate component of OHLCV as
// an overlay data:
get(`
    $Candles {
        name=Ape Tether US Binance |
        data=@(APEUSDT, 1h, 420) |
    }
    + Volume {
        name = Vol |
        data = volume
    };
`)

// If that is not enough, you are able to build data
// element-by-element with iter() function:
get(`
    $Candles {
        name=Ape Tether US Binance | data=@(APEUSDT, 1h, 420) |
        settings={ precision: 2 }
    }
    + Volume {
        name = Vol |
        data = iter(i => {
            if (close[i] > open[i]) {
                return [volume[i], 1] // Volume Up
            } else {
                return [volume[i], -1] // Volume Down
            }
        })
    };
`)

// Add scripts (use `!` prefix):

get(`
    $Candles {
        name=Ape Tether US Binance | data=@(APEUSDT, 1h, 420) |
        settings={ precision: 2 }
    }
    + !EMA {
        props = {
            length: 12
        }
    };
`)