获取融资融券明细
接口说明
| 项目 |
说明 |
| 接口名称 |
获取融资融券明细(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 输出 |
执行方式
# 默认:前一交易日快照
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:
{
"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。