# Query Signals

`GET` `/v1/signals`

Query strategy signals, filtered by symbol, strategy, catalyst and time range. Each signal is a strategy’s take on a security, triggered by a catalyst fact.

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol_name` | string | No | Filter by security symbol, e.g. `AAPL.US` or `700.HK`. If omitted, returns signals for all symbols. |
| `strategy_id` | string | No | Filter by strategy id, e.g. `buffett-value`. Preferred over the deprecated `strategy_name`; takes precedence when both are provided. |
| `strategy_name` | string | No | Filter by strategy name. Deprecated in favour of `strategy_id`. If omitted, returns signals from all strategies. |
| `catalyst_name` | string | No | Filter by the name of the factor that triggered the signal, e.g. `EARNINGS_RELEASED` or `macd_12_26_9` — the triggering fact’s `factors[].name`, not the display label. If omitted, any catalyst name is returned. |
| `catalyst_type` | string | No | Filter by the catalyst type that triggered the signal, e.g. `News`, `Fundamental`, `Technical`. If omitted, any catalyst type is returned. |
| `start_time` | string | No | Only return signals created at or after this time. RFC3339 (a Unix timestamp is also accepted). If omitted, no lower bound. |
| `end_time` | string | No | Only return signals created at or before this time. RFC3339 (a Unix timestamp is also accepted). If omitted, no upper bound. |
| `limit` | integer | No | Maximum number of results to return. Defaults to 20. |
| `offset` | integer | No | Number of results to skip for pagination. Defaults to 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 | Signals on this page |
| `└ id` | string | No | Signal ID, e.g. `sign_992_1a00c9425c3_48ab` |
| `└ stock_symbol` | string | No | Security symbol, e.g. `700.HK`. |
| `└ symbol` | string | No | Security symbol, e.g. `992.HK` |
| `└ company_name` | string | No | Company name |
| `└ title` | string | No | Signal headline |
| `└ strategy_name` | string | No | Strategy name that produced the signal |
| `└ strategy_id` | string | No | Strategy ID that produced the signal |
| `└ expression` | string | No | Strategy expression, e.g. `992.HK:GROWTH:long` |
| `└ created_at` | string | No | Creation time (RFC3339) |
| `└ updated_at` | string | No | Last update time (RFC3339) |
| `└ status` | integer | No | Lifecycle status: `0` Pending, `1` Active, `2` Deleted, `3` AiFailed, `4` FilteredByManual, `5` AiSubmitFailed |
| `└ json_data` | string | No | Full analysis behind the signal as a JSON document (strategy fit scores, valuation scenarios, evidence sources, related fact IDs). Carried verbatim because its shape is strategy-specific. |
| `└ key_fact_id` | string | No | ID of the fact that triggered the signal |
| `└ key_catalyst` | string | No | Display label of the catalyst that triggered the signal, e.g. `Q1 Revenue Surge` |
| `└ analysis_price` | integer | No | Price the analysis was based on |
| `└ conservative_price` | integer | No | Conservative-scenario target price |
| `└ benchmark_price` | integer | No | Benchmark-scenario target price |
| `└ optimistic_price` | integer | No | Optimistic-scenario target price |
| `└ outlook` | string | No | Outlook the strategy takes on the security: `Strong bullish`, `Bullish`, `Neutral`, `Bearish`, `Strong bearish` |
| `└ summary` | string | No | Natural-language summary of the signal, in Markdown |
| `└ market` | string | No | Market the security trades in, e.g. `HK` |
| `└ outlook_desc` | string | No | Outlook label localized in the caller’s language |
| `└ display_control` | integer | No | Display control flag. |
| `└ recommend_by` | string | No | Who recommended the signal; empty for strategy-generated signals |
| `└ risk_level` | string | No | Risk control level. <b>Option:</b>, `0` - safe, `1` - medium risk, `2` - early warning, `3` - danger |
| `total` | integer | No | Total number of signals matching the filters, for paging with `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
  }
}
```
