File contents 查询单票股权质押个股详细信息
接口说明
项目
说明
接口名称
查询单票股权质押个股详细信息
外部接口
/data/api/v1/market/data/pledge/pledge-detail
请求方式
GET
适用场景
获取 A 股上市公司单只股票所有报告期的股权质押详细信息,支持沪深京股票,支持分页查询
请求参数
参数名
类型
是否必填
描述
取值示例
备注
stock_code
string
是
单个股票代码
603323.SH
支持沪深京股票,A股需为6位数字+后缀(SH=上交所,SZ=深交所,BJ=北交所),单次仅支持一个代码
page
int
否
页码,从 1 开始
1
默认值为 1,必须大于等于 1
page_size
int
否
每页记录数
50
默认值为 50,必须大于等于 1
执行方式
通过根目录的 run.py 调用(推荐):
python <RUN_PY> pledge-detail --stock_code 603323.SH
python <RUN_PY> pledge-detail --stock_code 603323.SH --page 2 --page_size 20
<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径,参见主 SKILL.md 的「调用方式」说明。
响应结构
接口返回带分页信息的对象:
{
"items": [
{
"trade_code": "603323.SH",
"stock_name": "苏农银行",
"report_date": "2025-09-30",
"pledge_ratio": 12.34,
"pledge_n": 5,
"pledge_market_value": 98765432.0,
"pledge_unlimitn": 1234.56,
"pledge_limitn": 0.0,
"last_year_fluctuation": -5.67
}
],
"total_pages": 1,
"total_items": 21
}
PledgeStockHolder 字段说明
字段名
类型
是否可为空
说明
单位
trade_code
String
否
股票交易代码,固定携带 .SZ/.SH/.BJ 市场后缀
-
stock_name
String
否
上市公司对应股票名称
-
report_date
String
否
报告日期,固定格式为 YYYY-MM-DD
-
pledge_ratio
float
否
质押比例
%
pledge_n
int
否
质押笔数
笔
pledge_market_value
float
否
质押市值(质押股数 × 报告日期收盘价)
元
pledge_unlimitn
float
否
质押无限售股数
万股
pledge_limitn
float
否
质押限售股数
万股
last_year_fluctuation
float
是
较上年变动(报告日期收盘价与一年前收盘价的涨跌幅),无上年数据时返回 null
%
注意事项
stock_code 为必填参数,单次请求只支持一个股票代码
分页参数 page 和 page_size 均为可选,默认 page=1、page_size=50
返回值包含 items、total_pages、total_items 分页包装
last_year_fluctuation 可为 null(无上年数据时)
1 --- 2 name: pledge-detail 3 description: 查询单票股权质押个股详细信息 4 --- 5 # 查询单票股权质押个股详细信息 6 7 ## 接口说明 8 9 | 项目 | 说明 | 10 |----------|-----------------------------------------------------------------------------------| 11 | 接口名称 | 查询单票股权质押个股详细信息 | 12 | 外部接口 | `/data/api/v1/market/data/pledge/pledge-detail` | 13 | 请求方式 | GET | 14 | 适用场景 | 获取 A 股上市公司单只股票所有报告期的股权质押详细信息,支持沪深京股票,支持分页查询 | 15 16 ## 请求参数 17 18 | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | 19 |------------|--------|----------|-----------------|-----------|------------------------------------------------------------------------------------------| 20 | stock_code | string | 是 | 单个股票代码 | 603323.SH | 支持沪深京股票,A股需为6位数字+后缀(SH=上交所,SZ=深交所,BJ=北交所),单次仅支持一个代码 | 21 | page | int | 否 | 页码,从 1 开始 | 1 | 默认值为 1,必须大于等于 1 | 22 | page_size | int | 否 | 每页记录数 | 50 | 默认值为 50,必须大于等于 1 | 23 24 ## 执行方式 25 26 通过根目录的 `run.py` 调用(推荐): 27 28 ```bash 29 python <RUN_PY> pledge-detail --stock_code 603323.SH 30 python <RUN_PY> pledge-detail --stock_code 603323.SH --page 2 --page_size 20 31 ``` 32 33 > `<RUN_PY>` 为主 `SKILL.md` 同级的 `run.py` 绝对路径,参见主 SKILL.md 的「调用方式」说明。 34 35 ## 响应结构 36 37 接口返回带分页信息的对象: 38 39 ```json 40 { 41 "items": [ 42 { 43 "trade_code": "603323.SH", 44 "stock_name": "苏农银行", 45 "report_date": "2025-09-30", 46 "pledge_ratio": 12.34, 47 "pledge_n": 5, 48 "pledge_market_value": 98765432.0, 49 "pledge_unlimitn": 1234.56, 50 "pledge_limitn": 0.0, 51 "last_year_fluctuation": -5.67 52 } 53 ], 54 "total_pages": 1, 55 "total_items": 21 56 } 57 ``` 58 59 ### PledgeStockHolder 字段说明 60 61 | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | 62 |-----------------------|--------|------------|------------------------------------------------------------------------|------| 63 | trade_code | String | 否 | 股票交易代码,固定携带 .SZ/.SH/.BJ 市场后缀 | - | 64 | stock_name | String | 否 | 上市公司对应股票名称 | - | 65 | report_date | String | 否 | 报告日期,固定格式为 YYYY-MM-DD | - | 66 | pledge_ratio | float | 否 | 质押比例 | % | 67 | pledge_n | int | 否 | 质押笔数 | 笔 | 68 | pledge_market_value | float | 否 | 质押市值(质押股数 × 报告日期收盘价) | 元 | 69 | pledge_unlimitn | float | 否 | 质押无限售股数 | 万股 | 70 | pledge_limitn | float | 否 | 质押限售股数 | 万股 | 71 | last_year_fluctuation | float | 是 | 较上年变动(报告日期收盘价与一年前收盘价的涨跌幅),无上年数据时返回 null | % | 72 73 ## 注意事项 74 75 - `stock_code` 为必填参数,单次请求只支持一个股票代码 76 - 分页参数 `page` 和 `page_size` 均为可选,默认 `page=1`、`page_size=50` 77 - 返回值包含 `items`、`total_pages`、`total_items` 分页包装 78 - `last_year_fluctuation` 可为 null(无上年数据时)
dvcrn/openclaw-skills-marketplace/tree/main/plugins/shawn92--ftshare-holder-data/skills/ftshare-holder-data/sub-skills/pledge-detail commit 3ec98b838f
Frequently asked questions How do I install the Pledge Detail skill? Run npx skillmds@latest add dvcrn/pledge-detail in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Pledge Detail skill do? 查询单票股权质押个股详细信息 It is listed under Coding & Dev Tools on SkillMD.
Is Pledge Detail safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Pledge Detail? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Pledge Detail free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Pledge Detail? dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.