帳戶
鑑權
簽名方式:每個請求用 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=。 |
獲取當前用戶的所有股價提醒,支持按標的篩選。
請求
查詢參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
symbol | string | 可選 | 按證券代碼篩選,例如 `TSLA.US` |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
lists | object[] | 可選 | 按標的分組的提醒列表,見 AlertSymbolGroup |
└ symbol | string | 可選 | 證券代碼 |
└ chg | string | 可選 | 當日漲跌額 |
└ price | string | 可選 | 最新價 |
└ p_chg | string | 可選 | 當日漲跌幅 |
└ name | string | 可選 | 標的名稱。 |
└ market | string | 可選 | 市場 |
└ code | string | 可選 | 股票代碼 |
└ indicators | object[] | 可選 | 股價提醒列表,見 AlertItem |
└ ∟ id | string | 可選 | 提醒 ID |
└ ∟ indicator_id | string | 可選 | 條件:`1`=價格上漲,`2`=價格下跌,`3`=漲幅,`4`=跌幅 |
└ ∟ frequency | integer | 可選 | 觸發頻率:`1`=每日,`2`=每次,`3`=一次 |
└ ∟ enabled | boolean | 可選 | 是否啟用 |
└ ∟ text | string | 可選 | 顯示文本 |
└ ∟ scope | integer | 可選 | 範圍 |
└ ∟ value_map | object | 可選 | 觸發值(如 `{"price":"400"}` 或 `{"chg":"5"}`) |
└ ∟ ∟ price | string | 可選 | 最新價 |
└ ∟ state | array | 可選 | 觸發狀態標誌 |
└ product | string | 可選 | 產品類型 |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"lists": [
{
"symbol": "AAPL.US",
"code": "AAPL",
"market": "US",
"name": "Apple",
"price": "298.87",
"chg": "4.07",
"p_chg": "1.38",
"product": "stock",
"indicators": [
{
"id": "514050",
"indicator_id": "1",
"enabled": true,
"frequency": 2,
"scope": 0,
"text": "Price rises to 400",
"state": [
1
],
"value_map": {
"price": "400"
}
}
]
}
]
}
}錯誤碼
參見錯誤碼文檔。