機構個股持倉變動
GET/api/v1.0/quote/institution/transaction-record查詢指定機構在單隻股票上最近 10 個報告期的持倉變動記錄與對應季度末收盤價（用於機構買賣打點與覆盤）。 返回包含：每個報告期的 period_id、起止日期、季末股價（kline_price），以及當期有調倉時的持股數（share_held）、變動股數（change_shares）、變動金額（change_value）與組合佔比。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
institution_id | int | 查詢 | 是 | 機構 ID，例: 255251 |
code | string | 查詢 | 是 | 股票代碼，例: US.AAPL / US.TSLA |
請求示例
bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/institution/transaction-record?institution_id=1&code=US.AAPL' \
-H 'Authorization: Bearer <AccessToken>' | jq響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
data.items | object[] | |
data.items[].period_id | integer | 報告期 ID |
data.items[].start_date | integer | 報告期起始日 YYYY-MM-DD |
data.items[].end_date | integer | 報告期結束日 YYYY-MM-DD |
data.items[].kline_price | number | 該報告期末股票價格 |
data.items[].share_held | string | 期末持股數量（股） |
data.items[].change_shares | string | 當期持倉變動股數 |
data.items[].change_value | string | 當期持倉變動金額 |
data.items[].portfolio_pct | string | 佔組合市值比例（百分數） |
data.items[].change_pct | string | 持倉變動比例（百分數） |
錯誤碼
| 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": {
"items": [
{
"period_id": 0,
"start_date": 0,
"end_date": 0,
"kline_price": "example",
"share_held": "example",
"change_shares": "example"
}
]
}
}