Quote

Signals

GEThttps://openapi.longbridge.com/v1/signals

Authorization

Signed mode: every request is signed with your App Key/Secret. Header set:

NameTypeRequiredDescription
Authorizationstring · headerRequiredThe account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation.
X-Api-Keystring · headerRequiredYour App Key.
X-Timestampstring · headerRequiredRequest timestamp in seconds (Unix epoch).
X-Api-Signaturestring · headerRequiredHMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=.

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.

Request

Query parameters

NameTypeRequiredDescription
symbol_namestringOptionalFilter by security symbol, e.g. `AAPL.US` or `700.HK`. If omitted, returns signals for all symbols.
strategy_idstringOptionalFilter by strategy id, e.g. `buffett-value`. Preferred over the deprecated `strategy_name`; takes precedence when both are provided.
strategy_namestringOptionalFilter by strategy name. Deprecated in favour of `strategy_id`. If omitted, returns signals from all strategies.
catalyst_namestringOptionalFilter 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_typestringOptionalFilter by the catalyst type that triggered the signal, e.g. `News`, `Fundamental`, `Technical`. If omitted, any catalyst type is returned.
start_timestringOptionalOnly return signals created at or after this time. RFC3339 (a Unix timestamp is also accepted). If omitted, no lower bound.
end_timestringOptionalOnly return signals created at or before this time. RFC3339 (a Unix timestamp is also accepted). If omitted, no upper bound.
limitintegerOptionalMaximum number of results to return. Defaults to 20.
offsetintegerOptionalNumber of results to skip for pagination. Defaults to 0.

Response

Response properties

NameTypeRequiredDescription
signalsobject[]OptionalSignals on this page
└ idstringOptionalSignal ID, e.g. `sign_992_1a00c9425c3_48ab`
└ stock_symbolstringOptionalSecurity symbol, e.g. `700.HK`.
└ symbolstringOptionalSecurity symbol, e.g. `992.HK`
└ company_namestringOptionalCompany name
└ titlestringOptionalSignal headline
└ strategy_namestringOptionalStrategy name that produced the signal
└ strategy_idstringOptionalStrategy ID that produced the signal
└ expressionstringOptionalStrategy expression, e.g. `992.HK:GROWTH:long`
└ created_atstringOptionalCreation time (RFC3339)
└ updated_atstringOptionalLast update time (RFC3339)
└ statusintegerOptionalLifecycle status: `0` Pending, `1` Active, `2` Deleted, `3` AiFailed, `4` FilteredByManual, `5` AiSubmitFailed
└ json_datastringOptionalFull 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_idstringOptionalID of the fact that triggered the signal
└ key_catalyststringOptionalDisplay label of the catalyst that triggered the signal, e.g. `Q1 Revenue Surge`
└ analysis_priceintegerOptionalPrice the analysis was based on
└ conservative_priceintegerOptionalConservative-scenario target price
└ benchmark_priceintegerOptionalBenchmark-scenario target price
└ optimistic_priceintegerOptionalOptimistic-scenario target price
└ outlookstringOptionalOutlook the strategy takes on the security: `Strong bullish`, `Bullish`, `Neutral`, `Bearish`, `Strong bearish`
└ summarystringOptionalNatural-language summary of the signal, in Markdown
└ marketstringOptionalMarket the security trades in, e.g. `HK`
└ outlook_descstringOptionalOutlook label localized in the caller’s language
└ display_controlintegerOptionalDisplay control flag.
└ recommend_bystringOptionalWho recommended the signal; empty for strategy-generated signals
└ risk_levelstringOptionalRisk control level. <b>Option:</b>, `0` - safe, `1` - medium risk, `2` - early warning, `3` - danger
totalintegerOptionalTotal number of signals matching the filters, for paging with `offset`

Response JSON example

{
  "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
  }
}

Error code

See the Error Codes page for the full list of error codes.