القائمة
查询 A 股股东人数。当用户需要获取 A 股股东人数信息（按 stock_code 查全部历史，或以 is_last=true 查全市场最新一期），含人均流通股、筹码集中度、十大股东持股比例等衍生指标时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | stock-holder-nums |
| description | 查询 A 股股东人数。当用户需要获取 A 股股东人数信息（按 stock_code 查全部历史，或以 is_last=true 查全市场最新一期），含人均流通股、筹码集中度、十大股东持股比例等衍生指标时使用。 |
| 项目 | 说明 |
|---|---|
| 接口名称 | 查询 A 股股东人数 |
| 外部接口 | /api/v1/market/data/holder/stock-holder-nums |
| 请求方式 | GET |
| 适用场景 | 指定 stock_code 查全部历史股东人数，或 is_last=true 查全市场最新一期 |
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|---|---|---|---|---|---|
| stock_code | string | 否 | 单个股票代码 | 603323.SH | 不传时需配合 --is_last；支持沪深京 A 股，需 6 位数字+后缀（SH/SZ/BJ），单次仅支持一个代码 |
| is_last | flag | 否 | 取所有标的最新一期 | （flag） | 传字符串 "true"；与 stock_code 二选一 |
| page | int | 否 | 页码 | 1 | 默认 1，仅 is_last=true 模式下生效 |
| page_size | int | 否 | 每页记录数 | 50 | 默认 50 |
通过根目录的 run.py 调用（推荐）：
python <RUN_PY> stock-holder-nums --stock_code 603323.SH
python <RUN_PY> stock-holder-nums --is_last --page 1 --page_size 50
<RUN_PY>为主SKILL.md同级的run.py绝对路径。
{
"items": [
{
"stock_code": "000001.SZ",
"stock_name": "平安银行",
"publish_date": "2026-04-29",
"report_date": "2026-03-31",
"holder_num": 11215,
"holder_num_change_ratio": -5.5022,
"per_capita_circ_share": 4895.6833,
"per_capita_share_change_ratio": null,
"chip_concentration": null,
"close_price": "0",
"per_capita_hold_amount": "0",
"ten_holder_ratio": null,
"ften_holder_ratio": null
}
],
"total_pages": 1,
"total_items": 5784
}
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|---|---|---|
| items | Array | 否 | 股东人数列表 |
| total_pages | int | 否 | 总页数 |
| total_items | int | 否 | 总记录数 |
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|---|---|---|
| stock_code | string | 否 | 股票代码 |
| stock_name | string | 否 | 股票名称 |
| publish_date | string | 否 | 发布日期 |
| report_date | string | 否 | 报告期 |
| holder_num | int | 否 | 股东人数 |
| holder_num_change_ratio | string | 是 | 股东人数较上期变化比例 |
| per_capita_circ_share | string | 是 | 人均流通股数 |
| per_capita_share_change_ratio | string | 是 | 人均流通股变化比例 |
| chip_concentration | string | 是 | 筹码集中度 |
| close_price | string | 否 | 收盘价 |
| per_capita_hold_amount | string | 否 | 人均持股金额 |
| ten_holder_ratio | string | 是 | 十大股东持股比例 |
| ften_holder_ratio | string | 是 | 十大流通股东持股比例 |
--stock_code 或 --is_last 其一。chip_concentration/ten_holder_ratio/ften_holder_ratio 等字段部分标的暂为空。is_last 在 query string 中传字符串 "true"。非凸科技金融数据技能集。覆盖 A 股股票列表、全字段/实时行情列表、分时价格、IPO、大宗交易、融资融券、单股行情估值、可转债、ETF、基金、指数（含分页指数描述、下载描述 PDF、权重汇总/成份明细、下载权重 xlsx、详情/K 线/分时）、宏观经济，以及港股公司介绍/估值分析/基础视图/K线、东财美股列表/历史K线/最新行情、native 美股基础信息/利润表/现金流量表/资产负债表、港股财报三表(利润/现金流/资产负债)/东财港股指数日K线等接口（market.ft.tech / ftai.chat）。用户询问 A 股、港股、美股的代码、行情、估值、K线、指数权重/描述、新闻与宏观数据时使用。
按日期范围查询财经日历（market.ft.tech），含华尔街见闻与百度财经日历数据（宏观数据、IPO、财报时间、交易提醒等）。用户问财经日历、经济事件、IPO 日程、财报时间、交易提醒时使用。
查询所有期股权质押总揽数据。当用户需要获取 A 股市场所有报告期的股权质押总揽数据，包括质押公司数量、质押笔数、质押总股数、质押总市值、沪深300指数等信息，支持沪深京股票，或了解所有期股权质押总揽数据时使用。
批量获取多只可转债 K 线 POST 接口（market.ft.tech，convertible-bond-candlesticks/batch）。用户问多只可转债的 K 线、批量可转债日 K/周 K/月 K/年 K 时使用。必填 --symbols、--interval-unit、--until-ts-millis；可选 --interval-value、--adjust-kind、--since-ts-millis、--limit。
单只可转债历史 K 线 POST 接口（market.ft.tech，convertible-bond-candlesticks）。用户问某只可转债的分/日/周/月/年 K 线、开高低收、前/后复权、分钟级 K 线时使用。必填 --symbol、--interval-unit、--until-ts-millis；可选 --interval-value、--adjust-kind、--since-ts-millis、--limit。
批量获取多只 ETF 历史 K 线 POST 接口（market.ft.tech，etf-candlesticks/batch）。用户问多只 ETF 的 K 线、批量 ETF 日 K/周 K/月 K/年 K、510300 和 159915 一起的 K 线时使用。必填 --symbols、--interval-unit、--until-ts-millis；可选 --interval-value、--adjust-kind、--since-ts-millis、--limit。