Quote

Security Facts

GEThttps://openapi.longbridge.com/v1/facts/security_facts

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=.

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

NameTypeRequiredDescription
symbolstringRequiredThe security to query, e.g. `AAPL.US` or `700.HK`. Required.
begin_timestringOptionalStart of the query window (RFC3339). If omitted, includes the earliest available data.
end_timestringOptionalEnd of the query window (RFC3339). If omitted, returns the latest data.
limitintegerOptionalMaximum number of facts to return. When more facts fall inside the range, only the latest `limit` are returned. Defaults to 100.

Response

Response properties

NameTypeRequiredDescription
factsobject[]OptionalFact (catalyst) events for the security
└ fact_idstringOptionalFact ID, e.g. `technical_rsi_14_short_1783674041337603409`
└ fact_typestringOptionalKind of fact: `News`, `Fundamental`, `Technical`
└ occur_timestringOptionalWhen the fact occurred (RFC3339)
└ directionstringOptionalSide the fact points to: `long`, `short`, `neutral`
└ data_sourceobject[]OptionalWhere the fact came from (`source_name`, `type`, `url`, `icon`)
└ ∟ typestringOptional`"platform"` for preset strategies
└ ∟ source_namestringOptionalData source name.
└ ∟ urlstringOptionalOriginal image URL
└ ∟ iconstringOptionalIcon URL
└ nl_infoobjectOptionalNatural-language rendering of the fact (`title`, `sub_title`, `summary`, `invest_anal`, `eli_explain`)
└ ∟ titlestringOptionalTopic title
└ ∟ sub_titlestringOptionalSub-title.
└ ∟ summarystringOptionalNatural-language summary of the signal, in Markdown
└ ∟ invest_analstringOptionalInvestment analysis.
└ ∟ eli_explainstringOptionalPlain-language explanation.
└ symbols_infoobject[]OptionalSecurities the fact is about (`symbol`, `security_name`)
└ ∟ symbolstringOptionalSecurity symbol
└ ∟ security_namestringOptionalSecurity name.
└ factorsobject[]OptionalFactors that contributed to the fact (`name`, `factor_groups`, `long_short_direction`, `trigger_condition`, `anomaly_detection`)
└ ∟ namestringOptionalSecurity name.
└ ∟ factor_groupsarrayOptionalFactor groups.
└ ∟ long_short_directionstringOptionalLong/short direction.
└ ∟ anomaly_detectionobjectOptionalAnomaly detection info.
└ ∟ ∟ test_methodstringOptionalTest method.
└ ∟ ∟ anomaly_resultstringOptionalAnomaly detection result.
└ ∟ ∟ thresholdsobjectOptionalThreshold values.
└ ∟ ∟ ∟ lowstringOptional5-year low
└ ∟ ∟ ∟ mediumstringOptionalMedium bound.
└ ∟ ∟ ∟ highstringOptional5-year high
└ ∟ ∟ significance_levelstringOptionalStatistical significance level.
└ ∟ trigger_conditionstringOptionalTrigger 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.