stock-share-chg

查询 A 股股东增减持明细。当用户需要获取 A 股股东增减持数据(按 stock_code 分页查询全部历史,或以 is_last=true 查全市场最新一期),支持沪深京股票时使用。

SKILL.md

GitHub

查询 A 股股东增减持

接口说明

项目 说明
接口名称 查询 A 股股东增减持
外部接口 /api/v1/market/data/holder/stock-share-chg
请求方式 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
page_size int 否 每页记录数 50 默认 50

执行方式

通过根目录的 run.py 调用(推荐):

python <RUN_PY> stock-share-chg --stock_code 603323.SH
python <RUN_PY> stock-share-chg --stock_code 603323.SH --page 2 --page_size 20
python <RUN_PY> stock-share-chg --is_last --page 1 --page_size 50

<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径。

响应结构

{
    "items": [
        {
            "trade_code": "000001",
            "stock_name": "平安银行",
            "holder_name": "张某某",
            "shareholding_change_info": "增持",
            "change_quantity": "30000",
            "pre_change_quantity": "0",
            "pre_change_total_capital_ratio": null,
            "post_change_quantity": "30000",
            "post_change_total_capital_ratio": null,
            "transfer_method": null,
            "latest_price": "18.45",
            "price_change_rate": "0",
            "transaction_price": null,
            "transaction_amount": null,
            "progress_description": null,
            "change_start_date": "2021-09-06",
            "change_end_date": "2021-09-06",
            "announcement_date": "2021-09-07"
        }
    ],
    "total_pages": 1,
    "total_items": 11036
}

items 元素字段

字段名 类型 是否可为空 说明
trade_code String 否 股票交易代码,6 位数字
stock_name String 否 上市公司官方简称
holder_name String 否 持股变动主体(股东名称)
shareholding_change_info String 否 持股变动类型:增持/减持
change_quantity string 否 持股变动数量
pre_change_quantity string 否 变动前持股数量
pre_change_total_capital_ratio String 是 变动前持股占总股本比例(暂空)
post_change_quantity string 否 变动后持股数量
post_change_total_capital_ratio String 是 变动后持股占总股本比例(暂空)
transfer_method String 是 股份转让方式(暂空)
latest_price string 否 股票最新价
price_change_rate string 否 股票涨跌幅
transaction_price String 是 股份交易价格(暂空)
transaction_amount String 是 股份交易金额(暂空)
progress_description String 是 持股变动进展说明(暂空)
change_start_date String 否 变动开始日期 YYYY-MM-DD
change_end_date String 否 变动截止日期 YYYY-MM-DD
announcement_date String 否 公告发布日期 YYYY-MM-DD

注意事项

  • 必须至少指定 --stock_code 或 --is_last 其一。
  • shareholding_change_info 仅为「增持」「减持」两种取值。
  • pre_change_total_capital_ratio/post_change_total_capital_ratio/transfer_method/transaction_price/transaction_amount/progress_description 当前接口均暂为空值。
  • is_last 在 query string 中传字符串 "true"。