ARK 基金持倉列表
GET/api/v1.0/quote/ark-fund-holdingARK 基金持倉列表(全部 ARK ETF 合計)。按持倉/增持/減持/建倉/清倉分類,支持近 1/5/10/30/60 日週期(持倉分類忽略週期)。 返回 data.items[]:標的代碼/名稱、持倉數量與變動、市值(美元)、佔比與佔比變動(百分數);pagination 含 total / completed / page_flag。 機構持股請用 quote.shareholders_institutional;評級請用 quote.research_rating_summary。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
holding_type | string | 查詢 | 否 | 持倉分類。POSITION=持倉(默認)/ INCREASE=增持 / DECREASE=減持 / NEW=建倉 / SOLD_OUT=清倉 |
cycle_type | string | 查詢 | 否 | 變動週期,默認 ONE_DAY。holding_type=POSITION 時忽略。ONE_DAY=近1天 / FIVE_DAY=近5天 / TEN_DAY=近10天 / THIRTY_DAY=近30天 / SIXTY_DAY=近60天 |
sort_field | string | 查詢 | 否 | 排序字段,默認 SHARES。SHARES=持倉數量 / WEIGHT_CHANGE=佔比變動 / SHARES_CHANGE=持倉變動 / MARKET_VALUE=市值 / WEIGHT=ETF佔比 |
sort_dir | string | 查詢 | 否 | 排序方向。DESCENDING=降序(默認)/ ASCENDING=升序 |
page_size | int | 查詢 | 否 | 每頁條數,默認 20,最大 200 |
page_flag | string | 查詢 | 否 | 翻頁標記。首頁不傳或傳空串;下一頁回傳上一頁響應 pagination.page_flag。只有 pagination.completed 為 true 時停止 |
fund | string | 查詢 | 否 | ARK ETF 代碼,例: US.ARKK / US.ARKW / US.ARKG / US.ARKQ / US.ARKF / US.ARKX;空=全部 ARK 基金合計 |
請求示例
bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/ark-fund-holding' \
-H 'Authorization: Bearer <AccessToken>' | jq響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
data.items | object[] | |
data.items[].code | string | 標的代碼,例: US.TSLA;stock_id=0 時回退 ticker |
data.items[].name | string | 標的名稱 |
data.items[].shares | string | 持倉數量 |
data.items[].shares_change | string | 持倉數量變動 |
data.items[].market_value | string | 持倉市值(美元) |
data.items[].weight | number | 持倉佔比(百分數,12.34 表示 12.34%) |
data.items[].weight_change | number | 持倉佔比變動(百分數) |
pagination.completed | bool | 是否已到末頁。只有 true 時停止翻頁 |
pagination.page_flag | string | 下一頁標記。completed 為 false 時回傳為下一次請求的 page_flag;末頁為空串 |
錯誤碼
| ret_code | error.code | 說明 |
|---|---|---|
| 0 | — | 成功 |
| -3 | invalid_parameter | 參數不合法 |
| -8 | unsupported | 不支持 |
| -10 | no_data | 沒有數據 |
響應示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"items": [
{
"code": "US.AAPL",
"name": "example",
"shares": "example",
"shares_change": "example",
"market_value": "example",
"weight": 1.2,
"weight_change": 1.2
}
]
},
"pagination": {
"page_flag": "",
"completed": true
}
}