Skip to content

ARK 主動交易明細 ​

GET /api/v1.0/quote/ark-active-transaction-query

ARK 主動交易明細(含披露日與收盤價)。可按標的 / 基金過濾;kline_based=true 時按 K 線交易日補齊無成交日的收盤價。 count 默認 50、最大 200。聚合榜(無收盤價)請用 quote.ark_active_transaction。

請求參數 ​

參數類型位置必填說明
holding_typestring查詢否變動類型,默認 ALL。服務端該接口語義為全部/買入/賣出;NEW / SOLD_OUT 按同一枚舉原樣傳入
sort_fieldstring查詢否排序字段,默認 DATE
sort_dirstring查詢否排序方向。DESCENDING=降序(默認)/ ASCENDING=升序
page_sizeint查詢否每頁條數,默認 50,最大 200
page_flagstring查詢否翻頁標記。首頁不傳或傳空串;下一頁回傳上一頁響應 pagination.page_flag。只有 pagination.completed 為 true 時停止
codestring查詢否過濾單隻標的,例: US.TSLA;空=不限
fundstring查詢否ARK ETF 代碼,例: US.ARKK;空=全部 ARK 基金
kline_basedbool查詢否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.itemsobject[]
data.items[].codestring標的代碼,例: US.TSLA;stock_id=0 時回退 ticker
data.items[].namestring標的名稱
data.items[].holding_typeint變動類型 INCREASE / DECREASE / NEW / SOLD_OUT / POSITION
data.items[].datestring披露日 YYYY-MM-DD(美東)
data.items[].change_amountstring變動金額(美元)
data.items[].change_sharesstring變動數量(股)
data.items[].price_closenumber收盤價
data.update_timeint數據更新時間,Unix 微秒時間戳
data.update_datestring數據更新日 YYYY-MM-DD(美東)
pagination.completedbool是否已到末頁。只有 true 時停止翻頁
pagination.page_flagstring下一頁標記。completed 為 false 時回傳為下一次請求的 page_flag;末頁為空串

錯誤碼 ​

ret_codeerror.code說明
0—成功
-3invalid_parameter參數不合法
-8unsupported不支持
-10no_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
  }
}