简化技术指标

发起人: 反键 ——一个视觉画布,用于构建,回溯测试和优化您的浏览器中的交易策略. 建于此库上.

用于JavaScript / TypeScript的流式,分配轻技术分析工具包. 每个指标都属于一类 nextValue(...) 一次消耗一栏的方法,所以同一代码路径既驱动回试,又驱动活交易而不重建状态. 第二种方法, momentValue(...)中,计算一个假设栏的数值,而不承诺任何状态,对于在未完成的蜡烛内逐一重新计算有用.

特征

• 流出第一义. O(期)每行;无全行重算.
• momentValue 到处都是. 问"如果这个酒吧现在关闭了会有什么价值?" 没有变异状态.
• 类型脚本 . 强型横穿公地表.
• 跨 SDK 验证 . 130+ 滑稽测试 对照外部参考库对照我们的产出进行交叉检查(lwc 财务报告和审定财务报表 ti(原始内容存档于2018-09-29) (英语). With epsilon 1e-9. 见 测试 以下指标表格中,每个指标表的参数都经过核实.
• 细小的包裹. 只有预造的船 lib/ 捆-~85 kB 沥青球.

安装

npm install @debut/indicators

快开始

import { SMA, RSI, MACD, BollingerBands } from '@debut/indicators';

const sma = new SMA(20);
const rsi = new RSI(14);
const macd = new MACD(12, 26, 9);
const bb = new BollingerBands(20, 2);

for (const bar of bars) {
    const sm = sma.nextValue(bar.close);
    const r = rsi.nextValue(bar.close);
    const m = macd.nextValue(bar.close);   // → { macd, signal, histogram }
    const b = bb.nextValue(bar.close);     // → { lower, middle, upper }
    // ...indicator outputs are `undefined` until each one's warmup completes.
}

nextValue 返回时 undefined 直到该指标看到足够的条来产生结果(它的"温"——典型的 period ) (中文(简体) ). 之后它返回每个呼叫的当前值.

流线模型

nextValue(...) ——关闭栏

每个关上酒吧就叫这个 该方法推进了内部状态并返回了新的指标值. 随后的呼声反映了承诺状态.

momentValue(...) 栏内

用活(还成型)蜡烛的价格/量来称呼它,读取指标 将 如果酒吧现在关闭, 无 实施任何州。 当你想在蜡烛内反应时有用, 但当下一个真实时, 则重排干净 nextValue 来了.

const sma = new SMA(4);
[1, 2, 3].forEach((v) => sma.nextValue(v));   // warmup
sma.momentValue(8);   // 3.5  ← preview if close=8
sma.nextValue(4);     // 2.5  ← actual close=4 commits state
sma.momentValue(8);   // 4.75 ← preview based on committed state
sma.nextValue(8);     // 4.25 ← actual close=8 commits state

可用指标

以下是按类别分类的完整目录。 名称在 code style 是精确的命名导出来源 @debut/indicators可链接的指标名称导致在 docs/编辑 测试 列标记跨 SDK 校正运行的外部库 `lwc` =: lightweight-charts-indicators, (中文(简体) ), `ti` =: technicalindicators (见 交叉 SDK 验证 这是什么意思.

移动平均值

振荡器

时刻

趋势

波动性

频道和频段

数量

蜡烛和相片

移动/ 波浪( 定制)

运行时状态保存和恢复( R)

每个状态指标都暴露出两种方法:

• dumpState() 返回所有内部运行状态的 JSON 安全快照.
• restoreState(state) 恢复该快照为新指标实例并返回实例.

图片包括嵌入式提供者和滚动缓冲器,如 CircularBuffer,因此一个指标可以在进程重启后继续,而不重放全部历史。 构造参数仍然是指标配置的一部分: 将状态恢复为生成快照的相同周期/选项创建的实例.

import { EMA } from '@debut/indicators';

const ema = new EMA(20);

for (const close of history) {
    ema.nextValue(close);
}

// Persist this string in your own runtime storage: database, file, Redis, etc.
const serialized = JSON.stringify(ema.dumpState());

// Later, after a restart:
const restored = new EMA(20).restoreState(JSON.parse(serialized));

const liveValue = restored.nextValue(nextClose);

对于活的系统,在承诺每个已关闭的栏后,连同指标配置和溪流身份一起,保存状态. 启动时, 以相同的构造参数重新创建每个指标, 调用 restoreState(...),然后继续通过 nextValue(...)。 。 。 .

烛台图案

每个都是流派:

import { Doji, BullishEngulfingPattern, HammerPattern } from '@debut/indicators';

const doji = new Doji();
const engulfing = new BullishEngulfingPattern();
const hammer = new HammerPattern();   // 5-bar with confirmation candle

for (const bar of bars) {
    if (doji.nextValue(bar.open, bar.high, bar.low, bar.close)) console.log('Doji', bar.time);
    if (engulfing.nextValue(bar.open, bar.high, bar.low, bar.close)) console.log('Bull Engulfing', bar.time);
    if (hammer.nextValue(bar.open, bar.high, bar.low, bar.close)) console.log('Hammer', bar.time);
}

nextValue 返回时 true 当定时, false 如果没有,和 undefined 虽然它仍在变暖(多巴模式首先需要它们完全回放).

可配置阈值

每个图案都接受其构造器中的选项包. 默认匹配 ti 精确的引用; 收紧或放轻松.

const wideDoji = new Doji({ precision: 0.005 });           // 0.5% relative tolerance
const fastHammer = new HammerPattern({ confirm: false });  // skip the confirmation candle
const looseTweezer = new TweezerBottom({ equalityTolerance: 0.0001 });

联合扫描仪

如果你想同时对照许多图案扫描一栏,请使用三个组合扫描仪中的一个. 他们共享单子 OhlcBuffer 在图案模块中声明 这样你就不会支付每平面缓冲器的费用.

import { AllCandlestickPatterns, BullishPatterns, BearishPatterns } from '@debut/indicators';

const all = new AllCandlestickPatterns();
const bull = new BullishPatterns();
const bear = new BearishPatterns();

for (const bar of bars) {
    const fired = all.nextValue(bar.open, bar.high, bar.low, bar.close);
    if (fired.length) console.log(bar.time, fired);
    // → e.g. [1700000000, ['BullishHammerStick', 'BullishMarubozu']]

    if (bull.nextValue(bar.open, bar.high, bar.low, bar.close)) console.log('any bullish');
    if (bear.nextValue(bar.open, bar.high, bar.low, bar.close)) console.log('any bearish');
}

AllCandlestickPatterns.nextValue 返回向栏下开火的图案名称; BullishPatterns 编号 : BearishPatterns 返回单个布尔 ("did") 任意 模式火".

流之间的 Singleton 缓冲和重置

所有多栏模式共享一个 OhlcBuffer(5) 在模块范围内宣布的 src/candlestick/patterns.ts。第一个看到全新的栏杆推进缓冲器的图案;同一勾中后来的调用被OHLC Equality解开. 这意味着在新的模式实例中下降基本上是免费的——没有按平面分配的环.

如果您在独立的条流间切换( 或想要在测试个案间打扫), 请拨 BasePattern.reset()数字 :

import { BasePattern } from '@debut/indicators/lib/src/candlestick/patterns';

BasePattern.reset(); // clears the singleton OHLC ring + dedupe state

名称空格导入

如果你不想把35个符号拉入范围:

import { Candlestick } from '@debut/indicators';

const doji = new Candlestick.Doji();
const all = new Candlestick.AllCandlestickPatterns();

模式目录

会话卷简介

VolumeProfile 跨价格行交易总量和曝光量 POC 移动, (中文(简体) ), VAH 维基百科 编号 : VAL 评价 可配置 tickSize、分发和会议定位'daily' 默认情况下 —— 无限制的流不能永远地长出行图.

import { VolumeProfile } from '@debut/indicators';
const vp = new VolumeProfile({ tickSize: 0.5 });
for (const bar of bars) {
    const { poc, val, vah, total } = vp.nextValue(bar);
}

完整的选项、公式、业绩说明和自定义会议配方: 文件/卷。 。 。 .

公用事业

交叉 SDK 验证

每个端口指示器和烛台图案都有维特风格的光谱 tests/<name>/<name>.spec.ts 即:

1. 生成有种子LCG的确定性合成OHLCV条(见 tests/lwc-fixtures.ts) (中文(简体) ).
2. 把他们流出河中 @debut/indicators 课.
3. 在同一条行中运行 lwc calculate() (或 ti ————见 测试 每个指标表格中与该图案对应的参数.
4. 与 epsilon 1e-9(或为布尔模式射击设定成员)保持数值平等.

运行 npm test 执行完整的套房.

基准

苹果M1 Pro,节点 v16.14.0. 在有100k元素的数据集上测试.

基准结果由 https://github.com/debut-js/indexators-benchmark 页面存档备份,存于互联网档案馆

许可证

GPL-3.0 (英语)