查询期货会员持仓排名
接口说明
| 项目 | 说明 |
|---|---|
| 接口名称 | 查询期货会员持仓排名 |
| 外部接口 | 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。