margin-trading-details

# 获取融资融券明细 ## 接口说明 | 项目 | 说明 | |---|---| | 接口名称 | 获取融资融券明细 | | 外部接口 | `/api/v1/market/data/margin-trading-details` | | 请求方式 | GET / POST | | 适用场景 | 获取 A 股融资融券明细列表，按融资净买入额降序排列，支持分页查询 | ## 请求参数 | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |---|---|---|---|---|---| | `page` | int | 是 | 页码，从 1 开始 | `1` | 必须大于等于 1 | | `page_size` | int | 是 | 每页记录数 | `20` | 必须大于等于 1，建议不超过 100 | ## 执行方式 通过根目录的 `run.py` 调用（推荐）： ```bash # 获取第 1 页，每页 20 条 python <RUN_PY> margin-trading-details --page 1 --page_size 20 # 指定分页参数 python <RUN_PY> margin-trading-details --page 2 --page_size 50 # 自动翻页获取全量数据 python <RUN_PY> margin-trading-details --all ``` > `<RUN_PY>` 为主 `SKILL.md` 同级的 `run.py` 绝对路径，参见主 SKILL.md 的「调用方式」说明。 ## 响应结构 ```json { "items": [ { "date": "2026-03-09", "margin_trading_balance": 2440891073, "margin_trading_buying_amount": 1423221922, "margin_trading_repayment_amount": 874371294, "securities_lending_balance_volume": 409500, "securities_lending_repayment_volume": 25800, "securities_lending_selling_volume": 34500, "total_balance": 2453438153, "symbol": "600989.SH", "symbol_name": "宝丰能源" } ], "total_pages": 99, "total_items": 1970 } ``` ### 顶层字段说明 | 字段名 | 类型 | 是否可为空 | 说明 | |---|---|---|---| | `items` | Array | 否 | 当前页融资融券明细列表 | | `total_pages` | int | 否 | 总页数 | | `total_items` | int | 否 | 总记录数（未分页前） | ### items 元素字段说明（MarginTradingDetail） | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | |---|---|---|---|---| | `date` | String | 否 | 交易日期，格式 `YYYY-MM-DD` | - | | `margin_trading_balance` | int | 否 | 融资余额 | 元 | | `margin_trading_buying_amount` | int | 否 | 融资买入额 | 元 | | `margin_trading_repayment_amount` | int | 否 | 融资偿还额 | 元 | | `securities_lending_balance_volume` | int | 否 | 融券余量 | 股 | | `securities_lending_repayment_volume` | int | 否 | 融券偿还量 | 股 | | `securities_lending_selling_volume` | int | 否 | 融券卖出量 | 股 | | `total_balance` | int | 否 | 融资融券余额 | 元 | | `symbol` | String | 否 | 标的代码，带市场后缀 | - | | `symbol_name` | String | 否 | 标的名称 | - | ## 注意事项 - `page` 和 `page_size` 为必填项 - 返回结果已按**融资净买入额**（`margin_trading_buying_amount - margin_trading_repayment_amount`）降序排列，无需客户端再排序 - 如需全量数据，使用 `--all` 参数自动翻页合并，或按 `page` 递增循环至 `total_pages` - 金额字段单位为**元**，展示时可按需转换为万元或亿元