Stock SDK

English | 中文

为 前端和 Node.js 设计的股票行情 JavaScript SDK。

无需 Python、无需后端服务，直接在 浏览器或 Node.js 中获取 A 股 / 港股 / 美股 / 公募基金 的实时行情与 K 线数据。

✨ 零依赖 | 🌐 Browser + Node.js | 📦 轻量发布包 | 🧠 完整 TypeScript 类型

Documentation

👉🏻 官方文档

📦 NPM | 📖 GitHub | 🎮 在线演示

🧭 Stock Dashboard：基于 stock-sdk 搭建的股票数据大盘演示站点，欢迎体验。

Why stock-sdk？

如果你是前端工程师，可能遇到过这些问题：

• 股票行情工具大多是 Python 生态，前端难以直接使用
• 想做行情看板 / Demo，不想额外维护后端服务
• 财经接口返回格式混乱、编码复杂（GBK / 并发 / 批量）
• AkShare 很强，但并不适合浏览器或 Node.js 项目

stock-sdk 的目标很简单：

让前端工程师，用最熟悉的 JavaScript / TypeScript，优雅地获取股票行情数据。

---

使用场景

• 📊 股票行情看板（Web / Admin）
• 📈 数据可视化（ECharts / TradingView）
• 🎓 股票 / 金融课程 Demo
• 🧪 量化策略原型验证（JS / Node）
• 🕒 Node.js 定时抓取行情数据

---

特性

• ✅ 零依赖，轻量级发布包
• ✅ 支持 浏览器 和 Node.js 18+ 双端运行
• ✅ 同时提供 ESM 和 CommonJS 两种模块格式
• ✅ 完整的 TypeScript 类型定义和单元测试覆盖
• ✅ A 股、港股、美股、公募基金实时行情
• ✅ 历史 K 线（日/周/月）、分钟 K 线（1/5/15/30/60 分钟）和当日分时走势数据
• ✅ 技术指标：内置 MA、MACD、BOLL、KDJ、RSI、WR、BIAS、CCI、ATR、OBV、ROC、DMI、SAR、KC
• ✅ 期货行情：国内期货 K 线、全球期货实时行情与 K 线、期货库存数据
• ✅ 期权数据：中金所股指期权、上交所 ETF 期权、商品期权的报价 / K 线 / 分钟行情
• ✅ 资金流向（个股/大盘/排名/板块）、盘口大单、涨停板池、盘口异动 等扩展数据
• ✅ 沪深港通 / 北向资金（分时、汇总、持股排行、历史、个股持仓）
• ✅ 龙虎榜（详情、个股统计、机构买卖、营业部排行、席位明细）
• ✅ 大宗交易 + 融资融券 全套数据
• ✅ 获取全部 A 股代码列表（5000+ 只股票）和批量获取全市场行情（内置并发控制）
• ✅ 支持 provider 级重试 / 限流 / 熔断策略覆盖，兼容旧的全局请求配置
• ✅ AI / MCP 就绪 — 配套 stock-sdk-mcp MCP Server，一行命令接入 Cursor / Claude / Gemini 等 AI 工具

安装

npm install stock-sdk
# 或
yarn add stock-sdk
# 或
pnpm add stock-sdk

快速开始（10 行 Demo）

import { StockSDK } from 'stock-sdk';

const sdk = new StockSDK();

const quotes = await sdk.getSimpleQuotes([
  'sh000001',
  'sz000858',
  'sh600519',
]);

quotes.forEach(q => {
  console.log(`${q.name}: ${q.price} (${q.changePercent}%)`);
});

示例：全市场 A 股行情

前端直接一次性获取全市场 A 股行情（5000+股票），无需 Python 或后端服务。

const allQuotes = await sdk.getAllAShareQuotes({
  batchSize: 300,
  concurrency: 5,
  onProgress: (completed, total) => {
    console.log(`进度: ${completed}/${total}`);
  },
});

console.log(`共获取 ${allQuotes.length} 只股票`);

请求治理与错误码

import { StockSDK, HttpError, getSdkErrorCode } from 'stock-sdk';

const sdk = new StockSDK({
  retry: { maxRetries: 2, baseDelay: 500 },
  providerPolicies: {
    eastmoney: {
      timeout: 12000,
      rateLimit: { requestsPerSecond: 3, maxBurst: 3 },
    },
  },
});

try {
  await sdk.getSimpleQuotes(['sh600519']);
} catch (error) {
  if (error instanceof HttpError) {
    console.log(error.status, error.statusText);
  }

  console.log(getSdkErrorCode(error)); // HTTP_ERROR / NETWORK_ERROR / TIMEOUT ...
}

getSdkErrorCode 只做标准化识别，不会改变原始错误实例类型。网络错误仍然保持 TypeError，超时仍然保持 AbortError / DOMException 的兼容行为。

开发校验命令

yarn typecheck
yarn build
yarn test
yarn test:integration:smoke
# 全量集成回归
yarn test:integration:full

🤖 AI / MCP 集成

Stock SDK 配套 MCP Server（stock-sdk-mcp），可一键接入主流 AI 工具：

AI 工具	配置方式
Cursor	~/.cursor/mcp.json
Claude Desktop	claude_desktop_config.json
OpenClaw	~/.clawdbot/config.yaml
Codex CLI	~/.codex/config.json
Gemini CLI	~/.gemini/settings.json

配置示例：

{
  "mcpServers": {
    "stock-sdk": {
      "command": "npx",
      "args": ["-y", "stock-sdk-mcp"]
    }
  }
}

内置 4 个专业 AI Skills： 技术分析 / 智能选股 / 市场概览 / 实时监控

👉 完整 MCP 文档

---

API 列表

