# 機構評級詳情

`GET` `/v1/quote/institution-ratings/detail`

獲取歷史分析師評級及目標價詳情。

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | 證券代碼，例如 `TSLA.US` |

## Request Example

```bash
curl --request GET \
  --url 'https://openapi.longbridge.com/v1/quote/institution-ratings/detail?symbol=<symbol>' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `evaluate` | object | No | 評級分佈歷史 |
| `└ list` | object[] | No | 每日持倉歷史紀錄， |
| `└ ∟ strong_buy` | integer | No | 強烈買入評級數量 |
| `└ ∟ buy` | integer | No | 買入評級數量 |
| `└ ∟ hold` | integer | No | 持有評級數量 |
| `└ ∟ sell` | integer | No | 賣出評級數量 |
| `└ ∟ under` | integer | No | 跑輸市場評級數量 |
| `└ ∟ date` | string | No | 日期 |
| `target` | object | No | 目標價歷史 |
| `└ updated_at` | string | No | 最近更新時間，Unix 時間戳（秒） |
| `└ prediction_accuracy` | string | No | 預測準確率。 |
| `└ list` | object[] | No | 每日持倉歷史紀錄， |
| `└ ∟ timestamp` | string | No | Unix 時間戳 |
| `└ ∟ price` | string | No | 當日收盤價 |
| `└ ∟ meet` | boolean | No | 價格是否達到目標 |
| `└ ∟ avg_target` | string | No | 平均目標價 |
| `└ ∟ min_target` | string | No | 最低目標價 |
| `└ ∟ max_target` | string | No | 最高目標價 |
| `└ ∟ date` | string | No | 日期 |
| `└ data_percent` | string | No | 數據完整度百分比。 |
| `ccy_symbol` | string | No | 貨幣符號 |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "ccy_symbol": "$",
    "evaluate": {
      "list": [
        {
          "date": "2021/05/14",
          "buy": 3,
          "hold": 11,
          "sell": 2,
          "strong_buy": 9,
          "under": 6
        }
      ]
    },
    "target": {
      "list": [
        {
          "broker_name": "Goldman Sachs",
          "date": "2026-04-30",
          "rating": "Buy",
          "target_price": "250.00"
        }
      ]
    }
  }
}
```
