提醒

提醒接口用于读取和维护价格、账户或事件提醒。它适合做辅助通知，不适合直接替代交易风控。

创建、修改和删除提醒会改变用户在 IBKR 系统中的数据。文档示例用于说明请求结构；接入到产品前，应让用户明确确认提醒名称、条件和启用状态。

官方参考：Client Portal API

常用接口

接口	方法	用途
/iserver/account/alerts	GET	读取提醒列表。
/iserver/account/alert	POST	创建提醒。
/iserver/account/alert/{alertId}	GET	查询单个提醒。
/iserver/account/alert/{alertId}	DELETE	删除提醒。

提醒结构

示例结构：

{
  "alertName": "AAPL 价格提醒",
  "alertMessage": "AAPL 到达目标价格",
  "conditions": [
    {
      "conid": 265598,
      "field": "LAST",
      "operator": ">=",
      "value": 300
    }
  ],
  "active": true
}

字段解释：

字段	中文说明
alertName	提醒名称。
alertMessage	触发后展示的消息。
conditions	触发条件数组。
conid	监控的合约编号。
field	监控字段，例如最新价。
operator	比较方式，例如大于、小于、等于。
value	触发阈值。
active	是否启用提醒。

Python 示例

import requests

BASE_URL = "https://localhost:5000/v1/api"

response = requests.get(
    f"{BASE_URL}/iserver/account/alerts",
    verify=False,  # 仅限开发调试；正式环境请配置受信任证书
    timeout=10,
)
response.raise_for_status()
print(response.json())

使用建议

问题	建议
提醒没有触发	检查条件字段、行情权限和 Gateway 会话。
提醒太多	前端按产品、symbol、启用状态过滤。
用提醒自动下单	不建议直接这么做；提醒和交易信号应分开。

提醒接口的可用字段和返回结构可能随账户权限变化。写程序时要保留原始返回，便于排查。