Stock写给前端的股票行情 SDK: stock-sdk，终于不用再求后端帮忙了

用 JavaScript 获取股票数据，真的有这么难吗？

起因

说实话，这个项目的诞生完全是被逼出来的。
去年我想做一个股票行情看板，就是那种简单的页面，能实时显示几只自选股的涨跌。听起来很简单对吧？但当我真正开始动手的时候，才发现事情没那么简单。
网上搜一圈，股票数据接口相关的工具几乎全是 Python 的。AkShare、Tushare、掘金量化……确实牛，功能也确实全，但问题是——我是个前端啊。
为了一个小看板，难道要我专门搭一个 Python 后端？再写个接口转发给前端？这也太折腾了。
于是我开始找有没有 JavaScript 能用的方案。结果你猜怎么着？翻遍了 npm，几乎找不到一个好用的。有的年久失修，有的只支持 Node.js 不支持浏览器，有的类型支持一塌糊涂，还有的接口莫名其妙就挂了。
摸索了一圈之后，我决定：算了，自己写一个得了。
stock-sdk 是什么？

简单说，stock-sdk 就是一个专门给前端和 Node.js 用的股票行情 SDK。
核心目标就一个：让你用最熟悉的 JavaScript / TypeScript，10 行代码搞定股票数据获取。

1. import { StockSDK } from 'stock-sdk';
3. const sdk = new StockSDK();
5. const quotes = await sdk.getSimpleQuotes(['sh000001', 'sz000858', 'sh600519']);
7. quotes.forEach(q => {
8.   console.log(`${q.name}: ${q.price} (${q.changePercent}%)`);
9. });

复制代码

就这么简单。不用搭后端，不用装 Python，浏览器里直接跑。
它能干什么？

写到现在，功能已经比较齐全了：
行情数据

• A 股、港股、美股、公募基金的实时行情
  
• 历史 K 线（日线、周线、月线）
  
• 分钟 K 线（1 分钟到 60 分钟都支持）
  
• 当日分时走势
  

板块数据

• 行业板块、概念板块的列表和实时行情
  
• 板块成分股
  
• 板块 K 线数据
  

技术指标

• 内置 MA、MACD、BOLL、KDJ、RSI 等常用指标
  
• 一个接口搞定 K 线 + 指标计算
  

扩展数据

• 资金流向
  
• 盘口大单
  
• A 股交易日历
  

批量能力

• 一次性获取全市场 5000+ 只 A 股行情
  
• 内置并发控制，不会把接口打挂
  
• 进度回调，知道当前拉取到哪里了
  

为什么要用它？

说实话，这个问题我自己也想过很久。毕竟市面上不是没有其他方案。
但仔细想想，stock-sdk 确实解决了一些痛点：
1. 零依赖，真的很小
压缩后不到 20KB。没有乱七八糟的依赖，不会给你的项目增加额外负担。
2. 浏览器和 Node.js 都能跑
这个是我一开始就确定的设计目标。不管你是做 Web 页面还是 Node.js 脚本，都能直接用。同时提供 ESM 和 CommonJS 两种格式，现代项目和老项目都兼容。
3. TypeScript 类型完整
说真的，类型提示这个东西，用过就回不去了。每个接口返回什么字段、每个参数是什么类型，IDE 里一目了然。写代码的时候不用反复查文档。
4. 接口稳定
数据源用的是腾讯财经和东方财富的公开接口，稳定性还是有保障的。而且我做了比较完善的错误处理，不会因为某个请求失败就整个崩掉。
适合什么场景？

这个 SDK 不是万能的，我也不打算把它做成大而全的东西。它比较适合这些场景：

• 股票看板：做一个自选股页面，看看涨跌
  
• 数据可视化：用 ECharts 或者 TradingView 画 K 线图
  
• 学习 Demo：金融课程、量化入门的演示项目
  
• 量化验证：快速验证一个交易策略的想法
  
• 定时脚本：Node.js 定时抓取行情数据
  

如果你需要更专业的量化回测、高频交易之类的，这个 SDK 可能就不太够用了。那种场景还是 Python 生态更成熟。
一些实际的例子

获取全市场 A 股行情

1. const allQuotes = await sdk.getAllAShareQuotes({
2.   batchSize: 300,
3.   concurrency: 5,
4.   onProgress: (completed, total) => {
5.     console.log(`进度: ${completed}/${total}`);
6.   },
7. });
9. console.log(`共获取 ${allQuotes.length} 只股票`);

复制代码

5000 多只股票，几秒钟就拉完了。并发控制是内置的，不用自己操心。
获取带技术指标的 K 线

1. const data = await sdk.getKlineWithIndicators('sh600519', {
2.   period: 'daily',
3.   count: 100,
4.   indicators: {
5.     ma: { periods: [5, 10, 20] },
6.     macd: true,
7.     boll: true,
8.   },
9. });
11. // data.kline 是原始 K 线
12. // data.indicators.ma 是均线数据
13. // data.indicators.macd 是 MACD 数据
14. // data.indicators.boll 是布林带数据

复制代码

一个接口把 K 线和指标都算好了，直接拿去画图就行。
写在最后

这个项目从去年开始写，断断续续维护到现在，功能也越来越完善了。
其实我一直觉得，工具这个东西，好不好用自己最清楚。stock-sdk 就是我自己在用的东西，遇到问题就修，需要新功能就加。
如果你也是前端，也需要获取股票数据，不妨试试。有问题欢迎提 Issue，我会尽量响应。
相关链接
<ul>
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！