pledge-summary

# 查询所有期股权质押总揽数据 ## 接口说明 | 项目 | 说明 | |----------|----------------------------------------------------------------------------------------------------------------------------| | 接口名称 | 查询所有期股权质押总揽数据 | | 外部接口 | `/api/v1/market/data/pledge/pledge-summary` | | 请求方式 | GET | | 适用场景 | 获取 A 股市场所有报告期的股权质押总揽数据，包括质押公司数量、质押笔数、质押总股数、质押总市值、沪深300指数等信息，支持沪深京股票 | ## 请求参数 本接口无需任何请求参数。 ## 执行方式 通过根目录的 `run.py` 调用（推荐）： ```bash python <RUN_PY> pledge-summary ``` > `<RUN_PY>` 为主 `SKILL.md` 同级的 `run.py` 绝对路径，参见主 SKILL.md 的「调用方式」说明。 ## 响应结构 接口直接返回数组，**不含分页信息**。 ```json [ { "trade_date": "2025-09-30", "pledge_total_ratio": 0, "pledge_company_count": 1234, "pledge_deal_count": 5678, "pledge_total_shares": 1234567890000.0, "pledge_total_market_value": 98765432100000.0, "hs300_index": 3456.78, "hs300_week_change_ratio": 2.34 } ] ``` ### PledgeMarketSummary 字段说明 | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | |---------------------------|--------|------------|-------------------------------------------|------| | trade_date | String | 否 | 报告日期，固定格式为 YYYY-MM-DD | - | | pledge_total_ratio | float | 否 | A 股质押总比例，当前返回 0 | % | | pledge_company_count | int | 否 | 质押公司数量（有质押的上市公司数量） | 家 | | pledge_deal_count | int | 否 | 质押笔数（所有质押交易的总笔数） | 笔 | | pledge_total_shares | float | 否 | 质押总股数（所有质押股票的总股数） | 股 | | pledge_total_market_value | float | 否 | 质押总市值（所有质押股票的总市值） | 元 | | hs300_index | float | 否 | 沪深300指数（报告日期的沪深300指数收盘价） | - | | hs300_week_change_ratio | float | 否 | 沪深300周涨跌幅（与一周前对比的涨跌幅） | % | ## 注意事项 - 本接口无需任何参数，直接请求即可 - 返回值为**数组**，不含 `items` / `total_pages` / `total_items` 等分页包装 - `pledge_total_ratio` 当前接口固定返回 `0` - `pledge_total_shares` 和 `pledge_total_market_value` 原始接口以字符串返回，handler 已转为数值输出