機構持倉收益分析
GET/api/v1.0/quote/institution/return-rate查詢指定機構持倉組合的歷史累計收益率曲線及最新持倉市值/持股數變動。 支持傳入 compare_code（如 US.SPY / US.QQQ）對比基準指數同期漲幅。 ARK 基金收益率請用 quote.ark_fund_return_rate。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
institution_id | int | 查詢 | 是 | 機構 ID，例: 255251（Berkshire Hathaway） |
compare_code | string | 查詢 | 否 | 對比基準標的代碼，例: US.SPY / US.QQQ；不傳則不對比 |
請求示例
bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/institution/return-rate?institution_id=1&compare_code=1' \
-H 'Authorization: Bearer <AccessToken>' | jq響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
data.items | object[] | |
data.total_return_rate | number | 窗口期累計總收益率（百分數，原始值放大 10^4，9.95 表示 9.95%） |
data.market_value | string | 最新持倉總市值（美元） |
data.market_value_change | string | 持倉總市值較上一報告期變動（美元） |
data.stock_count | integer | 最新持股只數 |
data.stock_count_change | integer | 持股只數較上一報告期變動 |
data.items[].date | integer | 報告期日期 YYYY-MM-DD |
data.items[].timestamp | integer | 報告期毫秒時間戳 |
data.items[].return_rate | number | 截至該期的累計收益率（百分數） |
data.items[].compare_increase | number | 對比基準同期漲幅（百分數） |
錯誤碼
| 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": {
"total_return_rate": "example",
"market_value": "example",
"market_value_change": "example",
"stock_count": "example",
"stock_count_change": "example",
"items": [
{
"date": 0,
"timestamp": 0,
"return_rate": "example",
"compare_increase": "example"
}
]
}
}