Quote
Authorization
Signed mode: every request is signed with your App Key/Secret. Header set:
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string · header | Required | The account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation. |
X-Api-Key | string · header | Required | Your App Key. |
X-Timestamp | string · header | Required | Request timestamp in seconds (Unix epoch). |
X-Api-Signature | string · header | Required | HMAC-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
| Name | Type | Required | Description |
|---|---|---|---|
symbol_name | string | Optional | Filter by security symbol, e.g. `AAPL.US` or `700.HK`. If omitted, returns signals for all symbols. |
strategy_id | string | Optional | Filter by strategy id, e.g. `buffett-value`. Preferred over the deprecated `strategy_name`; takes precedence when both are provided. |
strategy_name | string | Optional | Filter by strategy name. Deprecated in favour of `strategy_id`. If omitted, returns signals from all strategies. |
catalyst_name | string | Optional | 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 | Optional | Filter by the catalyst type that triggered the signal, e.g. `News`, `Fundamental`, `Technical`. If omitted, any catalyst type is returned. |
start_time | string | Optional | Only return signals created at or after this time. RFC3339 (a Unix timestamp is also accepted). If omitted, no lower bound. |
end_time | string | Optional | Only return signals created at or before this time. RFC3339 (a Unix timestamp is also accepted). If omitted, no upper bound. |
limit | integer | Optional | Maximum number of results to return. Defaults to 20. |
offset | integer | Optional | Number of results to skip for pagination. Defaults to 0. |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
signals | object[] | Optional | Signals on this page |
└ id | string | Optional | Signal ID, e.g. `sign_992_1a00c9425c3_48ab` |
└ stock_symbol | string | Optional | Security symbol, e.g. `700.HK`. |
└ symbol | string | Optional | Security symbol, e.g. `992.HK` |
└ company_name | string | Optional | Company name |
└ title | string | Optional | Signal headline |
└ strategy_name | string | Optional | Strategy name that produced the signal |
└ strategy_id | string | Optional | Strategy ID that produced the signal |
└ expression | string | Optional | Strategy expression, e.g. `992.HK:GROWTH:long` |
└ created_at | string | Optional | Creation time (RFC3339) |
└ updated_at | string | Optional | Last update time (RFC3339) |
└ status | integer | Optional | Lifecycle status: `0` Pending, `1` Active, `2` Deleted, `3` AiFailed, `4` FilteredByManual, `5` AiSubmitFailed |
└ json_data | string | Optional | 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 | Optional | ID of the fact that triggered the signal |
└ key_catalyst | string | Optional | Display label of the catalyst that triggered the signal, e.g. `Q1 Revenue Surge` |
└ analysis_price | integer | Optional | Price the analysis was based on |
└ conservative_price | integer | Optional | Conservative-scenario target price |
└ benchmark_price | integer | Optional | Benchmark-scenario target price |
└ optimistic_price | integer | Optional | Optimistic-scenario target price |
└ outlook | string | Optional | Outlook the strategy takes on the security: `Strong bullish`, `Bullish`, `Neutral`, `Bearish`, `Strong bearish` |
└ summary | string | Optional | Natural-language summary of the signal, in Markdown |
└ market | string | Optional | Market the security trades in, e.g. `HK` |
└ outlook_desc | string | Optional | Outlook label localized in the caller’s language |
└ display_control | integer | Optional | Display control flag. |
└ recommend_by | string | Optional | Who recommended the signal; empty for strategy-generated signals |
└ risk_level | string | Optional | Risk control level. <b>Option:</b>, `0` - safe, `1` - medium risk, `2` - early warning, `3` - danger |
total | integer | Optional | Total 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.