# 獲取歷史市場溫度

`GET` `/v1/quote/history_market_temperature`

> **行情權限要求 · 免費**
> 開通 OpenAPI 後自動獲得，無需額外購買。
> _OpenAPI 行情權限獨立於 App/Web 行情權限_

獲取指定市場在日期範圍內的歷史市場溫度時間序列，每個數據點包含當日情緒溫度、估值和情緒分項評分（均爲 0–100 分制）。

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `market` | string | Yes | 市場代碼，`HK`、`US`、`CN`、`SG` 之一。 |
| `start_date` | string | Yes | 起始日期，`YYYYMMDD` 格式（如 `20250101`）。 |
| `end_date` | string | Yes | 結束日期，`YYYYMMDD` 格式（如 `20250110`）。 |

## Request Example

```bash
curl --request GET \
  --url 'https://openapi.longbridge.com/v1/quote/history_market_temperature?market=<market>&start_date=<start_date>&end_date=<end_date>' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `list` | object[] | No | 市場溫度時間序列。 |
| `└ timestamp` | string | No | 數據點的 Unix 時間戳。 |
| `└ temperature` | integer | No | 市場溫度（0–100）。 |
| `└ valuation` | integer | No | 估值分數。 |
| `└ sentiment` | integer | No | 情緒分數。 |
| `type` | string | No | 序列粒度，如 `day`。 |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "list": [
      {
        "timestamp": "1735794000",
        "temperature": 58,
        "valuation": 54,
        "sentiment": 61
      },
      {
        "timestamp": "1735880400",
        "temperature": 59,
        "valuation": 56,
        "sentiment": 63
      }
    ],
    "type": "day"
  }
}
```
