ashareapi — A股数据 API 官方 Node.js / TypeScript SDK
行情 / K线 / 财务 / 资金 / 龙虎榜 / 板块 / 因子选股 / 量化回测 —— 40 个端点,免费端点无需注册。
零运行时依赖(用 Node 原生 fetch),自带 TypeScript 类型。
Усильте агента
Собственная команда издателя. Не эндпоинт PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]У Claude Code нет ссылки для установки локальной команды. Скопируйте команду ниже и выполните её в терминале.
claude mcp add ashareapi -- npx -y ashareapi@0.2.0Выполните в терминале.
{ "mcpServers": { "ashareapi": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
Удалённый URL или команда на вашем компьютере? Чем различаются два способа установки
Запустить на PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
Запуск中文 · 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 起)。
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 都行
fetch —— 安装快、无供应链风险(Python 版还需要 requests)quote / kline / hot / market-overview / changedist 直接调,无需注册sh600667 / 600667.SH / 600667 都认marketOverview() 与 market_overview() 是同一个方法(Python 版用户零摩擦迁移)adjust 参数),不会二次复权AuthError / RateLimitError / UpstreamError / EmptyResultError(无数据 ≠ 失败)—— 每类都告诉你该做什么.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;
}
除了 Node SDK,我们还提供两种 AI Agent 接入方式:
https://api.ashareapi.com/mcp
(⚠️ 填这个接口地址;站点介绍页 ashareapi.com/mcp 不是接口)免费工具/端点无需 Key;付费工具在请求头带
Authorization: Bearer <你的 Key>。
仓里 examples/ 有可直接跑的示例:
node examples/quickstart.mjs
node examples/kline-to-csv.mjs
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)—— 升级只是为了用上新增的便利方法。
MIT · 数据仅供研究参考,不构成投资建议
A股数据 API 官方 Node.js / TypeScript SDK —— 行情 / K线 / 分时 / 财务 / 资金 / 龙虎榜 / 板块 / 因子选股 / 量化回测(40 端点,免费端点无需 Key)
{ "mcpServers": { "ashareapi": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Инструменты
Списка инструментов пока нет. У удалённых серверов он появляется после первой проверки состояния.
FAQ
Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
В этой записи не указано обязательных переменных окружения.
Ashareapi работает локально через stdio.
Последняя проверка: 2026-11-05. A股数据 API 官方 Node.js / TypeScript SDK —— 行情 / K线 / 分时 / 财务 / 资金 / 龙虎榜 / 板块 / 因子选股 / 量化回测(40 端点,免费端点无需 Key)