查询期货会员持仓排名
接口说明
| 项目 |
说明 |
| 接口名称 |
查询期货会员持仓排名 |
| 外部接口 |
GET /api/v2/market/data/member-position-ranking |
| 请求方式 |
GET |
| 适用场景 |
查询指定交易日、交易所、合约及方向的期货会员持仓排名 |
请求参数
| 参数名 |
类型 |
是否必填 |
描述 |
取值示例 |
备注 |
| exchange |
string |
是 |
交易所代码 |
DCE |
SHFE/DCE/CZCE 等 |
| instrument_id |
string |
是 |
合约代码 |
a2605 |
- |
| trade_date |
string |
是 |
交易日 |
20260721 |
YYYYMMDD 或 YYYY-MM-DD |
| direction |
string |
是 |
查询方向 |
long |
long 或 short,也接受常见中文和缩写别名 |
| page |
int |
否 |
页码 |
1 |
默认 1 |
| page_size |
int |
否 |
每页条数 |
50 |
默认 50,最大 200 |
执行方式
# 查某合约某日多头会员排名
python <RUN_PY> member-position-ranking --exchange DCE --instrument_id a2605 --trade_date 20260721 --direction long
# 查空头排名并翻全量
python <RUN_PY> member-position-ranking --exchange SHFE --instrument_id rb2610 --trade_date 20260721 --direction short --all
<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径。
响应结构
返回 code/message/data,记录位于 data.records。
{
"code": 200,
"message": "success",
"data": {
"pageNum": 1, "pageSize": 50, "total": 100, "pages": 2,
"records": [
{
"variety": "a", "code": "a2605", "date": "2026-07-21",
"direction": "long", "broker": "永安期货",
"oi": 10000, "oi_chg": 200, "net_position": 5000
}
]
}
}
records 字段
| 字段 |
类型 |
说明 |
| variety |
string |
品种名称或代码 |
| code |
string |
合约代码 |
| date |
string |
交易日 |
| direction |
string |
持仓方向 |
| broker |
string |
期货会员名称 |
| oi |
int64/null |
持仓量 |
| oi_chg |
int64/null |
持仓量变化 |
| net_position |
int64/null |
净持仓 |
注意事项
exchange/instrument_id/trade_date/direction 四者均为必填。
direction 接受 long/short 及常见中文和缩写别名。
page_size 最大 200。