# 機構共識

`GET` `/v1/quote/financial-consensus-detail`

獲取機構共識預測，包括營收、EPS 和淨利潤預測。

## 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/financial-consensus-detail?symbol=<symbol>' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `list` | object[] | No | 共識預測期列表， |
| `└ fiscal_year` | integer | No | 財年 |
| `└ fiscal_period` | string | No | 財年內的財季序號 |
| `└ period_text` | string | No | 展示用週期標籤（如 Q1 2027） |
| `└ details` | object[] | No | 財務指標詳情列表 |
| `└ ∟ key` | string | No | 指標鍵（如 `eps`、`revenue`） |
| `└ ∟ name` | string | No | 標的名稱。 |
| `└ ∟ description` | string | No | 完整描述 |
| `└ ∟ estimate` | string | No | 一致預期值 |
| `└ ∟ is_released` | boolean | No | 實際值是否已公佈 |
| `└ ∟ actual` | string | No | 實際披露值 |
| `└ ∟ comp_value` | string | No | 對比百分比值 |
| `└ ∟ comp_desc` | string | No | 對比描述 |
| `└ ∟ comp` | string | No | 對比結果（如 `beat`、`miss`） |
| `current_index` | integer | No | 當前週期在 opt_periods 中的索引 |
| `currency` | string | No | 報告貨幣 |
| `opt_periods` | array | No | 可選週期選項 |
| `current_period` | string | No | 當前週期代碼（如 `qf`） |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "currency": "USD",
    "current_index": 3,
    "current_period": "qf",
    "opt_periods": [
      "qf",
      "af",
      "saf"
    ],
    "list": [
      {
        "fiscal_year": 2026,
        "fiscal_period": "Q2 FY2026",
        "period_text": "Q2 FY2026",
        "details": [
          {
            "key": "revenue",
            "name": "Revenue",
            "estimate": "95000000000",
            "actual": "",
            "comp": "",
            "comp_value": null,
            "comp_desc": "",
            "description": "",
            "is_released": false
          }
        ]
      }
    ]
  }
}
```
