账户
鉴权
签名方式:每个请求用 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"
}
}
]
}
]
}
}错误码
参见错误码文档。