Builderoom
登录注册
作品形态766API / SDK / 库24商业与财务2融资与投资1股票行情数据1

2026年9月25日

stock-sdk

商业与财务融资与投资0
查看仓库

为前端和 Node.js 设计的零依赖股票行情 JavaScript SDK，支持 A 股、港股、美股及公募基金数据获取。

自定义授权
股票行情数据
安装命令（说明）bash
npm install stock-sdk
最小示例代码python
import { StockSDK } from 'stock-sdk';

const sdk = new StockSDK();

const quotes = await sdk.quotes.cnSimple(['sh000001', 'sz000858', 'sh600519']);
quotes.forEach((q) => {
  console.log(`${q.name}: ${q.price} (${q.changePercent}%)`);
});

产品信息

形态
API / SDK / 库
分类
商业与财务 › 融资与投资
定价
开源
授权协议
自定义授权
首发日期
2026年9月25日
收录时间
2026年9月25日
官网
github.com

概览

GitHubGitHub

stock-sdk 是一个用 TypeScript 编写的股票行情 SDK，面向前端工程师和 Node.js 开发者。它解决了传统股票行情工具多依赖 Python 生态、需要维护后端服务以及财经接口格式混乱等问题，允许开发者直接在浏览器或 Node.js 环境中获取股票数据。 该 SDK 支持 A 股、港股、美股和公募基金的实时行情与历史 K 线数据（日/周/月/分钟级），并内置 MA、MACD、BOLL、KDJ 等 14 种技术指标计算能力。此外，还提供筹码分布（CYQ）、信号识别、链式选股和本地回测功能。扩展数据覆盖期货、期权、资金流、龙虎榜、北向资金、融资融券等。 在架构设计上，stock-sdk 采用命名空间 API，提供统一的符号模型以容错解析不同市场的股票代码写法。v2.0.0 版本引入了统一错误体系，对外只抛出带标准 code 的 SdkError。请求治理方面支持 provider 级重试、限流和熔断，并允许注入自定义 fetchImpl 和生命周期 hooks。 除了作为库使用，stock-sdk 还自带 CLI 命令行工具和 MCP server。CLI 可以在终端直接查询行情、K 线和指标；MCP server 则允许通过一条命令将股票数据源接入 Cursor、Claude 等 AI 工具。SDK 支持 subpath 导出，纯计算模块可独立引入以避免拖入网络层代码，对 tree-shake 友好。同时提供 ESM 和 CommonJS 双格式支持。

功能特性

  • 零依赖双端运行：无需 Python 或后端服务，在浏览器和 Node.js 18+ 中直接运行，同时提供 ESM 和 CommonJS 格式。
  • 多市场行情与 K 线：支持 A 股、港股、美股、公募基金的实时行情，以及日、周、月和分钟级历史 K 线数据。
  • 命名空间 API：按领域分组设计，如 sdk.quotes.cn() 和 sdk.kline.cn()，便于 IDE 自动补全。
  • 统一符号模型：支持多种股票代码写法（如 sh600519、600519.SH、AAPL）的容错解析。
  • 技术指标计算：内置 MA、MACD、BOLL、KDJ、RSI 等 14 种技术指标的纯函数计算。
  • 筹码分布 (CYQ)：本地计算获利比例、平均成本、成本区间与集中度及筹码峰直方图。
  • 信号选股与回测：提供金叉死叉等事件识别、链式选股器以及本地策略回测功能。
  • 扩展金融数据：覆盖期货、期权、资金流、龙虎榜、北向资金、大宗交易、融资融券等数据。
  • CLI 命令行工具：安装后即可在终端通过命令直接查询行情、K 线、指标或搜索股票。
  • 内置 MCP Server：零依赖实现，一行命令启动，可将数据源接入 Cursor、Claude 等 AI 工具。
  • Subpath 导出：指标、信号、选股等纯计算模块可独立导入，不拖入网络层，利于 tree-shake。
  • 请求治理与错误体系：支持重试、限流、熔断，统一抛出带标准 code 的 SdkError。

版本更新

新版本提醒我

首个版本 · stock-sdk

Q&A

stock-sdk 需要什么运行环境？由 AI 生成
stock-sdk 是零依赖的，支持在浏览器和 Node.js 18+ 环境中运行。不需要 Python 环境，也不需要额外的后端服务。
如何从 v1 升级到 v2？由 AI 生成
v2 是一次架构跃迁，包含破坏性变更且无兼容别名。升级前需要先阅读官方的 v1 → v2 迁移指南。旧版可通过 npm install stock-sdk@legacy 安装。
支持哪些市场的股票数据？由 AI 生成
支持 A 股、港股、美股和公募基金。此外还支持全球期货和部分期权（ETF、中金所、商品）的数据。
如何将 stock-sdk 接入 AI 工具？由 AI 生成
v2 内置了零依赖的 MCP server。可以通过 npx stock-sdk mcp 启动，并在 Cursor 或 Claude Desktop 等客户端的 mcpServers 配置中添加对应命令即可接入。
如果只需要计算技术指标，会引入网络请求代码吗？由 AI 生成
不会。stock-sdk 支持 subpath 导出，例如通过 import { calcMACD } from 'stock-sdk/indicators' 引入，bundle 中不会拖入 RequestClient 和网络层代码。
如何处理接口请求失败的情况？由 AI 生成
SDK 提供了请求治理能力，包括 provider 级的重试、限流和熔断。在错误处理上，v2 统一抛出带有标准 code 的 SdkError，可以从 stock-sdk/errors 导入相关类型进行捕获。
更多
查看仓库
收藏

这个产品还没有主理人

由平台收录或原作者已注销。如果它是你的作品，证明与它的关系后即可成为主理人。

认领这个产品