微盛数海 股票数据 API 接口

欢迎使用微盛数海API。本文档中的测试密钥仅供演示，不保证额度充足。欢迎自行注册获取独享 API_KEY。

🚀 快速注册获取API_KEY方法

关注微信公众号 微盛数海（点此看二维码），发送消息“用户注册”(点此看示意图)，系统会自动将 API_KEY 发送给您。
福利 注册成功，免费赠送 10000次 使用额度！

⚠️ 整体均衡控制与限制

注1：机构客户如需高频无限制访问，请通过公众号联系我们获取服务器独享定制方案。
注2：合作券商的客户，如需免费访问，请联系您的证券公司客户经理。

• 频率限制：每分钟最多发送 300次，每秒最多发送 5次。
• 数量限制：单次请求最多允许查询 50只 股票（指定单一市场如 SZ/SH 时不受此限，返回全市场数据）。
• 时间跨度：分钟数据单次最多不得超过 12个月；日线数据单次最多不得超过 10年。

数据下载程序

📊 使用额度计次规则

开发程序时，建议先调用获取额度接口，确认额度充足后再进行下载操作。

💻 开发者调用示例

只要修改下面代码中的 URL 和 API KEY，就可以跑通本文档中提到的任何数据下载。

import requests
import pandas as pd
import io

# 您在页面顶部填写的 API KEY 将在此处自动同步更新
API_KEY = "ak_5749f92f663c429c9c58f2b9fc23ab23"
url = f"https://claw.wstock.cn/api/v1/kline?symbol=SZ&freq=daily&stime=2026-03-13&etime=2026-03-13&api_key={API_KEY}"

response = requests.get(url)
if response.status_code == 200:
    # 接口返回的是CSV格式文本，直接用Pandas读取
    df = pd.read_csv(io.StringIO(response.text))
    print(df.head())
