股东户数

holder_number

股东户数（按报告期）

股东与解禁 5 个字段
数据窗口：不传日期时返回最新一个交易日；也可按代码或日期范围过滤。 请求需携带有效 Token，接口地址为 https://api.mquant.com.cn/data/v1。

请求参数 8 项

参数类型说明必填
code 字符串 与 ts_code 等价，支持纯数字代码 可选
end_date 日期 YYYYMMDD 或 YYYY-MM-DD，含当日 可选
fields 字符串 逗号分隔的字段名，缺省返回全部字段 可选
limit 整数 默认 1000，上限由账号单次返回行数决定 可选
offset 整数 用于分页，配合 has_more 使用 可选
start_date 日期 YYYYMMDD 或 YYYY-MM-DD，含当日 可选
trade_date 日期 YYYYMMDD 或 YYYY-MM-DD；与开始/结束日期互斥 可选
ts_code 字符串 支持 600519.SH / 600519，多个用英文逗号分隔，上限 50 个 可选

请求示例

Python · MQData SDK 
from mq_data import MQData

client = MQData(token="你的 Token")
rows = client.holder_number(ts_code="600519.SH")
print(rows)
cURL · HTTP 
curl -X POST https://api.mquant.com.cn/data/v1 \
  -H "X-API-Token: $MQ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"api_name": "holder_number", "params": {"ts_code": "600519.SH"}}'

返回字段 5 个

字段说明类型 / 单位
report_period 报告期 日期 YYYYMMDD
ts_code 股票代码 证券代码（带后缀）
name 名称 原值
holder_count 股东户数 原值
captured_at 快照时间 原值

响应示例

JSON · 标准响应 
{
  "code": 0,
  "msg": null,
  "data": {
    "fields": [
      "report_period",
      "ts_code",
      "name",
      "holder_count"
    ],
    "items": [
      [
        "20260105",
        "600519.SH",
        "示例值",
        "示例值"
      ]
    ],
    "has_more": false
  }
}

错误码

HTTP / code含义处理建议
400参数错误检查参数名、日期格式与日期跨度
401Token 无效确认 Token 完整、未被删除
403Token 无权限或账号停用在控制台检查 Token 状态
429超过配额降低频率，或等待下一分钟 / 次日
503服务暂不可用稍后重试；持续出现请查看服务状态