OctoBot 项目研究站 · 交易所接入

OctoBot 交易所接入:CCXT 承载的 15+ 家范围

OctoBot 自己不去逐个对接交易所,而是通过 CCXT 这层统一库接入绝大多数加密交易所——依赖清单里 requests 与 aiohttp 的版本都标注了「与 ccxt 同步」,可见这层关系有多紧。官方 README 逐家点名了市场类型(现货还是合约、走 REST 还是 WebSocket),其中 Bybit 还带着一条时效性说明。下面把名单、凭据要求与边界一次列清。

承载方式:CCXT 统一库范围:README 点名 15+ 家(非穷尽)依据 README 与 requirements.txt(2026-09 核验)
OctoBot 交易引擎策略与订单管理在本体
CCXT 适配层统一各家交易所接口
交易所Binance / Coinbase / Hyperliquid …
API Key 凭据权限范围由你自己设置
交易所接入分层示意(依据 README 与依赖说明整理,非官方图)。
Why CCXT

OctoBot 为什么用 CCXT:三件事被它解决了

理解这层抽象,就知道「支持某交易所」意味着什么。

接口差异被收敛到一层

各家交易所的行情、下单、撤单、账户接口都不同。CCXT 把它们统一成一套调用方式,OctoBot 只需面向这套接口编程,新增交易所的成本主要落在适配层而不是策略层。

连接器同样以 tentacle 形式存在

交易所支持并不是写死在主程序里的:官方提供从 CCXT 生成交易所 tentacle 的能力(由 tentacles_manager 负责)。所以「某家交易所能不能用」,取决于你安装的 tentacle 版本。

版本耦合是显式的

依赖清单里 requestsaiohttp 都写着「sync with ccxt」:这两者的版本要跟着 CCXT 走,说明这一层是核心依赖,升级时不能随手改。

Exchange list

OctoBot 支持哪些交易所:README 点名的市场类型

下表仅覆盖官方 README 明确提到的部分;完整名单与最新状态指向官方文档。

交易所README 说明的市场类型接口方式凭据 / 备注
Binance现货 + 合约REST + WebSocket需 API Key;README 链接带推广参数,本站不复制
Coinbase现货REST + WebSocket需 API Key
Bybit现货 + 合约REST + WebSocket⚠️ README 注明「由于近期更新,Bybit API 将很快再次在 OctoBot 上可用」——属时效性自述,以官方为准
Hyperliquid现货REST + WebSocketREADME 明确「需 API Keys」
MEXC现货REST + WebSocket需 API Key;README 链接带邀请码,本站不复制
Kucoin现货 + 合约REST + WebSocket需 API Key
HollaEx 系(白标)视该所配置而定REST + WebSocketREADME 称「所有 HollaEx 驱动的交易所」都支持;官方另有 HollaEx 账户设置指南
其他(README 列举)以各家实际支持为准视实现而定OKX、Binance US、Crypto.com、HTX、Bitget、BingX、CoinEx、BitMart、Phemex、Gate.io、Ascendex 等;README 用「Many other such as …」表述,非穷尽
本站未做任何连接验证:本机没有安装运行 OctoBot,也没有交易所账号与 API Key。上表全部来自官方 README 的文字说明,不代表我们实测过任何一家交易所的连接、下单或稳定性;「Bybit 将恢复」这类时效性表述尤其需要以官方文档/公告为准。
Credentials

OctoBot 的 API Key 权限要怎么设:必须先想清楚的事

机器人要下单就必须拿到凭据,这是风险最集中的一环。

项目要点适用场景注意点
凭据存在哪OctoBot 自托管在你的机器/服务器上,配置数据在 user/ 目录(Docker 部署时是数据卷)本地或自有服务器部署README 的新版三大支柱之一就是「自托管:私钥永不离开你的设备」
权限范围交易所侧通常可细分读权限、交易权限、提现权限;README 未给出权限配置细节先用最小权限验证链路能下单的机器人不需要提现权限——这是最常被忽略的一条
先只读验证可用只读 Key 先确认行情与账户能通首次接入某家交易所只读阶段不需要给交易权限
IP 白名单多家交易所支持绑定调用来源 IP服务器部署、IP 固定家用宽带 IP 常变化,绑定前先确认网络条件
Key 泄露的影响持有交易权限的 Key 泄露等于把下单权交出去任何实盘场景不要提交到版本库、不要贴进截图或工单
与「资金安全」的关系自托管能减少第三方托管风险,但不能消除市场风险与程序缺陷风险做风险判断时官方免责声明要求自负盈亏,见风险与许可页
Add an exchange

想给 OctoBot 加一家 README 没点名的交易所怎么做

官方给了从 CCXT 生成交易所 tentacle 的路径。

  1. 确认 CCXT 是否已支持

    先在 CCXT 的支持列表里查目标交易所。若 CCXT 已支持,OctoBot 侧通常只需生成对应 tentacle,而不是从零写接口。

  2. 用 tentacles_manager 生成

    仓库内置了从 CCXT 生成交易所 tentacle 的能力(CLAUDE.md 提到 tentacle-manager agent 会「export from source、install from zip、generate CCXT exchange tentacles」)。

  3. 安装并重启

    重新导出并安装 tentacles 后重启 OctoBot,新交易所才会出现在可选列表里。

  4. 先用小额度验证

    新连接器属于未验证路径:先用最小资金或模拟盘验证下单、撤单、查询是否正常,再考虑放大。

贡献交易所支持的规矩:官方贡献指南要求交易所专属改动放进该交易所的 tentacle,并针对 dev 分支提 PR、配套 pytest 用例、符合 PEP8(行长 120)。与具体加密货币或交易对绑定的改动会被拒绝。
FAQ

OctoBot 交易所接入常见问题:支持多少家、要什么凭据

到底支持多少家交易所?

README 的表述是「15+ exchanges」并逐家点名了 Binance、Coinbase、Bybit、Hyperliquid、MEXC、Kucoin 与 HollaEx 系,另列 OKX、Gate.io、Bitget 等;它同时把完整名单指向官方文档。所以准确说法是「README 点名的部分见本页表格,完整范围以官方文档为准」。

Bybit 现在能用吗?

README 的原话是「由于近期更新,Bybit API 将很快再次在 OctoBot 上可用」,说明当时并不可用。这属于时效性信息,且本站无法实测,请以官方文档或公告为准确认当前状态。

连交易所需要什么?

需要该交易所的 API Key(部分所如 Hyperliquid README 明确要求 API Keys)。权限建议先只读、再按需开放交易权限;提现权限与机器人下单无关,不应开放。凭据保存在你自己的部署环境里(user/ 目录或对应数据卷)。

能在测试网/模拟环境验证吗?

OctoBot 提供模拟盘(paper trading)与内置回测来验证策略行为;至于各家交易所各自的测试网支持情况,README 未展开说明,需要以官方文档为准。本站未做实测。

为什么页面里不直接给交易所注册链接?

官方 README 中多处交易所链接带邀请码或返佣参数(Binance 的 ref、MEXC 的 inviteCode、Kucoin 的 rcode 等)。复制这些参数会改变页面的中立性,所以本站只写交易所名称与市场类型,不复制任何推广链接。

交易所连上了就等于能稳定运行吗?

不等于。连接成功只是链路通了;订单是否按预期成交、API 限频、行情中断、极端行情下的滑点都是独立问题。官方免责声明也要求自负盈亏,并建议先在模拟模式运行一段时间。

OctoBot 的交易所就位后,下一步怎么把它跑起来

四条安装路径的前置条件、端口与数据卷,在安装与运行页里逐条列出。