# 查询标的催化事实

`GET` `/v1/facts/security_facts`

查询某只标的的催化事实（fact）事件——异常检测、因子读数、数据来源与自然语言摘要。事实是策略所响应的对象：信号会在 `key_fact_id` 中标明触发它的事实。

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | 要查询的标的，如 `AAPL.US` 或 `700.HK`。必填。 |
| `begin_time` | string | No | 查询窗口起点（RFC3339）。省略则包含最早可用数据。 |
| `end_time` | string | No | 查询窗口终点（RFC3339）。省略则返回最新数据。 |
| `limit` | integer | No | 返回事实的最大数量。区间内事实更多时，仅返回最新的 `limit` 条。默认 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_id` | string | No | 事实 ID，如 `technical_rsi_14_short_1783674041337603409` |
| `└ fact_type` | string | No | 事实类型：`News`、`Fundamental`、`Technical` |
| `└ occur_time` | string | No | 事实发生时间（RFC3339） |
| `└ direction` | string | No | 事实方向：`long`、`short`、`neutral` |
| `└ data_source` | object[] | No | 事实来源（`source_name`、`type`、`url`、`icon`） |
| `└ ∟ type` | string | No | `"platform"` 表示平台预设策略 |
| `└ ∟ source_name` | string | No | 数据来源名称。 |
| `└ ∟ url` | string | No | 原始图片 URL |
| `└ ∟ icon` | string | No | 图标链接 |
| `└ nl_info` | object | No | 事实的自然语言呈现（`title`、`sub_title`、`summary`、`invest_anal`、`eli_explain`） |
| `└ ∟ title` | string | No | 标题 |
| `└ ∟ sub_title` | string | No | 副标题。 |
| `└ ∟ summary` | string | No | 信号的自然语言摘要（Markdown） |
| `└ ∟ invest_anal` | string | No | 投资分析。 |
| `└ ∟ eli_explain` | string | No | 通俗解释。 |
| `└ symbols_info` | object[] | No | 事实涉及的标的（`symbol`、`security_name`） |
| `└ ∟ symbol` | string | No | 证券代码 |
| `└ ∟ security_name` | string | No | 标的名称。 |
| `└ factors` | object[] | No | 构成该事实的因子（`name`、`factor_groups`、`long_short_direction`、`trigger_condition`、`anomaly_detection`） |
| `└ ∟ name` | string | No | 标的名称。 |
| `└ ∟ factor_groups` | array | No | 因子分组。 |
| `└ ∟ long_short_direction` | string | No | 多空方向。 |
| `└ ∟ anomaly_detection` | object | No | 异动检测信息。 |
| `└ ∟ ∟ test_method` | string | No | 检验方法。 |
| `└ ∟ ∟ anomaly_result` | string | No | 异动检测结果。 |
| `└ ∟ ∟ thresholds` | object | No | 阈值。 |
| `└ ∟ ∟ ∟ low` | string | No | 5 年最低值 |
| `└ ∟ ∟ ∟ medium` | string | No | 中位区间。 |
| `└ ∟ ∟ ∟ high` | string | No | 5 年最高值 |
| `└ ∟ ∟ significance_level` | string | No | 显著性水平。 |
| `└ ∟ trigger_condition` | string | No | 触发条件。 |

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