# List Security Facts

`GET` `/v1/facts/security_facts`

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

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | The security to query, e.g. `AAPL.US` or `700.HK`. Required. |
| `begin_time` | string | No | Start of the query window (RFC3339). If omitted, includes the earliest available data. |
| `end_time` | string | No | End of the query window (RFC3339). If omitted, returns the latest data. |
| `limit` | integer | No | Maximum number of facts to return. When more facts fall inside the range, only the latest `limit` are returned. Defaults to 100. |

## Request Example

```bash
curl --request GET \
  --url 'https://openapi.longbridge.com/v1/facts/security_facts?symbol=<symbol>' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `facts` | object[] | No | Fact (catalyst) events for the security |
| `└ fact_id` | string | No | Fact ID, e.g. `technical_rsi_14_short_1783674041337603409` |
| `└ fact_type` | string | No | Kind of fact: `News`, `Fundamental`, `Technical` |
| `└ occur_time` | string | No | When the fact occurred (RFC3339) |
| `└ direction` | string | No | Side the fact points to: `long`, `short`, `neutral` |
| `└ data_source` | object[] | No | Where the fact came from (`source_name`, `type`, `url`, `icon`) |
| `└ ∟ type` | string | No | `"platform"` for preset strategies |
| `└ ∟ source_name` | string | No | Data source name. |
| `└ ∟ url` | string | No | Original image URL |
| `└ ∟ icon` | string | No | Icon URL |
| `└ nl_info` | object | No | Natural-language rendering of the fact (`title`, `sub_title`, `summary`, `invest_anal`, `eli_explain`) |
| `└ ∟ title` | string | No | Topic title |
| `└ ∟ sub_title` | string | No | Sub-title. |
| `└ ∟ summary` | string | No | Natural-language summary of the signal, in Markdown |
| `└ ∟ invest_anal` | string | No | Investment analysis. |
| `└ ∟ eli_explain` | string | No | Plain-language explanation. |
| `└ symbols_info` | object[] | No | Securities the fact is about (`symbol`, `security_name`) |
| `└ ∟ symbol` | string | No | Security symbol |
| `└ ∟ security_name` | string | No | Security name. |
| `└ factors` | object[] | No | Factors that contributed to the fact (`name`, `factor_groups`, `long_short_direction`, `trigger_condition`, `anomaly_detection`) |
| `└ ∟ name` | string | No | Security name. |
| `└ ∟ factor_groups` | array | No | Factor groups. |
| `└ ∟ long_short_direction` | string | No | Long/short direction. |
| `└ ∟ anomaly_detection` | object | No | Anomaly detection info. |
| `└ ∟ ∟ test_method` | string | No | Test method. |
| `└ ∟ ∟ anomaly_result` | string | No | Anomaly detection result. |
| `└ ∟ ∟ thresholds` | object | No | Threshold values. |
| `└ ∟ ∟ ∟ low` | string | No | 5-year low |
| `└ ∟ ∟ ∟ medium` | string | No | Medium bound. |
| `└ ∟ ∟ ∟ high` | string | No | 5-year high |
| `└ ∟ ∟ significance_level` | string | No | Statistical significance level. |
| `└ ∟ trigger_condition` | string | No | Trigger condition. |

### Response JSON Example

```json
{
  "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": "[]"
        }
      }
    ]
  }
}
```
