机构持仓收益分析
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.futunn.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"
}
]
}
}