接口差异被收敛到一层
各家交易所的行情、下单、撤单、账户接口都不同。CCXT 把它们统一成一套调用方式,OctoBot 只需面向这套接口编程,新增交易所的成本主要落在适配层而不是策略层。
OctoBot 项目研究站 · 交易所接入
OctoBot 自己不去逐个对接交易所,而是通过 CCXT 这层统一库接入绝大多数加密交易所——依赖清单里 requests 与 aiohttp 的版本都标注了「与 ccxt 同步」,可见这层关系有多紧。官方 README 逐家点名了市场类型(现货还是合约、走 REST 还是 WebSocket),其中 Bybit 还带着一条时效性说明。下面把名单、凭据要求与边界一次列清。
理解这层抽象,就知道「支持某交易所」意味着什么。
各家交易所的行情、下单、撤单、账户接口都不同。CCXT 把它们统一成一套调用方式,OctoBot 只需面向这套接口编程,新增交易所的成本主要落在适配层而不是策略层。
交易所支持并不是写死在主程序里的:官方提供从 CCXT 生成交易所 tentacle 的能力(由 tentacles_manager 负责)。所以「某家交易所能不能用」,取决于你安装的 tentacle 版本。
依赖清单里 requests 与 aiohttp 都写着「sync with ccxt」:这两者的版本要跟着 CCXT 走,说明这一层是核心依赖,升级时不能随手改。
下表仅覆盖官方 README 明确提到的部分;完整名单与最新状态指向官方文档。
| 交易所 | README 说明的市场类型 | 接口方式 | 凭据 / 备注 |
|---|---|---|---|
| Binance | 现货 + 合约 | REST + WebSocket | 需 API Key;README 链接带推广参数,本站不复制 |
| Coinbase | 现货 | REST + WebSocket | 需 API Key |
| Bybit | 现货 + 合约 | REST + WebSocket | ⚠️ README 注明「由于近期更新,Bybit API 将很快再次在 OctoBot 上可用」——属时效性自述,以官方为准 |
| Hyperliquid | 现货 | REST + WebSocket | README 明确「需 API Keys」 |
| MEXC | 现货 | REST + WebSocket | 需 API Key;README 链接带邀请码,本站不复制 |
| Kucoin | 现货 + 合约 | REST + WebSocket | 需 API Key |
| HollaEx 系(白标) | 视该所配置而定 | REST + WebSocket | README 称「所有 HollaEx 驱动的交易所」都支持;官方另有 HollaEx 账户设置指南 |
| 其他(README 列举) | 以各家实际支持为准 | 视实现而定 | OKX、Binance US、Crypto.com、HTX、Bitget、BingX、CoinEx、BitMart、Phemex、Gate.io、Ascendex 等;README 用「Many other such as …」表述,非穷尽 |
机器人要下单就必须拿到凭据,这是风险最集中的一环。
| 项目 | 要点 | 适用场景 | 注意点 |
|---|---|---|---|
| 凭据存在哪 | OctoBot 自托管在你的机器/服务器上,配置数据在 user/ 目录(Docker 部署时是数据卷) | 本地或自有服务器部署 | README 的新版三大支柱之一就是「自托管:私钥永不离开你的设备」 |
| 权限范围 | 交易所侧通常可细分读权限、交易权限、提现权限;README 未给出权限配置细节 | 先用最小权限验证链路 | 能下单的机器人不需要提现权限——这是最常被忽略的一条 |
| 先只读验证 | 可用只读 Key 先确认行情与账户能通 | 首次接入某家交易所 | 只读阶段不需要给交易权限 |
| IP 白名单 | 多家交易所支持绑定调用来源 IP | 服务器部署、IP 固定 | 家用宽带 IP 常变化,绑定前先确认网络条件 |
| Key 泄露的影响 | 持有交易权限的 Key 泄露等于把下单权交出去 | 任何实盘场景 | 不要提交到版本库、不要贴进截图或工单 |
| 与「资金安全」的关系 | 自托管能减少第三方托管风险,但不能消除市场风险与程序缺陷风险 | 做风险判断时 | 官方免责声明要求自负盈亏,见风险与许可页 |
官方给了从 CCXT 生成交易所 tentacle 的路径。
先在 CCXT 的支持列表里查目标交易所。若 CCXT 已支持,OctoBot 侧通常只需生成对应 tentacle,而不是从零写接口。
仓库内置了从 CCXT 生成交易所 tentacle 的能力(CLAUDE.md 提到 tentacle-manager agent 会「export from source、install from zip、generate CCXT exchange tentacles」)。
重新导出并安装 tentacles 后重启 OctoBot,新交易所才会出现在可选列表里。
新连接器属于未验证路径:先用最小资金或模拟盘验证下单、撤单、查询是否正常,再考虑放大。
dev 分支提 PR、配套 pytest 用例、符合 PEP8(行长 120)。与具体加密货币或交易对绑定的改动会被拒绝。README 的表述是「15+ exchanges」并逐家点名了 Binance、Coinbase、Bybit、Hyperliquid、MEXC、Kucoin 与 HollaEx 系,另列 OKX、Gate.io、Bitget 等;它同时把完整名单指向官方文档。所以准确说法是「README 点名的部分见本页表格,完整范围以官方文档为准」。
README 的原话是「由于近期更新,Bybit API 将很快再次在 OctoBot 上可用」,说明当时并不可用。这属于时效性信息,且本站无法实测,请以官方文档或公告为准确认当前状态。
需要该交易所的 API Key(部分所如 Hyperliquid README 明确要求 API Keys)。权限建议先只读、再按需开放交易权限;提现权限与机器人下单无关,不应开放。凭据保存在你自己的部署环境里(user/ 目录或对应数据卷)。
OctoBot 提供模拟盘(paper trading)与内置回测来验证策略行为;至于各家交易所各自的测试网支持情况,README 未展开说明,需要以官方文档为准。本站未做实测。
官方 README 中多处交易所链接带邀请码或返佣参数(Binance 的 ref、MEXC 的 inviteCode、Kucoin 的 rcode 等)。复制这些参数会改变页面的中立性,所以本站只写交易所名称与市场类型,不复制任何推广链接。
不等于。连接成功只是链路通了;订单是否按预期成交、API 限频、行情中断、极端行情下的滑点都是独立问题。官方免责声明也要求自负盈亏,并建议先在模拟模式运行一段时间。