💡 API 详细文档请查阅 https://stock-sdk.linkdiary.cn/

实时行情

方法	说明
getFullQuotes	A 股/指数全量行情
getSimpleQuotes	A 股/指数简要行情
getHKQuotes	港股行情
getUSQuotes	美股行情
getFundQuotes	公募基金行情

K 线数据

方法	说明
getHistoryKline	A 股历史 K 线（日/周/月）
getHKHistoryKline	港股历史 K 线（日/周/月）
getUSHistoryKline	美股历史 K 线（日/周/月）
getMinuteKline	A 股分钟 K 线（1/5/15/30/60 分钟）
getTodayTimeline	A 股当日分时走势

技术指标

方法	说明
getKlineWithIndicators	获取带技术指标的 K 线数据
calcMA	计算均线（SMA/EMA/WMA）
calcMACD	计算 MACD
calcBOLL	计算布林带
calcKDJ	计算 KDJ
calcRSI	计算 RSI
calcWR	计算威廉指标
calcBIAS	计算乖离率
calcCCI	计算商品通道指数
calcATR	计算平均真实波幅
calcOBV	计算能量潮
calcROC	计算变动率指标
calcDMI	计算趋向指标
calcSAR	计算抛物线转向
calcKC	计算肯特纳通道

行业板块

方法	说明
getIndustryList	行业板块名称列表
getIndustrySpot	行业板块实时行情
getIndustryConstituents	行业板块成分股
getIndustryKline	行业板块历史 K 线（日/周/月）
getIndustryMinuteKline	行业板块分时行情（1/5/15/30/60 分钟）

概念板块

方法	说明
getConceptList	概念板块名称列表
getConceptSpot	概念板块实时行情
getConceptConstituents	概念板块成分股
getConceptKline	概念板块历史 K 线（日/周/月）
getConceptMinuteKline	概念板块分时行情（1/5/15/30/60 分钟）

期货行情

方法	说明
getFuturesKline	国内期货历史 K 线（日/周/月）
getGlobalFuturesSpot	全球期货实时行情
getGlobalFuturesKline	全球期货历史 K 线（日/周/月）
getFuturesInventorySymbols	期货库存品种列表
getFuturesInventory	期货库存数据
getComexInventory	COMEX 黄金/白银库存

期权数据

方法	说明
getIndexOptionSpot	中金所股指期权 T 型报价（看涨 + 看跌）
getIndexOptionKline	股指期权合约日 K 线
getCFFEXOptionQuotes	中金所全部期权实时行情列表
getETFOptionMonths	上交所 ETF 期权到期月份列表
getETFOptionExpireDay	ETF 期权到期日与剩余天数
getETFOptionMinute	ETF 期权当日分钟行情
getETFOptionDailyKline	ETF 期权历史日 K 线
getETFOption5DayMinute	ETF 期权 5 日分钟行情
getCommodityOptionSpot	商品期权 T 型报价
getCommodityOptionKline	商品期权合约日 K 线
getOptionLHB	期权龙虎榜

扩展数据

方法	说明
getFundFlow	资金流向（按代码批量查询）
getPanelLargeOrder	盘口大单占比
getTradingCalendar	A 股交易日历
getDividendDetail	股票分红派送详情

资金流向（深度）

方法	说明
getIndividualFundFlow	个股资金流历史（日/周/月）
getMarketFundFlow	大盘（上证 + 深证）资金流历史
getFundFlowRank	个股资金流排名（今日 / 3 日 / 5 日 / 10 日）
getSectorFundFlowRank	板块资金流排名（行业 / 概念 / 地域）
getSectorFundFlowHistory	单个板块的历史资金流

沪深港通 / 北向资金

方法	说明
getNorthboundMinute	北向 / 南向资金分时数据
getNorthboundFlowSummary	沪深港通市场资金流向汇总
getNorthboundHoldingRank	北向 / 沪股通 / 深股通持股个股排行
getNorthboundHistory	北向 / 南向资金历史
getNorthboundIndividual	个股北向持仓历史

涨停板 / 盘口异动

方法	说明
getZTPool	涨停 / 昨日涨停 / 强势 / 次新 / 炸板 / 跌停 6 大股池
getStockChanges	22 种盘口异动（火箭发射 / 大笔买入 / 封涨停 等）
getBoardChanges	当日板块异动详情

龙虎榜

方法	说明
getDragonTigerDetail	龙虎榜详情（按日期范围）
getDragonTigerStockStats	个股上榜统计（近 1/3/6 月、1 年）
getDragonTigerInstitution	机构买卖统计
getDragonTigerBranchRank	营业部排行
getDragonTigerStockSeatDetail	个股某日上榜席位明细（买入榜 + 卖出榜）

大宗交易 / 融资融券

方法	说明
getBlockTradeMarketStat	大宗交易市场每日总览
getBlockTradeDetail	大宗交易明细
getBlockTradeDailyStat	大宗交易每日统计（按股票汇总）
getMarginAccountInfo	融资融券账户统计
getMarginTargetList	融资融券标的明细

批量查询

方法	说明
getAShareCodeList	获取全部 A 股代码
getUSCodeList	获取全部美股代码
getHKCodeList	获取全部港股代码
getAllAShareQuotes	获取全市场 A 股行情
getAllHKShareQuotes	获取全市场港股行情
getAllUSShareQuotes	获取全市场美股行情
getAllQuotesByCodes	批量获取指定股票行情

搜索

方法	说明
search	搜索股票代码/名称/拼音

---

许可证

ISC

---

🌐 官网 | 📦 NPM | 📖 GitHub | 🎮 在线演示 | 🧭 Stock Dashboard | 🐛 Issues

---

如果这个项目对你有帮助，欢迎 Star ⭐ 或提出 Issue 反馈。