如果你也做过股票行情相关的小工具或 Demo，大概率踩过类似的坑：想在前端搞个行情看板、做 TradingView 或 ECharts 的数据源，或者在 Node 里定时抓取数据验证策略，结果发现生态全在 Python，接口返回格式混乱，再加上编码（GBK）、批量、并发、跨域等现实问题，开发体验极差。
因此开发了 stock-sdk。目标很简单：让前端工程师用最熟悉的 JavaScript / TypeScript，直接在浏览器或 Node.js 里优雅地拿到行情和 K 线数据。
以下将介绍其核心特性与使用场景。
核心特性
stock-sdk 是一个 TypeScript SDK，主要特点如下：
- 零依赖：纯 TS 实现，不靠第三方运行时包
- 双端运行：浏览器 + Node.js 18+ 均可直接使用（同时提供 ESM / CJS）
- 轻量：压缩后体积很小（< 20KB）
- 类型友好：接口类型完整，TS 开发体验流畅
数据能力覆盖了常用的'看盘/做图/做小策略验证'需求：
- 实时行情：A 股/指数、港股、美股、基金
- K 线：日/周/月历史 K 线；分钟 K 线（1/5/15/30/60）；当日分时走势
- 板块：行业板块/概念板块（列表、实时、成分股、K 线、分时）
- 扩展数据：资金流向、盘口大单占比、交易日历
- 批量能力：代码列表、全市场批量行情（带并发控制）
- 技术指标：MA、MACD、BOLL、KDJ、RSI、WR、BIAS、CCI、ATR（支持'只算指标'或'拿到 K 线顺便把指标算好'）
快速上手示例
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}%)`);
});
该 SDK 不强制要求搭建后端。很多时候只需快速跑通行情、查看页面效果或验证交互，无需专门上服务。
常用场景
1. 前端直接构建行情看板
拿行情 + 画图，本质是把数据源稳定地喂给 UI。SDK 已封装了编码、解析、类型、批量等脏活，前端只需关注渲染。
