# 查询策略信号

`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
  }
}
```
