技术指标概览

Stock SDK 提供两种方式使用技术指标：

1. 一站式 API：getKlineWithIndicators 获取 K 线时自动计算指标
2. 独立计算函数：calcMA、calcMACD 等，灵活控制

getKlineWithIndicators

获取带技术指标的 K 线数据。支持 A 股、港股、美股，自动识别市场。

签名

getKlineWithIndicators(
  symbol: string,
  options?: {
    market?: 'A' | 'HK' | 'US';
    period?: 'daily' | 'weekly' | 'monthly';
    adjust?: '' | 'qfq' | 'hfq';
    startDate?: string;
    endDate?: string;
    indicators?: IndicatorOptions;
  }
): Promise<KlineWithIndicators[]>

计算说明

getKlineWithIndicators 会自动向前补拉足够的历史数据用于指标计算，并在返回时裁剪为你指定的日期范围。

参数

参数	类型	默认值	说明
symbol	string	-	股票代码
market	string	自动识别	市场类型：'A' / 'HK' / 'US'
period	string	'daily'	K 线周期
adjust	string	'qfq'	复权类型
startDate	string	-	开始日期
endDate	string	-	结束日期
indicators	object	-	指标配置

indicators 配置

interface IndicatorOptions {
  ma?: MAOptions | boolean;      // 均线
  macd?: MACDOptions | boolean;  // MACD
  boll?: BOLLOptions | boolean;  // 布林带
  kdj?: KDJOptions | boolean;    // KDJ
  rsi?: RSIOptions | boolean;    // RSI
  wr?: WROptions | boolean;      // WR 威廉指标
  bias?: BIASOptions | boolean;  // 乖离率
  cci?: CCIOptions | boolean;    // CCI
  atr?: ATROptions | boolean;    // ATR
}

示例

const data = await sdk.getKlineWithIndicators('sz000001', {
  startDate: '20240101',
  endDate: '20241231',
  indicators: {
    ma: { periods: [5, 10, 20, 60] },
    macd: true,
    boll: true,
    kdj: true,
    rsi: { periods: [6, 12] },
    wr: true,
    bias: { periods: [6, 12, 24] },
    cci: { period: 14 },
    atr: { period: 14 },
  }
});

data.forEach(k => {
  console.log(`${k.date}: ${k.close}`);
  console.log(`  MA5=${k.ma?.ma5}, MA10=${k.ma?.ma10}`);
  console.log(`  MACD: DIF=${k.macd?.dif}, DEA=${k.macd?.dea}`);
  console.log(`  BOLL: 上=${k.boll?.upper}, 中=${k.boll?.mid}, 下=${k.boll?.lower}`);
  console.log(`  KDJ: K=${k.kdj?.k}, D=${k.kdj?.d}, J=${k.kdj?.j}`);
  console.log(`  RSI6=${k.rsi?.rsi6}, WR6=${k.wr?.wr6}`);
  console.log(`  BIAS6=${k.bias?.bias6}, CCI=${k.cci?.cci}, ATR=${k.atr?.atr}`);
});

---

市场自动识别

SDK 会根据代码格式自动识别市场：

// A 股（自动识别）
const aData = await sdk.getKlineWithIndicators('sz000001', {
  indicators: { ma: true, macd: true }
});

// 港股（5 位代码，自动识别）
const hkData = await sdk.getKlineWithIndicators('00700', {
  indicators: { ma: true, macd: true }
});

// 美股（{market}.{ticker} 格式，自动识别）
const usData = await sdk.getKlineWithIndicators('105.MSFT', {
  indicators: { boll: true, rsi: true }
});

识别规则

格式	市场	示例
6 位数字或 sh/sz/bj 前缀	A 股	000001, sz000001
5 位数字	港股	00700, 09988
{市场}.{代码}	美股	105.MSFT, 106.BABA

---

支持的指标

指标	方法	说明
MA	calcMA	均线（SMA/EMA/WMA）
MACD	calcMACD	指数平滑异同移动平均线
BOLL	calcBOLL	布林带
KDJ	calcKDJ	随机指标
RSI	calcRSI	相对强弱指标
WR	calcWR	威廉指标
BIAS	calcBIAS	乖离率
CCI	calcCCI	商品通道指数
ATR	calcATR	平均真实波幅
OBV	calcOBV	能量潮
ROC	calcROC	变动率指标
DMI/ADX	calcDMI	趋向指标
SAR	calcSAR	抛物线转向
KC	calcKC	肯特纳通道

---

独立计算函数

所有指标计算函数都可以独立导入使用：

import {
  calcMA,
  calcSMA,
  calcEMA,
  calcWMA,
  calcMACD,
  calcBOLL,
  calcKDJ,
  calcRSI,
  calcWR,
  calcBIAS,
  calcCCI,
  calcATR,
  // 新增指标
  calcOBV,
  calcROC,
  calcDMI,
  calcSAR,
  calcKC,
  addIndicators,
} from 'stock-sdk';

addIndicators 可以把多个指标一次性挂到 K 线数组上，适合图表渲染场景。

---

新增指标使用示例

OBV 能量潮

import { calcOBV } from 'stock-sdk';

const klines = await sdk.getHistoryKline('sz000001');
const obv = calcOBV(klines, { maPeriod: 20 });
console.log(obv[30].obv);    // OBV 值
console.log(obv[30].obvMa);  // OBV 20 日均线

ROC 变动率

import { calcROC } from 'stock-sdk';

const klines = await sdk.getHistoryKline('sz000001');
const roc = calcROC(klines, { period: 12, signalPeriod: 6 });
console.log(roc[20].roc);     // ROC 值
console.log(roc[25].signal);  // 信号线

DMI/ADX 趋向指标

import { calcDMI } from 'stock-sdk';

const klines = await sdk.getHistoryKline('sz000001');
const dmi = calcDMI(klines, { period: 14 });
console.log(dmi[30].pdi);  // +DI（上升方向）
console.log(dmi[30].mdi);  // -DI（下降方向）
console.log(dmi[30].adx);  // ADX（趋势强度）

SAR 抛物线转向

import { calcSAR } from 'stock-sdk';

const klines = await sdk.getHistoryKline('sz000001');
const sar = calcSAR(klines);
console.log(sar[30].sar);    // SAR 值
console.log(sar[30].trend);  // 趋势方向：1 上升，-1 下降

KC 肯特纳通道

import { calcKC } from 'stock-sdk';

const klines = await sdk.getHistoryKline('sz000001');
const kc = calcKC(klines, { emaPeriod: 20, multiplier: 2 });
console.log(kc[30].upper);  // 上轨
console.log(kc[30].mid);    // 中轨
console.log(kc[30].lower);  // 下轨

详细用法请参考各指标的专属文档。