ashareapi — A股数据 API 官方 Node.js / TypeScript SDK
行情 / K线 / 财务 / 资金 / 龙虎榜 / 板块 / 因子选股 / 量化回测 —— 40 个端点,免费端点无需注册。
零运行时依赖(用 Node 原生 fetch),自带 TypeScript 类型。
中文 · English
官网 · 文档 · 端点清单 · MCP 接入 · Agent Skill
GitHub 源码 · 问题反馈 Issues · 更新日志
npm install ashareapi
⚠️ 仅在服务端使用(Node / Next.js 服务端 / 脚本)。浏览器里会暴露你的 API Key —— 本包刻意不提供浏览器构建。
也有 Python SDK:
pip install ashareapi—— PyPI
这是什么
A股数据 API 的官方 Node.js / TypeScript SDK —— 把 HTTP 端点包成一行方法调用,省掉自己拼 URL、处理重试、解析返回结构。npm install ashareapi 之后:
import { AShareAPI } from "ashareapi";
const cli = new AShareAPI({ apiKey: "ct-你的Key" }); // 或设环境变量 ASHARE_API_KEY
console.log(await cli.quote("sh600667")); // 行情
console.log(await cli.backtest({ code: "sh600667", strategy: "mom20" })); // 量化回测
5 个端点无需 Key(装上就能调):/v1/quote · /v1/kline · /v1/hot · /v1/market-overview · /v1/changedist。其余端点需要 Key(获取,¥9.9 起)。
30 秒上手
import { AShareAPI } from "ashareapi";
const cli = new AShareAPI(); // 免费端点无需 Key
const bars = await cli.quote("sh600667"); // 实时行情
console.log(bars[0]); // { date, open, last, high, low, volume, amount, turnover }
console.log(await cli.kline("600667.SH", "day", 5)); // 代码格式随便写(自动归一化)
console.log(await cli.hot(10)); // 热搜榜
付费端点(财务 / 资金 / 龙虎榜 / 选股等)需要 Key(获取,¥9.9 起):
const cli = new AShareAPI({ apiKey: "ct-你的Key" }); // 或设环境变量 ASHARE_API_KEY
const rows = await cli.screen("", "low_pe", 10, "ROETTM");
console.table(rows);
CommonJS 同样可用:
const { AShareAPI } = require("ashareapi"); // 双格式产物,import / require 都行
为什么用它
- 零依赖:只用 Node 原生
fetch—— 安装快、无供应链风险(Python 版还需要requests) - 免费端点真的免 Key:
quote / kline / hot / market-overview / changedist直接调,无需注册 - 代码格式兼容:
sh600667/600667.SH/600667都认 - 方法名两种写法都认:
marketOverview()与market_overview()是同一个方法(Python 版用户零摩擦迁移) - 多源自动切换:后端 70 个数据源互为备份,取数失败会自动换源且不扣调用次数
- 口径固定,不用二次处理:K 线固定前复权(没有
adjust参数),不会二次复权 - 错误分类清楚:
AuthError/RateLimitError/UpstreamError/EmptyResultError(无数据 ≠ 失败)—— 每类都告诉你该做什么 - 不用你维护:多源切换 / 缓存 / 巡检都在服务端,客户端只负责调用
- TypeScript 原生:完整
.d.ts,编辑器里cli.直接补全 38 个方法与参数
端点一览
⚠️ K 线复权口径由服务端固定(没有
adjust参数):日线及以上为前复权(除权除息日不跳空),分钟线为不复权 —— 不要再自己复权(会二次复权)。
(完整 40 端点见 端点清单;方法签名与线上 /openapi.json 一致)
返回形态
方法返回 对象数组(Row[]),即 JS 里的"表格":
const rows = await cli.kline("sh600667", "day", 3);
// [ { date: '2026-09-23', open: '20.10', last: '20.59', ... }, ... ]
需要完整信封(含 elapsed_ms / source / tier)时:
const cli = new AShareAPI({ raw: true });
const env = await cli.quote("sh600667");
// { ok: true, endpoint: '/v1/quote', tier: 'free', elapsed_ms: 862, source: '...', data: [...] }
与 Python 版差异:Python 版默认返回
pandas.DataFrame(没装 pandas 则list[dict]);JS 版没有 DataFrame 概念,统一返回Row[]。另外 JS 版全部返回 Promise(Python 版是同步)。
错误处理
import { AShareAPI, AuthError, RateLimitError, UpstreamError, EmptyResultError } from "ashareapi";
const cli = new AShareAPI();
try {
const rows = await cli.fund("sh600667");
} catch (e) {
if (e instanceof AuthError) console.log(e.message); // 401 / 缺 Key → 去拿 Key
else if (e instanceof RateLimitError) console.log(e.message); // 429 → 降频 / 解 PoW 提额(只提次数)/ 升级档位
else if (e instanceof UpstreamError) console.log(e.message); // 上游取数失败(已自动换源、不扣次数)→ 重试一次通常就好
else if (e instanceof EmptyResultError) console.log(e.message); // 当前无数据(如当天无大宗交易)→ 不计费
else throw e;
}
也用 AI Agent(MCP / Agent Skill)
除了 Node SDK,我们还提供两种 AI Agent 接入方式:
- MCP 服务器(Streamable HTTP)—— 服务器地址
https://api.ashareapi.com/mcp(⚠️ 填这个接口地址;站点介绍页ashareapi.com/mcp不是接口) - 各客户端配置写法(Claude Code / Cursor / VS Code / Codex 等 19 家,键名差异都核对过官方文档): https://ashareapi.com/mcp
- Agent Skill(给 AI Agent 读的接口说明书 + 分发包,装进 skills 目录即用):https://ashareapi.com/skill
免费工具/端点无需 Key;付费工具在请求头带
Authorization: Bearer <你的 Key>。
示例
仓里 examples/ 有可直接跑的示例:
node examples/quickstart.mjs
node examples/kline-to-csv.mjs
环境要求
- Node.js ≥ 18(依赖原生
fetch;建议 20 LTS 或更高) - 零运行时依赖
- 示例代码见
examples/:快速上手 / K 线落 CSV / Next.js 服务端
相关
官方 SDK:Python pip install ashareapi · Node.js / TypeScript npm install ashareapi
MCP 服务器:https://api.ashareapi.com/mcp(配置说明)
Agent Skill(给 AI 读的接口说明书):https://ashareapi.com/skill
版本记录
当前版本:0.2.0(2026-10-08)
⚠️ 端点本身永远是最新的(服务端演进,无需升级 SDK)—— 升级只是为了用上新增的便利方法。
完整变更记录 → 包内 CHANGELOG.md · 站内更新日志 · npm 版本历史
License
MIT · 数据仅供研究参考,不构成投资建议