R | Protocol（Rithmic API）
R | Protocol 是 Rithmic 的应用程序接口，第三方软件通过它登录某个 Rithmic 系统、订阅行情并路由委托。使用它是一项权限，与使用 Rithmic 自家的 R | Trader Pro 平台是两回事。
Senzoukria · 术语表 · 更新于 2026 年 9 月
这套 API 的结构
客户端通过一个安全的 WebSocket 地址连上 Rithmic 网关，先索取该网关所服务的系统列表，再用用户名和密码登录其中一个系统。随后它对自己需要的各个 plant 分别开会话：行情 plant 取成交与深度，报单 plant 管账户，历史 plant 取过去的逐笔或 K 线，还有盈亏 plant。每一个会话都由签发该登录的机构单独授权。
由于这套协议是向外部软件开放的，Rithmic 和签发机构会控制谁可以使用它。厂商应用要注册并具名；一个账户可以被允许用某个应用而不被允许用另一个，而演示试用账号根本不提供 API。
- 网关：接入点，按地理位置选择，其中有些仅限主机托管。
- 系统名：标识该网关上的某个券商或自营公司环境。
- Plant：彼此独立的登录会话，各有自己的心跳和权限。
API 登录成功并不能说明什么
- 不能说明该账户订阅了你请求的品种或交易所。
- 不能说明有深度，或者深度给到多少档。
- 不能说明你请求的日期有历史逐笔或历史 K 线；历史上的拒绝访问回应属于券商权限，不是软件设置。
- 不能说明该账户在这个阶段被允许手动或自动报单。
在 Senzoukria 里
桌面端在 Rithmic Direct 连接卡上直接实现 R | Protocol，不经桥接。卡片开放了「Gateway URL」（必须以 wss:// 开头）、一个包含自定义项的接入点列表，以及一个「Fetch live system list from gateway」操作——它会先查询网关，你再去挑「System name」。凭据存入操作系统钥匙串，绝不应该被填进任何网站表单。
同一张卡片上的提示说明：免费的 Rithmic 演示账号无法连接，因为 Rithmic 不向演示账号提供 R | Protocol API；R | Trader Pro 接受同一个登录，并不改变这一点。当登录成功却没有任何逐笔到达时，连接诊断会按出现频率列出可能的原因，而不是丢给你一张空图表——因为休市的市场和坏掉的数据流在屏幕上长得一模一样。供应商要求的 Rithmic 版权标注显示在「关于」页面上。
常见的错误
- 填了 R | Trader Pro 的网关，还指望 API 网关是同一个。
- 凭记忆挑系统名，而不去拉取实时列表。
- 把一次被拒的历史请求读成图表的 bug。
- 在机构限制并发会话数时，把一个 API 登录同时给两个应用用。
相关内容
其他语言版本
常见问题
- R | Protocol 和 Rithmic 的免费试用是一回事吗？
- 不是。14 天免费演示在 Rithmic 自家平台内提供实时行情，但 API 不向演示账号开放，所以无论系统名是什么，第三方软件都无法用那套凭据登录。必须要有一个由券商或自营公司签发、且带 API 访问权限的账户。
- 使用这套 API 要额外付费吗？
- 费用由签发的券商或自营公司以及各交易所设定，不由图表软件设定。有的机构把 API 访问包含在账户套餐里，有的另行收费或按账户阶段加以限制；请以书面方式向机构询问，并把答复保存下来。