期货 CFTC 持仓分析
GET/api/v1.0/quote/{symbol}/future/position-analysis获取期货 CFTC 持仓分析。 report_type 指定报告类别，默认 TOTAL（合计）。按报告日倒序，page_flag 为下一页起始下标。 持仓张数为整数；报告时间为 Unix 秒。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 期货代码（路径参数），例: US.CLmain / US.GCmain |
report_type | string | 查询 | 否 | 报告类别。TOTAL=合计（默认），PRODUCER=生产贸易商，SWAP=互换，M_MONEY=资管，OTHER=其他大户，NON_REPORT=非报告，TOTAL_POSITION=总持仓，DEALER=经纪商，ASSET_MGR=资产机构，LEV_MONEY=杠杆基金 |
page_size | int | 查询 | 否 | 每页条数，默认 20，最大 100 |
page_flag | string | 查询 | 否 | 翻页标记。首页不传；下一页回传 pagination.page_flag |
请求示例
bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/future/position-analysis?report_type=1&page_size=1&page_flag=1' \
-H 'Authorization: Bearer <AccessToken>' | jq响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
data.items | object[] | |
data.total | integer | 符合条件的总条数 |
data.items[].report_time | integer | 报告日（Unix 秒） |
data.items[].variety | integer | 期货品种名称 |
data.items[].long | integer | 多头持仓 |
data.items[].short | integer | 空头持仓 |
data.items[].spread | integer | 套利持仓 |
data.items[].net | integer | 多空净持仓 |
data.items[].net_change_weekly | integer | 净持仓周变化 |
data.items[].open_interest | integer | 未平仓总合约量 |
data.items[].open_interest_change_weekly | integer | 未平仓周变化 |
data.items[].open_interest_change_rate_weekly | string | 未平仓周变化率百分数 |
pagination.completed | string | 是否已到末页 |
pagination.page_flag | string | 下一页起始下标。completed 为 true 时为空串 |
错误码
| ret_code | error.code | 说明 |
|---|---|---|
| 0 | — | 成功 |
| -3 | invalid_parameter | 参数缺失或不在允许范围内 |
| -7 | invalid_symbol | 标的不存在 |
| -8 | unsupported | 市场或品类不支持 |
| -9 | permission_denied | 没有对应权限 |
| -10 | no_data | 没有可返回的数据 |
| -11 | rate_limited | 调用过于频繁 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"total": "example",
"items": [
{
"report_time": 0,
"variety": 0,
"long": 0,
"short": 0,
"spread": 0,
"net": 0
}
]
},
"pagination": {
"completed": true,
"page_flag": ""
}
}