else:
    print("获取失败:", response.text)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class WStockApiTest {
    public static void main(String[] args) throws Exception {
        String apiKey = "ak_5749f92f663c429c9c58f2b9fc23ab23";
        String url = "https://claw.wstock.cn/api/v1/kline?symbol=SZ&freq=daily&stime=2026-03-13&etime=2026-03-13&api_key=" + apiKey;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Accept-Encoding", "gzip")
                .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

# 在 Windows Cmd/PowerShell 或 Linux/Mac 终端直接运行：
curl --compressed -o kline_data.csv "https://claw.wstock.cn/api/v1/kline?symbol=SZ&freq=daily&stime=2026-03-13&etime=2026-03-13&api_key=ak_5749f92f663c429c9c58f2b9fc23ab23"

# 运行完毕后，当前目录下会生成 kline_data.csv 文件

第一部分：按市场下载 - 全市场日线数据

可用市场代码：SH (上海)，SZ (深圳)。可用时间段：1990年沪深开市至今。

1. 全市场按天下载 (额度: 200次)

# 返回数据样例:
Code,Date,Open,High,Low,Close,Volume,Amount
SZ000001,2026-03-13 15:00:02,10.93,11.0,10.87,10.93,841939.0,920839000.0
SZ000002,2026-03-13 15:00:02,4.65,4.73,4.64,4.66,1161300.0,544481000.0

2. 全市场按月下载 (额度: 4000次)

第一部分：按市场下载 - 分钟线数据

可用时间段：2000年1月1日至今。当天数据：11:45可下上午数据，15:15可下全天数据。

1. 全市场 5分钟数据 全天下载 (额度: 1000次)

2. 全市场 1分钟数据 全天下载 (额度: 5000次)

第一部分：股票名录、财务与除权息 (全市场)

1. 全市场 代码表查询 (额度: 20次)

date参数格式：某天 `YYYY-MM-DD`，某月 `YYYYMM`，某年 `YYYY`。

2. 全市场 股票简称查询 (额度: 20次)

3. 全市场财务数据 (额度: 500次)

4. 全市场除权除息数据 (额度: 500次)

第二部分：下载盘中最新数据

方法1：无论日线、1分钟、5分钟的盘中最新数据，都支持指定股票代码查询（最多50只，英文逗号分隔）。
方法2、日线盘中最新数据，也支持 全市场 数据下载

日线盘中最新数据，也支持 全市场 数据下载

指定市场：例如 sybmbol=SZ
指定当天日期：stime 、etime的日期必须相同，且是当天
额度消耗：200次
可用时间段：当天盘中最新

Code,Date,Open,High,Low,Close,Volume,Amount
SZ000001,2026-03-13,10.93,11.0,10.87,10.93,841939.0,920839360.0
SZ000002,2026-03-13,4.65,4.73,4.64,4.66,1161300.0,544481470.0

盘中日线 / 分钟线 按股票 下载 最新数据

注意分钟线的时间格式：YYYY-MM-DD HH:MM:SS，URL中空格需替换为 %20。freq参数：daily（日线），5min（5分钟），1min（1分钟）

Code,Date,Open,High,Low,Close,Volume,Amount
SH600036,2026-03-13 10:15:00,39.58,39.6,39.58,39.59,2798.0,11078500.0
SZ399001,2026-03-13 10:15:00,14404.6,14404.6,14393.1,14394.7,3583550.0,5643630000.0

第三部分：按股票代码下载 (支持历史长跨度)

一次最多指定50个股票代码。日线最多一次跨度100年[不限]，分钟线一次最多12个月。

多股票长跨度日线 (额度: 1次/年/股)

第三部分：按股票代码查询 财务与除权息

指定股票 财务数据 (额度: 1次/股)

指定股票 权息数据 (额度: 1次/股)

❓ 常见问题 (FAQ)

1. 可以下载哪些数据？

1990年至今沪深日线、周线、月线；2000年至今的1分钟、5分钟等任意分钟线；最新财报；历年分红除权息数据。

2. 免费用户的额度限制？

注册后立刻赠送 10000次。用完后，目前还支持：每小时20次，每天200次。
如果不使用API_KEY（不推荐），系统凭IP控制：每小时10次，每天100次。

3. 如何获得无限制版本？

如需无限制、独享域名及独立服务器宽带，请在公众号“微盛数海”联系我们，开通机构定制版。如果您是合作券商客户，可咨询您的理财经理是否有免费接入通道。

4. HTTP请求大小有限制吗？

为了保证公域接入用户的整体下载速度，如果单次请求的数据量超过 15MB，接口会拒绝下载。遇到此情况请缩短查询的时间跨度（如stime和etime）。

5. 接口返回的错误码 (Error Codes)

接口返回的错误码 (Error Codes)
当 HTTP 状态码非 200 时，接口会返回标准 JSON 错误格式：{"detail": {"code": 错误码, "msg": "错误说明"}}

HTTP 状态	业务 Code	说明及排查建议
400	4001	查询跨度超过限制：查询的数据时间跨度超过了系统允许的最大年数或月数。 排查建议：请缩短 stime 和 etime 的时间跨度，分批次请求数据。
429	4003	请求过于频繁（IP限流）：触发了基于 IP 的并发限制。 排查建议：请降低代码中的并发请求频率，或在请求间增加延时（Sleep）。
401	4007	无效的 API_KEY：未匹配到该秘钥。 排查建议：请检查 API_KEY 是否填写错误、多加了空格或已失效。
402	4008	剩余额度不足：该 API_KEY 绑定的付费额度已耗尽。 排查建议：请关注微信公众号“微盛数海”充值配额获取更多额度。
500	40010	服务端内部错误。 排查建议：服务端管理员需检查远端数据库运行状态。
400	40011	时间格式不正确：解析时间参数失败。 排查建议：请确保时间参数（如跨度计算）使用标准的 YYYY-MM-DD 格式。
400	40012	股票代码不能为空：传入的 symbol 参数为空串。 排查建议：请检查请求 URL 或参数，确保传入了正确的股票代码。
429	40013	未注册用户今日已达上限：匿名 IP 每日免费调用次数耗尽。 排查建议：请关注微信公众号获取免费 API_KEY，或等待次日零点刷新。
429	40014	未注册用户本小时已达上限：匿名 IP 每小时免费调用次数耗尽。 排查建议：请获取 API_KEY 或等待下一个自然小时重新尝试。
400	40015	股票代码不能为空 (name接口)：获取股票名称时未传代码。 排查建议：检查 symbol 参数传入。
500	40016	数据库查询异常 (name接口)：查询股票名称时数据库报错。 排查建议：服务端管理员需检查 远端数据库 是否正常。
404	40017	未查询到相关财务数据：查不到对应股票的财报。 排查建议：请确认该股票代码是否正确，或该标的是否存在财务数据（如指数无财报）。
500	40018	获取财务数据失败：查询或处理财务数据时发生服务端异常。 排查建议：请联系服务端管理员查看日志。
404	40019	未查询到相关权息数据：查无分红配股记录。 排查建议：确认该股票在指定的 stime 和 etime 之间是否真的发生过分红送转。
500	40020	获取权息数据失败：查询分红数据时发生服务端异常。 排查建议：检查服务端数据库状态。
400	40021	指定单一年度时，freq 请使用 daily。 排查建议：当 date 参数为年份（如2025）时，必须指定或缺省让 freq 保持为 daily。
400	40022	指定年份区间时，freq 请使用 daily。 排查建议：当 date 参数为区间（如1970-2030）时，必须使用 freq=daily。
400	40023	date 参数格式错误：symbols 接口时间格式无法识别。 排查建议：请严格按照规范传入：YYYY-MM-DD, YYYYMM, YYYY 或 YYYY-YYYY。
404	40024	未找到相关数据文件：请求的历史文件在磁盘上不存在。 排查建议：服务端可能尚未准备该月份/年份的底层数据，请检查请求日期范围。
500	40025	解析失败：读取底层数据时发生异常。 排查建议：服务端底层数据文件可能损坏或格式不兼容，需管理员介入。
400	40026	起止时间格式不正确 (kline接口)：K线接口时间解析失败。 排查建议：请确保 stime 和 etime 使用标准的 YYYY-MM-DD HH:MM:SS 格式。
400	40030	数据必须采用压缩传输：请求 CSV 时未开启 GZIP 压缩。 排查建议：请在 HTTP 请求头（Headers）中明确添加 Accept-Encoding: gzip。
400	40031	按市场下载分钟数据请按天下载：K线查询粒度过大拒绝服务。 排查建议：按整个市场（如SH）查询 1min/5min 时，stime 和 etime 必须限制在同一天。
400	40032	按市场下载日线不得跨月：K线市场级日线查询跨度拒绝服务。 排查建议：按整个市场查询日线数据时，开始和结束时间必须在同一个自然月内。
400	40033	单次请求股票数量超限：一次性请求了过多的股票代码（不要超过50只）。 排查建议：请减少单次请求中用逗号分隔的股票数量，分批次请求。
500	40034	数据库查询失败 (symbols接口)：查询最新代码列表时报错。 排查建议：服务端需检查数据库连接。