通知与消息

FYI 和通知接口用于读取 IBKR 给账户或用户推送的消息，例如系统通知、风险提示、交易相关提醒等。

这类消息不一定是行情或订单数据，但对真实交易系统很重要。程序应把它们记录下来，必要时展示给用户。

官方参考：Client Portal API

常用接口

接口	方法	用途
/fyi/unreadnumber	GET	查询未读通知数量。
/fyi/notifications	GET	读取通知列表。
/fyi/settings	GET	读取 FYI 设置。
/fyi/settings/{typecode}	POST	修改某类通知设置。
/fyi/disclaimer/{typecode}	PUT	确认免责声明或提示。

通知列表

curl -k https://localhost:5000/v1/api/fyi/notifications

常见字段：

字段	中文说明
id	通知编号。
type / typecode	通知类型。
title	标题。
message	消息正文。
date	时间。
read	是否已读。

Python 示例

import requests

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

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

处理建议

消息类型	建议
风险提示	展示给用户并记录。
账户通知	不要忽略，可能影响交易权限或登录状态。
免责声明	需要用户明确确认，不建议程序自动确认。
系统消息	写入日志，便于排查 Gateway 异常。

如果接口返回空列表，不代表没有权限问题；也可能只是账户没有未读通知。