期貨 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": ""
}
}