行情
鑑權
簽名方式:每個請求用 App Key / Secret 簽名。請求頭如下:
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 後台 上的賬戶 Access Token,作為原始 token 傳入(不帶 Bearer 前綴),並參與簽名計算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 請求時間戳,單位秒(Unix 時間)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 簽名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
查詢策略信號,可按標的、策略、催化因子和時間範圍過濾。每條信號代表某個策略對一隻標的的判斷,由一個催化事實(fact)觸發。
請求
查詢參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
symbol_name | string | 可選 | 按標的代碼過濾,如 `AAPL.US` 或 `700.HK`。省略則返回全部標的的信號。 |
strategy_id | string | 可選 | 按策略 id 過濾,如 `buffett-value`。優先於已廢棄的 `strategy_name`,兩者同時提供時以此為準。 |
strategy_name | string | 可選 | 按策略名稱過濾。已廢棄,請改用 `strategy_id`。省略則返回全部策略的信號。 |
catalyst_name | string | 可選 | 按觸發信號的因子名稱過濾,如 `EARNINGS_RELEASED` 或 `macd_12_26_9`——即觸發事實的 `factors[].name`,而非展示用標籤。省略則不限催化因子名稱。 |
catalyst_type | string | 可選 | 按觸發信號的催化類型過濾,如 `News`、`Fundamental`、`Technical`。省略則不限催化類型。 |
start_time | string | 可選 | 僅返回建立時間不早於該時刻的信號。RFC3339(也接受 Unix 時間戳)。省略則無下界。 |
end_time | string | 可選 | 僅返回建立時間不晚於該時刻的信號。RFC3339(也接受 Unix 時間戳)。省略則無上界。 |
limit | integer | 可選 | 返回結果的最大數量。預設 20。 |
offset | integer | 可選 | 分頁跳過的結果數量。預設 0。 |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
signals | object[] | 可選 | 本頁的信號列表 |
└ id | string | 可選 | 信號 ID,如 `sign_992_1a00c9425c3_48ab` |
└ stock_symbol | string | 可選 | 標的代碼,如 `700.HK`。 |
└ symbol | string | 可選 | 標的代碼,如 `992.HK` |
└ company_name | string | 可選 | 公司名稱 |
└ title | string | 可選 | 信號標題 |
└ strategy_name | string | 可選 | 產生信號的策略名稱 |
└ strategy_id | string | 可選 | 產生信號的策略 ID |
└ expression | string | 可選 | 策略表達式,如 `992.HK:GROWTH:long` |
└ created_at | string | 可選 | 建立時間(RFC3339) |
└ updated_at | string | 可選 | 最後更新時間(RFC3339) |
└ status | integer | 可選 | 生命週期狀態:`0` 待發布、`1` 生效中、`2` 已刪除、`3` AI 生成失敗、`4` 人工過濾、`5` AI 提交失敗 |
└ json_data | string | 可選 | 信號背後的完整分析(JSON 文檔:策略契合評分、估值情景、證據來源、相關事實 ID)。因結構隨策略而異,原樣透傳。 |
└ key_fact_id | string | 可選 | 觸發信號的事實 ID |
└ key_catalyst | string | 可選 | 觸發信號的催化劑展示標籤,如 `Q1 Revenue Surge` |
└ analysis_price | integer | 可選 | 分析所依據的價格 |
└ conservative_price | integer | 可選 | 保守情景目標價 |
└ benchmark_price | integer | 可選 | 基準情景目標價 |
└ optimistic_price | integer | 可選 | 樂觀情景目標價 |
└ outlook | string | 可選 | 策略對標的的觀點:`Strong bullish`、`Bullish`、`Neutral`、`Bearish`、`Strong bearish` |
└ summary | string | 可選 | 信號的自然語言摘要(Markdown) |
└ market | string | 可選 | 標的所屬市場,如 `HK` |
└ outlook_desc | string | 可選 | 觀點在調用方語言下的本地化標籤 |
└ display_control | integer | 可選 | 展示控制標誌。 |
└ recommend_by | string | 可選 | 信號推薦人;策略自動生成時為空 |
└ risk_level | string | 可選 | 風控等級。<b>可選值:</b>, `0` - 安全,`1` - 中風險,`2` - 預警,`3` - 危險 |
total | integer | 可選 | 符合過濾條件的信號總數,配合 `offset` 分頁 |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"signals": [
{
"id": "sign_992_1a00c9425c3_48ab",
"symbol": "992.HK",
"company_name": "Lenovo Group",
"market": "HK",
"title": "Momentum breakout",
"summary": "RSI crossed above 70 ...",
"strategy_id": "growth-momentum",
"strategy_name": "Growth Momentum",
"expression": "992.HK:GROWTH:long",
"key_fact_id": "technical_rsi_14_short_1783674041337603409",
"key_catalyst": "RSI Breakout",
"analysis_price": 10.5,
"conservative_price": 11,
"benchmark_price": 12.5,
"optimistic_price": 14,
"outlook": "Bullish",
"outlook_desc": "Bullish",
"status": 1,
"json_data": "{}",
"created_at": "2026-06-01T09:30:00Z",
"updated_at": "2026-06-01T09:30:00Z"
}
],
"total": 1
}
}錯誤碼
參見錯誤碼文檔。