自选列表

自选列表接口用于读取和维护用户在 Client Portal / IBKR 系统中的 watchlist。它适合做行情面板、关注列表和策略候选池。

创建、修改和删除自选列表会影响用户账户里的列表数据。开发时建议先读取已有列表，再让用户确认要新增、覆盖还是删除。

官方参考：Client Portal API

常用接口

接口	方法	用途
/iserver/watchlists	GET	读取自选列表。
/iserver/watchlist	POST	创建自选列表。
/iserver/watchlist/{watchlistId}	PUT	修改自选列表。
/iserver/watchlist/{watchlistId}	DELETE	删除自选列表。

常见数据结构

{
  "id": "watchlist-id",
  "name": "美股关注",
  "rows": [
    {
      "conid": 265598,
      "symbol": "AAPL",
      "assetClass": "STK"
    }
  ]
}

字段解释：

字段	中文说明
id	自选列表编号。
name	自选列表名称。
rows	列表中的合约。
conid	合约编号。
symbol	交易代码。
assetClass	资产类型。

创建列表示例

import requests

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

payload = {
    "name": "美股关注",
    "rows": [
        {"conid": 265598}
    ],
}

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

使用建议

场景	建议
展示行情面板	先读取自选列表，再用行情快照接口请求价格。
策略候选池	不要把 watchlist 当成下单信号，只作为关注范围。
修改列表	修改前先读取旧列表，避免覆盖用户已有内容。
删除列表	提供二次确认，避免误删。

修改类接口会改变用户 Gateway 会话里的数据。运行修改请求前，建议先在模拟或测试列表上操作。