stock-share

name	stock-share
description	获取单票指定日期股本信息。当用户需要查询某只 A 股股票在某日的总股本、A 股流通/限售/无限售股本、B 股股本、H 股股本、境外上市股本等股本快照时使用。

获取单票指定日期股本信息

接口说明

项目	说明
接口名称	获取单票指定日期股本信息
外部接口	/api/v1/market/data/share/get-stock-share
请求方式	GET
适用场景	按日期快照查询单票股本结构

请求参数

参数名	类型	是否必填	描述	取值示例	备注
stock_code	string	是	单个股票代码	000001.SZ	支持 6 位数字+后缀（SH/SZ/BJ）
date	string	是	日期 YYYYMMDD	20260716	按指定日期快照查询

执行方式

通过根目录的 run.py 调用（推荐）：

python <RUN_PY> stock-share --stock_code 000001.SZ --date 20260716

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

响应结构

返回分页结构（items/total_pages/total_items），命中时仅返回 1 条；未命中 items 为空数组。

{
    "items": [
        {
            "stock_code": "000001.SZ",
            "stock_name": "平安银行",
            "totshare_num": "19405918198",
            "ashare_circ_num": "19405918198",
            "ashare_circ_limit_num": "317545",
            "ashare_circ_unlimit_num": "19405600653",
            "bshare_num": "0",
            "bshare_circ_num": "0",
            "bshare_uncirc_num": "0",
            "hshare_num": "0",
            "osshare_num": "0",
            "share_circ_num": "19405918198"
        }
    ],
    "total_pages": 1,
    "total_items": 1
}

顶层字段说明

字段名	类型	是否可为空	说明
items	Array	否	股本信息列表
total_pages	int	否	总页数
total_items	int	否	总记录数

items 元素字段

字段名	类型	是否可为空	说明
stock_code	string	否	股票代码
stock_name	string	否	股票名称
totshare_num	string	否	总股本
ashare_circ_num	string	否	A 股流通股本
ashare_circ_limit_num	string	否	A 股限售流通股本
ashare_circ_unlimit_num	string	否	A 股无限售流通股本
bshare_num	string	否	B 股股本
bshare_circ_num	string	否	B 股流通股本
bshare_uncirc_num	string	否	B 股非流通股本
hshare_num	string	否	H 股股本
osshare_num	string	否	境外上市股本
share_circ_num	string	否	流通股本合计

注意事项

• stock_code 与 date 均必填，date 格式 YYYYMMDD。
• 未命中数据时 items 为空数组。
• 金额/股数字段以字符串返回，保持精度。