Tushare TypeScript SDK 发布
好长时间没写东西了，今天抽空写一下关于 tushare 的 typescript sdk 的一些使用心得。
一个功能完整的 Tushare Pro 数据接口 TypeScript SDK
文档链接: Tushare TypeScript SDK
目前还在补充开发, 原来用爬虫 + 模板生成一部分, 后面直接用 Copilot(Claude Sonnet 4) 生成。
虽然还加指令去控制生成的质量,所以还能凑合用;
原来自己做一些量化交易, 自己写策略, 自动化交易股票;
觉得还是可以使用 SDK 方便一点. 但是看到刚好缺少 tushare SDK 的封装; 于是动手加 AI 完成;
📊 支持的数据接口
🏭 股票数据 (A-Share Market Data)
| 模块 | 主要接口 | 权限要求 | 说明 |
|---|
| 基础数据 | stock_basic, stock_company, trade_cal, new_share | 120-3000 积分 | 股票列表、公司信息、交易日历、新股上市 |
| 行情数据 | daily, daily_basic, adj_factor, stk_mins | 基础积分-5000 积分 | 日线行情、每日指标、复权因子、分钟数据 |
| 财务数据 | income, balancesheet, cashflow, fina_indicator | 2000-5000 积分 | 利润表、资产负债表、现金流量表、财务指标 |
| 参考数据 | dividend, share_float, stk_holdernumber | 120-5000 积分 | 分红送股、限售股解禁、股东人数 |
| 特色数据 | top_list, top_inst, stk_buyback | 2000-5000 积分 | 龙虎榜、机构交易、股票回购 |
| 融资融券 | margin, margin_detail | 2000 积分起 | 融资融券汇总、明细数据 |
| 资金流向 | moneyflow, moneyflow_hsgt | 2000-5000 积分 | 个股资金流向、沪深港通资金流向 |
| 板块数据 | ths_concept, concept_detail | 2000 积分起 | 概念板块、板块成分股 |
📈 基金数据 (Fund Data)
| 模块 | 主要接口 | 权限要求 | 说明 |
|---|
| ETF 基金 | etf_basic, fund_daily, etf_index | 2000-8000 积分 | ETF 基础信息、行情数据、基准指数 |
📊 指数数据 (Index Data)
| 模块 | 主要接口 | 权限要求 | 说明 |
|---|
| 指数 | ths_index | 2000 积分起 | 同花顺指数数据 |
🌏 其他市场数据
| 市场 | 状态 | 说明 |
|---|
| 港股数据 | ✅ 已支持 | 港股行情、沪深港通、中央结算系统持股 |
| 期货数据 | 🚧 开发中 | 期货合约、行情、持仓数据 |
| 期权数据 | 🚧 开发中 | 期权合约、行情、希腊字母 |
| 债券数据 | 🚧 开发中 | 债券基础信息、行情、评级 |
| 外汇数据 | 🚧 开发中 | 汇率、央行数据 |
| 美股数据 | 🚧 开发中 | 美股基础信息、行情 |
🤖 AI 数据 (大模型语料)
| 接口 | 权限要求 | 说明 |
|---|
| anns_d | 单独权限 | 上市公司公告 |
| cctv_news | 单独权限 | 新闻联播文字稿 |
| major_news | 单独权限 | 新闻通讯长篇 |
| news | 单独权限 | 新闻快讯 |
| irm_qa_sh | 120 积分试用/10000 积分正式 | 上证 e 互动问答 |
| irm_qa_sz | 120 积分试用/10000 积分正式 | 深交所互动易问答 |
🚀 快速开始
安装
1
2
3
4
5
| npm install @zhaots/tushare-core
yarn add @zhaots/tushare-core
pnpm add @zhaots/tushare-core
|
基本使用
获取积分的方法：
- 注册 Tushare 账号
- 完成邮箱验证和个人认证
- 通过社区贡献、邀请用户等方式获取积分
- 详见：积分获取办法
首先设置你的 Tushare Token 环境变量：
1
2
3
4
5
|
export TUSHARE_TOKEN=your_tushare_token
echo "TUSHARE_TOKEN=your_tushare_token" > .env
|
然后就可以直接使用 API：
1
2
3
4
5
6
7
8
9
10
11
12
13
| import { getStockBasicApi, getDailyApi } from "@zhaots/tushare-core";
const stockList = await getStockBasicApi({
list_status: "L",
});
const dailyData = await getDailyApi({
ts_code: "000001.SZ",
start_date: "20240101",
end_date: "20240131",
});
|
后续
- 有时间再补充一些使用示例和注意事项。
- 封装成 MCP 或者成套策略的 MCP 模式;
⭐ 如果这个项目对您有帮助，请给我们一个 Star！
Made with ❤️ by zhao-core 联系: email
