ARK 主動交易明細
GET/api/v1.0/quote/ark-active-transaction-queryARK 主動交易明細(含披露日與收盤價)。可按標的 / 基金過濾;kline_based=true 時按 K 線交易日補齊無成交日的收盤價。 count 默認 50、最大 200。聚合榜(無收盤價)請用 quote.ark_active_transaction。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
holding_type | string | 查詢 | 否 | 變動類型,默認 ALL。服務端該接口語義為全部/買入/賣出;NEW / SOLD_OUT 按同一枚舉原樣傳入 |
sort_field | string | 查詢 | 否 | 排序字段,默認 DATE |
sort_dir | string | 查詢 | 否 | 排序方向。DESCENDING=降序(默認)/ ASCENDING=升序 |
page_size | int | 查詢 | 否 | 每頁條數,默認 50,最大 200 |
page_flag | string | 查詢 | 否 | 翻頁標記。首頁不傳或傳空串;下一頁回傳上一頁響應 pagination.page_flag。只有 pagination.completed 為 true 時停止 |
code | string | 查詢 | 否 | 過濾單隻標的,例: US.TSLA;空=不限 |
fund | string | 查詢 | 否 | ARK ETF 代碼,例: US.ARKK;空=全部 ARK 基金 |
kline_based | bool | 查詢 | 否 | true=按 K 線交易日補齊無成交日的收盤價,默認 false |
請求示例
bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/ark-active-transaction-query' \
-H 'Authorization: Bearer <AccessToken>' | jq響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
data.items | object[] | |
data.items[].code | string | 標的代碼,例: US.TSLA;stock_id=0 時回退 ticker |
data.items[].name | string | 標的名稱 |
data.items[].holding_type | int | 變動類型 INCREASE / DECREASE / NEW / SOLD_OUT / POSITION |
data.items[].date | string | 披露日 YYYY-MM-DD(美東) |
data.items[].change_amount | string | 變動金額(美元) |
data.items[].change_shares | string | 變動數量(股) |
data.items[].price_close | number | 收盤價 |
data.update_time | int | 數據更新時間,Unix 微秒時間戳 |
data.update_date | string | 數據更新日 YYYY-MM-DD(美東) |
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",
"holding_type": 0,
"date": "2026-10-16",
"change_amount": "example",
"change_shares": "example",
"price_close": 1.2
}
],
"update_time": 1710000000000000,
"update_date": "2026-10-16"
},
"pagination": {
"page_flag": "",
"completed": true
}
}