# 查詢標的催化事實

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