股东户数

本页定义目标 API，实际数据查询服务尚未实现。示例仅用于表达请求和响应格式。

数据产品标识：stock.shareholder_counts 证券对象标识示例：000001.SZ

接口名称

获取股东户数

接口说明

股东户数及其期间变化观察。

请求参数

参数名	类型	必填	说明
security_code	string	否	筛选一个或多个证券代码。
market	string	否	市场代码；中文客户端默认 CN。
start_date	date	否	查询开始日期，包含该日。
end_date	date	否	查询结束日期，包含该日。

返回字段

字段名	中文名称	类型	是否可空	字段说明
security_code	证券代码	string	否	带市场后缀的 BuQuant 证券代码。
announcement_date	公告日期	date	是	公告日期
reporting_period_end	报告期	date	否	财务报告或持仓报告覆盖期间的结束日期。
shareholder_count	股东户数	integer	是	股东户数

请求示例

{
  "dataset_id": "stock.shareholder_counts",
  "select": [
    "security_code",
    "announcement_date",
    "reporting_period_end",
    "shareholder_count"
  ],
  "where": [
    {
      "field": "security_code",
      "op": "eq",
      "value": "000001.SZ"
    },
    {
      "field": "market",
      "op": "eq",
      "value": "CN"
    },
    {
      "field": "reporting_period_end",
      "op": "gte",
      "value": "2026-01-01"
    },
    {
      "field": "reporting_period_end",
      "op": "lte",
      "value": "2026-08-10"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例

{
  "dataset_id": "stock.shareholder_counts",
  "fields": [
    "security_code",
    "announcement_date",
    "reporting_period_end",
    "shareholder_count"
  ],
  "data": [
    {
      "security_code": "000001.SZ",
      "announcement_date": "2026-08-01",
      "reporting_period_end": "2026-06-30",
      "shareholder_count": 0
    }
  ],
  "page": {
    "next_cursor": null,
    "complete": true
  }
}