滬深港通持股歷史

GET /api/v1.0/quote/{symbol}/stock-connect/hold-ratio

獲取個股滬深港通持股數量與持股比例時間序列。 港股為南向持股，A 股為北向持股。按時間倒序；end 為開區間上界（不含該日）。 持股比例為百分數（如 20.35 表示 20.35%）；持倉成本已還原。 個股累計淨流入請用 quote.stock_connect_stock_flow。

請求參數

參數	類型	位置	必填	說明
symbol	string	路徑	是	股票代碼（路徑參數），例: HK.00700 / SH.600519
end	string	查詢	否	截止日期 yyyy-MM-dd（不含該日）；不傳從最新開始。翻頁時改用 page_flag
limit	int	查詢	否	返回條數，默認 30，最大 200
page_flag	string	查詢	否	翻頁遊標，首頁留空；下一頁回傳 pagination.page_flag

請求示例

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/stock-connect/hold-ratio?end=1&limit=1&page_flag=1' \
  -H 'Authorization: Bearer <AccessToken>' | jq

響應參數

參數	類型	說明
data.items	object[]
data.hold_cost	string	持倉成本（元）
data.update_time	integer	數據更新時間（Unix 秒）
data.items[].timestamp	integer	持股日期（Unix 秒，精確到日）
data.items[].hold_shares	integer	持股數量（股）
data.items[].hold_ratio	string	持股比例百分數（如 20.35 表示 20.35%）
data.items[].net_buy_shares	integer	當日淨買入股數
data.items[].net_buy_amount	string	當日淨買入金額（元）
data.items[].open_price	string	開盤價
data.items[].close_price	string	收盤價
data.items[].last_close_price	string	昨收價
pagination.completed	string	是否已到末頁
pagination.page_flag	string	下一頁遊標（上一頁最後一條 timestamp，作為下一頁 date_end）

錯誤碼

ret_code	error.code	說明
0	—	成功
-3	invalid_parameter	參數缺失或不在允許範圍內
-7	invalid_symbol	標的不存在
-8	unsupported	市場或品類不支持
-9	permission_denied	沒有對應權限
-10	no_data	沒有可返回的數據
-11	rate_limited	調用過於頻繁

響應示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "hold_cost": "example",
    "update_time": "example",
    "items": [
      {
        "timestamp": 0,
        "hold_shares": 0,
        "hold_ratio": "example",
        "net_buy_shares": 0,
        "net_buy_amount": "example",
        "open_price": "example"
      }
    ]
  },
  "pagination": {
    "completed": true,
    "page_flag": ""
  }
}