使用模拟账户
使用 Client Portal API 前，建议先用 Paper Trading 账户测试。Paper 可以降低真实资金风险，但它仍然遵守 IBKR 的登录、权限、session 和行情规则。
Client Portal Gateway 登录页面没有 Live / Paper 滑块。要进入 Paper 环境，必须使用 Paper Trading 专用用户名和对应密码。
| 项目 | Live | Paper |
|---|---|---|
| 登录用户名 | Live 用户名 | Paper Trading 专用用户名 |
| 资金风险 | 真实账户 | 模拟账户 |
| 行情权限 | 取决于用户名订阅 | 仍可能受行情权限限制 |
| 订单结果 | 真实交易 | 模拟撮合，不代表真实成交质量 |
如何找到 Paper 用户名
Section titled “如何找到 Paper 用户名”官方文档给出的路径是：
- 用 Live 用户名登录 Client Portal。
- 点击右上角头像图标。
- 进入 Settings。
- 在 Account Configuration 下选择 Paper Trading Account。
- 查看 Paper Trading Username 和 Paper Trading Account Number。
- 如果不知道 Paper 密码，可使用 Reset Paper Trading Password 重置。
拿到 Paper 用户名和密码后，再用它登录 Client Portal Gateway。
登录后先查什么
Section titled “登录后先查什么”Paper 登录成功后，不要马上下单。建议先按这个顺序检查：
| 顺序 | 检查 | 目的 |
|---|---|---|
| 1 | /sso/validate | 确认外层登录会话有效。 |
| 2 | /iserver/auth/status | 确认 brokerage session 已认证。 |
| 3 | 账户列表 endpoint | 确认能看到 Paper 账户。 |
| 4 | 合约搜索 | 确认能拿到目标合约的 conid。 |
| 5 | 订单预览 | 先看确认信息、保证金和风险提示。 |
Paper 账户仍然需要注意什么
Section titled “Paper 账户仍然需要注意什么”- 仍然需要完成登录和 2FA。
- 仍然可能遇到 session 超时。
- 仍然可能和同一 Paper 用户名的其他登录产生竞争。
- 仍然可能没有某些行情订阅或产品权限。
- 模拟成交、滑点、排队和真实市场不完全一致。
适合先测试的功能
Section titled “适合先测试的功能”| 功能 | 建议 |
|---|---|
| 认证状态 | 先确认 /sso/validate 和 /iserver/auth/status。 |
| 账户列表 | 确认 Paper 账户 ID 可见。 |
| 合约搜索 | 用常见股票或 ETF 找 conid。 |
| 订单预览 | 先预览，再做极小数量低风险订单。 |
| 撤单 | 提交测试订单后立即确认撤单和订单状态。 |
Paper 测试通过，只能说明 API 链路和字段结构基本正确。上线到 Live 前还要重新检查真实账户权限、市场数据订阅、交易许可、订单风险提示、风控参数和日志脱敏。