stock-sdk 需要什么运行环境？

stock-sdk 是零依赖的，支持在浏览器和 Node.js 18+ 环境中运行。不需要 Python 环境，也不需要额外的后端服务。

如何从 v1 升级到 v2？

v2 是一次架构跃迁，包含破坏性变更且无兼容别名。升级前需要先阅读官方的 v1 → v2 迁移指南。旧版可通过 npm install stock-sdk@legacy 安装。

支持哪些市场的股票数据？

支持 A 股、港股、美股和公募基金。此外还支持全球期货和部分期权（ETF、中金所、商品）的数据。

如何将 stock-sdk 接入 AI 工具？

v2 内置了零依赖的 MCP server。可以通过 npx stock-sdk mcp 启动，并在 Cursor 或 Claude Desktop 等客户端的 mcpServers 配置中添加对应命令即可接入。

如果只需要计算技术指标，会引入网络请求代码吗？

不会。stock-sdk 支持 subpath 导出，例如通过 import { calcMACD } from 'stock-sdk/indicators' 引入，bundle 中不会拖入 RequestClient 和网络层代码。

如何处理接口请求失败的情况？

SDK 提供了请求治理能力，包括 provider 级的重试、限流和熔断。在错误处理上，v2 统一抛出带有标准 code 的 SdkError，可以从 stock-sdk/errors 导入相关类型进行捕获。

September 25, 2026

stock-sdk

Business & Finance Fundraising and Investing0

View repo

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

Custom License

股票行情数据

安装命令（说明）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}%)`);
});

Product facts

Type: API, SDK & Library
Category: Business & Finance › Fundraising and Investing
Pricing: Open source
License: Custom License
Launched: Sep 25, 2026
Listed: Sep 25, 2026
Website: github.com

Overview

GitHub GitHub

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 双格式支持。

Key features

零依赖双端运行：无需 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。

Releases

Notify me

Initial · stock-sdk

September 25, 2026

Q&A

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

View repo

Bookmark

This product has no owner yet

It was listed by the platform or its author left. If it is your work, prove your relationship to become the owner.

Claim this product