# 查詢策略信號

`GET` `/v1/signals`

查詢策略信號，可按標的、策略、催化因子和時間範圍過濾。每條信號代表某個策略對一隻標的的判斷，由一個催化事實（fact）觸發。

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol_name` | string | No | 按標的代碼過濾，如 `AAPL.US` 或 `700.HK`。省略則返回全部標的的信號。 |
| `strategy_id` | string | No | 按策略 id 過濾，如 `buffett-value`。優先於已廢棄的 `strategy_name`，兩者同時提供時以此為準。 |
| `strategy_name` | string | No | 按策略名稱過濾。已廢棄，請改用 `strategy_id`。省略則返回全部策略的信號。 |
| `catalyst_name` | string | No | 按觸發信號的因子名稱過濾，如 `EARNINGS_RELEASED` 或 `macd_12_26_9`——即觸發事實的 `factors[].name`，而非展示用標籤。省略則不限催化因子名稱。 |
| `catalyst_type` | string | No | 按觸發信號的催化類型過濾，如 `News`、`Fundamental`、`Technical`。省略則不限催化類型。 |
| `start_time` | string | No | 僅返回建立時間不早於該時刻的信號。RFC3339（也接受 Unix 時間戳）。省略則無下界。 |
| `end_time` | string | No | 僅返回建立時間不晚於該時刻的信號。RFC3339（也接受 Unix 時間戳）。省略則無上界。 |
| `limit` | integer | No | 返回結果的最大數量。預設 20。 |
| `offset` | integer | No | 分頁跳過的結果數量。預設 0。 |

## Request Example

```bash
curl --request GET \
  --url 'https://openapi.longbridge.com/v1/signals' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `signals` | object[] | No | 本頁的信號列表 |
| `└ id` | string | No | 信號 ID，如 `sign_992_1a00c9425c3_48ab` |
| `└ stock_symbol` | string | No | 標的代碼，如 `700.HK`。 |
| `└ symbol` | string | No | 標的代碼，如 `992.HK` |
| `└ company_name` | string | No | 公司名稱 |
| `└ title` | string | No | 信號標題 |
| `└ strategy_name` | string | No | 產生信號的策略名稱 |
| `└ strategy_id` | string | No | 產生信號的策略 ID |
| `└ expression` | string | No | 策略表達式，如 `992.HK:GROWTH:long` |
| `└ created_at` | string | No | 建立時間（RFC3339） |
| `└ updated_at` | string | No | 最後更新時間（RFC3339） |
| `└ status` | integer | No | 生命週期狀態：`0` 待發布、`1` 生效中、`2` 已刪除、`3` AI 生成失敗、`4` 人工過濾、`5` AI 提交失敗 |
| `└ json_data` | string | No | 信號背後的完整分析（JSON 文檔：策略契合評分、估值情景、證據來源、相關事實 ID）。因結構隨策略而異，原樣透傳。 |
| `└ key_fact_id` | string | No | 觸發信號的事實 ID |
| `└ key_catalyst` | string | No | 觸發信號的催化劑展示標籤，如 `Q1 Revenue Surge` |
| `└ analysis_price` | integer | No | 分析所依據的價格 |
| `└ conservative_price` | integer | No | 保守情景目標價 |
| `└ benchmark_price` | integer | No | 基準情景目標價 |
| `└ optimistic_price` | integer | No | 樂觀情景目標價 |
| `└ outlook` | string | No | 策略對標的的觀點：`Strong bullish`、`Bullish`、`Neutral`、`Bearish`、`Strong bearish` |
| `└ summary` | string | No | 信號的自然語言摘要（Markdown） |
| `└ market` | string | No | 標的所屬市場，如 `HK` |
| `└ outlook_desc` | string | No | 觀點在調用方語言下的本地化標籤 |
| `└ display_control` | integer | No | 展示控制標誌。 |
| `└ recommend_by` | string | No | 信號推薦人；策略自動生成時為空 |
| `└ risk_level` | string | No | 風控等級。<b>可選值:</b>, `0` - 安全，`1` - 中風險，`2` - 預警，`3` - 危險 |
| `total` | integer | No | 符合過濾條件的信號總數，配合 `offset` 分頁 |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "signals": [
      {
        "id": "sign_992_1a00c9425c3_48ab",
        "symbol": "992.HK",
        "company_name": "Lenovo Group",
        "market": "HK",
        "title": "Momentum breakout",
        "summary": "RSI crossed above 70 ...",
        "strategy_id": "growth-momentum",
        "strategy_name": "Growth Momentum",
        "expression": "992.HK:GROWTH:long",
        "key_fact_id": "technical_rsi_14_short_1783674041337603409",
        "key_catalyst": "RSI Breakout",
        "analysis_price": 10.5,
        "conservative_price": 11,
        "benchmark_price": 12.5,
        "optimistic_price": 14,
        "outlook": "Bullish",
        "outlook_desc": "Bullish",
        "status": 1,
        "json_data": "{}",
        "created_at": "2026-06-01T09:30:00Z",
        "updated_at": "2026-06-01T09:30:00Z"
      }
    ],
    "total": 1
  }
}
```
