margin-trading-details

# 获取融资融券明细 ## 接口说明 | 项目 | 说明 | |---|---| | 接口名称 | 获取融资融券明细（margin_trading_details） | | 外部接口 | `/api/v1/market/data/margin-trading-details` | | 请求方式 | GET | | 适用场景 | 按交易日查询 A 股两融快照（每标的一行）：单日查询、指定标的的交易日区间查询、默认前一交易日快照 | ## 请求参数 | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |---|---|---|---|---|---| | `--date` | str | 否 | 单日查询日期 | `20260623` | 格式 `YYYYMMDD`，必须为交易日；不传返回前一交易日快照 | | `--start-date` | str | 否 | 区间查询开始日期 | `20260601` | 须与 `--end-date`、`--stock` **同时提供**；跨度不超过 3 年 | | `--end-date` | str | 否 | 区间查询结束日期 | `20260623` | 须与 `--start-date`、`--stock` 同时提供；开始须早于结束 | | `--stock` | str | 否 | 标的代码过滤 | `600000.SH` | 单日/默认查询时可选；区间查询时必填 | | `--page` | int | 否 | 页码，从 1 开始 | `1` | 默认 1 | | `--page_size` | int | 否 | 每页记录数 | `20` | 默认 20，最大 1000 | | `--all` | - | 否 | 自动翻页获取全量数据 | - | 合并 `data.records` 输出 | ## 执行方式 ```bash # 默认：前一交易日快照 python <RUN_PY> margin-trading-details --page 1 --page_size 20 # 指定交易日 python <RUN_PY> margin-trading-details --date 20260623 --page 1 --page_size 20 # 单日 + 标的过滤 python <RUN_PY> margin-trading-details --date 20260623 --stock 600000.SH # 区间查询：start_date、end_date、stock 必须同时提供 python <RUN_PY> margin-trading-details --start-date 20260601 --end-date 20260623 --stock 600000.SH # 自动翻页获取全量数据 python <RUN_PY> margin-trading-details --date 20260623 --all ``` > `<RUN_PY>` 为主 `SKILL.md` 同级的 `run.py` 绝对路径，参见主 SKILL.md 的「调用方式」说明。 ## 响应结构 外层为 `code`（成功 200）/ `message` / `data`；分页信息与记录位于 `data`： ```json { "code": 200, "message": "success", "data": { "pageNum": 1, "pageSize": 20, "total": 4443, "pages": 223, "records": [ { "date": "2026-06-16", "margin_trading_balance": 13197538116, "margin_trading_buying_amount": 3827217410, "margin_trading_repayment_amount": 874371294, "securities_lending_balance_volume": 143377, "securities_lending_repayment_volume": 25800, "securities_lending_selling_volume": 34500, "total_balance": 13233247592, "symbol": "002384.SZ", "symbol_name": "合力泰" } ] } } ``` ### records 元素字段说明 | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | |---|---|---|---|---| | `date` | String | 否 | 交易日期，格式 `YYYY-MM-DD` | - | | `symbol` | String | 否 | 标的代码，短市场后缀（`600000.SH`、`000001.SZ`、`920178.BJ`） | - | | `symbol_name` | String | 是 | 标的名称 | - | | `margin_trading_balance` | int | 是 | 融资余额 | 元 | | `margin_trading_buying_amount` | int | 是 | 融资买入额 | 元 | | `margin_trading_repayment_amount` | int | 是 | 融资偿还额 | 元 | | `securities_lending_balance_volume` | int | 是 | 融券余量 | 股 | | `securities_lending_repayment_volume` | number | 是 | 融券偿还量 | 股 | | `securities_lending_selling_volume` | int | 是 | 融券卖出量 | 股 | | `total_balance` | int | 是 | 融资融券余额 | 元 | ## 注意事项 - `--date` 不能与 `--start-date`/`--end-date` 同时使用；区间查询必须三参数（含 `--stock`）齐全，否则本地校验直接退出。 - 区间包含首尾交易日，自动忽略非交易日；跨度不能超过 3 年。 - `--stock` 支持与响应代码等价的格式（`600000.SH`、`600000.XSHG`、`600000`）；响应 `symbol` 统一为短市场后缀。 - 金额字段单位为**元**，量字段单位为**股**，无值时为 `null`。 - 如需全量数据，使用 `--all` 自动翻页合并，或按 `--page` 递增循环至 `data.pages`。