股东持股明细查询¶

来源同步：/Users/mac/Projects/chatgpt-codex/doc/api_Shareholder.md

所属接口集：股东持股

请求 URL¶

GET /v1/api/shareholder/holding-detail

认证方式¶

Bearer Token（详见认证与签名）

接口概述¶

查询股东持股明细数据，支持按股票代码、持有人名称、持有人类型、报告期、公告日期区间等多维度过滤，并提供分页和排序。

请求参数¶

参数	类型	必填	说明
stock_code	string	否	股票代码，如 `600519`，自动取后 6 位数字补零
holder_name	string	否	持有人名称，模糊匹配（icontains）
holder_type	string	否	持有人类型，精确匹配
report_period	string	否	报告期，格式 YYYY-MM-DD 或 YYYYMMDD
ann_date_from	string	否	公告日期起始，格式 YYYY-MM-DD 或 YYYYMMDD
ann_date_to	string	否	公告日期截止，格式 YYYY-MM-DD 或 YYYYMMDD
order	string	否	排序方向，`asc` 或 `desc`，默认 `desc`（按公告日期降序）
page	int	否	页码，默认 1
page_size	int	否	每页数量，默认 100，最大 500

接口说明¶

排序逻辑：先按公告日期（ann_date）排序，再按 stock_code、holder_rank、id 升序
日期参数支持 YYYY-MM-DD 和 YYYYMMDD 两种格式

响应格式示例¶

{
  "data": {
    "items": [
      {
        "id": 1,
        "holder_name": "中国贵州茅台酒厂（集团）有限责任公司",
        "holder_type": "国有法人",
        "holder_rank": 1,
        "stock_code": "600519",
        "stock_name": "贵州茅台",
        "report_period": "2025-09-30",
        "shares_qty": 641823200,
        "holding_ratio": 51.09,
        "change_shares": 0,
        "change_ratio": 0.0,
        "change_type": "不变",
        "free_float_mkt_value": 1200000000000.0,
        "ann_date": "2025-10-28",
        "updated_at": "2025-10-28T12:00:00"
      }
    ],
    "page": 1,
    "page_size": 100,
    "total": 1,
    "total_pages": 1
  }
}

返回状态¶

状态码	说明
200	成功
401	未认证
403	无权限