微盛数海股票数据 API 接口技术白皮书 (V1.0)
💡 开发者提醒： 本页面的示例可直接在浏览器中执行！执行时会自动读取您在页面顶部配置的
注：为保证海量数据的传输效率，系统要求开启 GZIP 压缩。浏览器默认已支持，如果您使用后台语言 (Python/Java/Go) 或
API_KEY。注：为保证海量数据的传输效率，系统要求开启 GZIP 压缩。浏览器默认已支持，如果您使用后台语言 (Python/Java/Go) 或
curl，请确保添加 Accept-Encoding: gzip 请求头。
一、 概述与快速入门
欢迎使用微盛数海量化数据 API。本白皮书旨在为开发者、量化交易员及研究人员提供详尽的接口对接指南。无论是零基础小白还是量化老手都能开箱即用。
- 账号注册: 微信关注公众号“微盛数海”（点此看二维码）， 发送“用户注册”(点此看示意图)，系统将自动回复专属 API_KEY（注册赠送 10,000 次额度）。
- 基础请求网关:
https://claw.wstock.cn/api/v1(认证接口为https://claw.wstock.cn/api/auth) - 公开测试 API_KEY:
ak_5749f92f663c429c9c58f2b9fc23ab23（不用API_KEY，每小时可使用10次，每天可用100次）
数据下载程序
日线/周/月/季度/年线数据下载分钟/小时数据下载
全局调用频率与限制 (公域网络用户)
- 并发频率: 每分钟最多 300 次，每秒最多 5 次。
- 单次请求股票数: 最多允许同时查询 50 只 股票（用逗号分隔）。
- 时间跨度限制: 分钟线单次最多跨越 12 个月；日线单次最多跨越 100 年。
- 数据包大小: 单次返回超过 15MB 将被拒绝，请合理切分时间段。
获取账户信息与剩余额度
在开发下载程序前，建议先调用此接口检查剩余额度（quota_balance）。
GET https://claw.wstock.cn/api/auth/info
二、 核心业务场景实战 (一)：按【市场】下载全量数据
主要用于批量下载特定市场（沪市 SH 或深市 SZ）的全量股票数据。可用时间段：日线自1990年至今；分钟线自2000年至今。
2.1 日线：全市场按天下载 (含盘中最新)
消耗 200次 额度。stime 和 etime 的日期必须完全相同。
GET https://claw.wstock.cn/api/v1/kline?symbol=SZ&freq=daily&stime=2024-03-13&etime=2024-03-13
2.4 财务数据：全市场最新财报
消耗 500次 额度。获取指定市场所有股票最新财报的 18 个核心财务指标。
GET https://claw.wstock.cn/api/v1/financials?symbol=SZ
2.6 股票代码库查询
消耗 20次 额度。按时间获取真实存在的股票代码列表。
date参数格式 请使用 YYYY-MM-DD, YYYYMM, YYYY 或 YYYY-YYYY
GET https://claw.wstock.cn/api/v1/symbols?market=SZ&date=202403
三、 核心业务场景实战 (二)：按【特定股票代码】查询
适用于灵活、精准地获取特定投资标的的数据，支持批量（用逗号拼接）、T+0 盘中最新快照与跨年长周期历史查询。
- 时间切片规则: 日线自动包含截至 23:59:59 数据。分钟线严格按
HH:MM:SS截取。 - URL 编码规范: 请求时，日期与时间之间的空格必须使用
%20转义。
3.1 日线：历史多票查询
查询招商银行和深成指的历史日线数据。
GET https://claw.wstock.cn/api/v1/kline?symbol=SH600036,SZ399001&freq=daily&stime=2010-01-01&etime=2010-01-31
3.2 分钟线：盘中精准截取
获取 10:15:00 到 10:20:01 的5分钟数据（注意 URL 中空格用 %20 代替）。
GET https://claw.wstock.cn/api/v1/kline?symbol=SH600036&freq=5min&stime=2024-03-13%2010:15:00&etime=2024-03-13%2010:20:01
四、 API 接口参数字典详解
| 接口路径 | 核心参数 | 说明 |
|---|---|---|
/kline (K线下载) |
symbol: 必填, 股票代码或市场(SH/SZ)freq: 必填, daily, 5min, 1minstime/etime: 选填, 格式 YYYY-MM-DD [HH:MM:SS]format: 选填, csv(默认) 或 parquet
|
建议 Python 开发者使用 parquet 格式，解析速度快。多日线、30分钟线等需本地合成。 |
/symbols (股票代码库) |
market: SH或SZdate: 时间定位 (天/月/年) |
返回该时间点真实存在的股票代码。date参数格式 请使用 YYYY-MM-DD, YYYYMM, YYYY 或 YYYY-YYYY |
/name (股票简称) |
symbol: 必填, 代码列表或市场代码 |
获取股票简称对照表。 |
/financials (财务数据) |
symbol: 必填, 代码列表或市场代码 |
获取最新财报关键指标。 |
/dividends (权息分红) |
symbol: 必填stime/etime: 选填 |
获取历史所有除权除息记录，用于本地复权计算。 |
五、 计费与额度消耗规则
API 采用计次（额度单元）的计费模式。当免费赠送的 10,000 次耗尽后，将触发免费降级保底（20次/小时，最高200次/天）。
- 按股票日线: 1 年及以内跨度：1 次/股票。超过 1 年：1 次/年/股票。
- 按股票分钟线: 5分钟线(1次/月/股票)；1分钟线(5次/月/股票)。
- 全市场打包 (高性价比):
- 全市场某天日线：200 次/市场
- 全市场某月日线：4000 次/市场
- 全市场某天 5分钟线：1000 次/市场
- 全市场某天 1分钟线：5000 次/市场
六、 错误码对照表
| HTTP 状态 | Code | 错误说明及排查建议 |
|---|---|---|
| 400 | 4001 | 查询跨度超限： 缩短 stime 和 etime 的时间跨度。 |
| 401 | 4007 | 无效的 API_KEY： 未匹配到该秘钥。检查是否多加了空格。 |
| 402 | 4008 | 额度不足： 请充值或等待次日免费配额刷新。 |
| 429 | 4003 | 请求过于频繁： 触发防刷频限制。降低并发或增加 Sleep 延时。 |
| 400 | 40011 | 时间格式错误： 确保格式标准（如中间的空格用 %20）。 |
| 400 | 40030 | 需压缩传输： 请求头必须包含 Accept-Encoding: gzip。 |
七、 常见问题与避坑指南 (FAQ)
Q1：数据是前复权还是后复权？
答：接口提供的均为不复权（真实交易价格）。如需复权，请通过
答：接口提供的均为不复权（真实交易价格）。如需复权，请通过
/dividends 接口下载分红配股数据，在本地自行计算复权因子，此方式能保证量化回测的严谨。
Q2：为什么下载报错
答：99% 的概率是因为请求的
ERROR, Export Interrupted？答：99% 的概率是因为请求的
stime 包含空格但未进行 URL 编码。正确示例：stime=2024-05-20%2010:15:00。
Q3：需要更高频请求限制怎么办？
答：如果公域网关无法满足，机构或高频交易者可关注微信公众号“微盛数海”联系定制。我们将提供独享服务器与带宽，无任何业务限制。
答：如果公域网关无法满足，机构或高频交易者可关注微信公众号“微盛数海”联系定制。我们将提供独享服务器与带宽，无任何业务限制。