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=. |
List the fact (catalyst) events for one security — anomaly detections, factor readings, data sources and natural-language summaries. Facts are what strategies react to: a signal names the fact that triggered it in key_fact_id.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | The security to query, e.g. `AAPL.US` or `700.HK`. Required. |
begin_time | string | Optional | Start of the query window (RFC3339). If omitted, includes the earliest available data. |
end_time | string | Optional | End of the query window (RFC3339). If omitted, returns the latest data. |
limit | integer | Optional | Maximum number of facts to return. When more facts fall inside the range, only the latest `limit` are returned. Defaults to 100. |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
facts | object[] | Optional | Fact (catalyst) events for the security |
└ fact_id | string | Optional | Fact ID, e.g. `technical_rsi_14_short_1783674041337603409` |
└ fact_type | string | Optional | Kind of fact: `News`, `Fundamental`, `Technical` |
└ occur_time | string | Optional | When the fact occurred (RFC3339) |
└ direction | string | Optional | Side the fact points to: `long`, `short`, `neutral` |
└ data_source | object[] | Optional | Where the fact came from (`source_name`, `type`, `url`, `icon`) |
└ ∟ type | string | Optional | `"platform"` for preset strategies |
└ ∟ source_name | string | Optional | Data source name. |
└ ∟ url | string | Optional | Original image URL |
└ ∟ icon | string | Optional | Icon URL |
└ nl_info | object | Optional | Natural-language rendering of the fact (`title`, `sub_title`, `summary`, `invest_anal`, `eli_explain`) |
└ ∟ title | string | Optional | Topic title |
└ ∟ sub_title | string | Optional | Sub-title. |
└ ∟ summary | string | Optional | Natural-language summary of the signal, in Markdown |
└ ∟ invest_anal | string | Optional | Investment analysis. |
└ ∟ eli_explain | string | Optional | Plain-language explanation. |
└ symbols_info | object[] | Optional | Securities the fact is about (`symbol`, `security_name`) |
└ ∟ symbol | string | Optional | Security symbol |
└ ∟ security_name | string | Optional | Security name. |
└ factors | object[] | Optional | Factors that contributed to the fact (`name`, `factor_groups`, `long_short_direction`, `trigger_condition`, `anomaly_detection`) |
└ ∟ name | string | Optional | Security name. |
└ ∟ factor_groups | array | Optional | Factor groups. |
└ ∟ long_short_direction | string | Optional | Long/short direction. |
└ ∟ anomaly_detection | object | Optional | Anomaly detection info. |
└ ∟ ∟ test_method | string | Optional | Test method. |
└ ∟ ∟ anomaly_result | string | Optional | Anomaly detection result. |
└ ∟ ∟ thresholds | object | Optional | Threshold values. |
└ ∟ ∟ ∟ low | string | Optional | 5-year low |
└ ∟ ∟ ∟ medium | string | Optional | Medium bound. |
└ ∟ ∟ ∟ high | string | Optional | 5-year high |
└ ∟ ∟ significance_level | string | Optional | Statistical significance level. |
└ ∟ trigger_condition | string | Optional | Trigger condition. |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"facts": [
{
"fact_id": "technical_rsi_14_short_1783674041337603409",
"fact_type": "Technical",
"direction": "short",
"occur_time": "2026-06-01T00:00:00Z",
"symbols_info": [
{
"symbol": "AAPL.US",
"security_name": "Apple"
}
],
"factors": [
{
"name": "rsi_14",
"factor_groups": [
"MOMENTUM"
],
"long_short_direction": "short",
"trigger_condition": "RSI > 70",
"anomaly_detection": {
"anomaly_result": "",
"significance_level": "",
"test_method": "",
"thresholds": {
"low": "",
"medium": "",
"high": ""
}
}
}
],
"data_source": [
{
"source_name": "Nasdaq",
"type": "Technical",
"url": "",
"icon": ""
}
],
"nl_info": {
"title": "RSI overbought",
"sub_title": "",
"summary": "[]",
"invest_anal": "[]",
"eli_explain": "[]"
}
}
]
}
}Error code
See the Error Codes page for the full list of error codes.