接口差异被收敛到一层
各家交易所的行情、下单、撤单、账户接口都不同。CCXT 把它们统一成一套调用方式，OctoBot 只需面向这套接口编程，新增交易所的成本主要落在适配层而不是策略层。
OctoBot 项目研究站 · 交易所接入
OctoBot 交易所接入：CCXT 承载的 15+ 家范围
OctoBot 自己不去逐个对接交易所，而是通过 CCXT 这层统一库接入绝大多数加密交易所——依赖清单里 requests 与 aiohttp 的版本都标注了「与 ccxt 同步」，可见这层关系有多紧。官方 README 逐家点名了市场类型（现货还是合约、走 REST 还是 WebSocket），其中 Bybit 还带着一条时效性说明。下面把名单、凭据要求与边界一次列清。
- 一句话结论
- 经 CCXT 接入 15+ 交易所，但市场类型、订单能力与地区可用性要逐家核对。
- 适合谁
- 已经选好交易所、要确认凭据权限与接入前检查项的人
- 不适合谁
- 需要保证某家冷门交易所一定可用的人（本站未做连接实测）
- 最后核验
- 2026-10-12（官方仓库与文档口径）
- 对应版本
- 3.0.0-beta3（2026-10-08）／稳定线 2.1.1
- 实测状态
- 未在本机运行 OctoBot：本站没有运行环境与交易所凭据，内容为官方仓库与文档核对 + 作者分析，不含本站实测数据
OctoBot 交易引擎策略与订单管理在本体
CCXT 适配层统一各家交易所接口
交易所Binance / Coinbase / Hyperliquid …
API Key 凭据权限范围由你自己设置
Why CCXT
OctoBot 为什么用 CCXT：三件事被它解决了
理解这层抽象，就知道「支持某交易所」意味着什么。
连接器同样以 tentacle 形式存在
交易所支持并不是写死在主程序里的：官方提供从 CCXT 生成交易所 tentacle 的能力（由 tentacles_manager 负责）。所以「某家交易所能不能用」，取决于你安装的 tentacle 版本。
版本耦合是显式的
依赖清单里 requests 与 aiohttp 都写着「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 + 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，也没有交易所账号与 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 的路径。
确认 CCXT 是否已支持
先在 CCXT 的支持列表里查目标交易所。若 CCXT 已支持，OctoBot 侧通常只需生成对应 tentacle，而不是从零写接口。
用 tentacles_manager 生成
仓库内置了从 CCXT 生成交易所 tentacle 的能力（CLAUDE.md 提到 tentacle-manager agent 会「export from source、install from zip、generate CCXT exchange tentacles」）。
安装并重启
重新导出并安装 tentacles 后重启 OctoBot，新交易所才会出现在可选列表里。
先用小额度验证
新连接器属于未验证路径：先用最小资金或模拟盘验证下单、撤单、查询是否正常，再考虑放大。
贡献交易所支持的规矩：官方贡献指南要求交易所专属改动放进该交易所的 tentacle，并针对
dev 分支提 PR、配套 pytest 用例、符合 PEP8（行长 120）。与具体加密货币或交易对绑定的改动会被拒绝。Connection checklist
OctoBot 怎么连接交易所：从 API Key 到模拟下单要核对什么？
README 没有逐所图文配置，本清单是连接前的安全核对顺序；权限名称、测试网与白名单能力都要以交易所当前规则为准。
先确认交易所、市场类型与当前支持状态
对照上面的 README 清单，确认目标账户是现货还是合约；特别核对 Bybit 等带时效说明的项目，并查看 OctoBot 当前版本的官方指南与对应 tentacle。预期结果：明确所名、市场类型、实例版本及是否已有可用连接器，不把 README 的旧说明当实时可用保证。
在交易所控制台创建独立 API Key
先只开读取权限用于行情/账户连通验证；只有确实要发单时才开放必要交易权限。提现/资金划转权限不应开启。若交易所支持并且运行环境出口 IP 固定，再设置 IP 白名单。预期结果：新 Key 权限最小化且与个人日常登录凭据分离。
先在 OctoBot 配置连接，不急着实盘下单
按当前版本的官方配置向导输入凭据，确认选中的交易所 tentacle 与市场类型相符；密钥不要粘贴到命令历史、公开仓库、截图或工单。预期结果：界面显示连接状态或只读账户信息正常；若连接失败，先区分 DNS/网络、Key 权限、IP 白名单与交易所地区限制。
用模拟盘核对下单与撤单流程
确认策略、标的、仓位上限与模拟模式后，观察订单状态、日志、限频提示和重连行为。预期结果：模拟订单生命周期可追踪；这只能验证部分软件流程，不能证明真实成交、滑点、深度或交易所测试网兼容性。
建立撤销 Key 与紧急停机预案
记清交易所撤销 API Key 的入口、OctoBot 停止方式、未完成订单的核查步骤；发现异常先暂停实例并撤销 Key，再检查账户订单和访问日志。预期结果：不依赖机器人自身响应，也能从交易所侧切断授权。
| 现象 | 可能原因 | 先做什么 | 注意点 |
|---|---|---|---|
| 鉴权失败或提示 Key 无效 | Key 已被撤销、复制时缺字符、权限未开或账户受限 | 在交易所后台核对 Key 状态与权限范围，用只读 Key 复测连通 | 不要为排错方便而开放提现权限 |
| 提示 IP 不在白名单 | 未配置白名单，或出口 IP 变化（家宽、云主机重建） | 核对实例实际公网出口 IP 与白名单条目是否一致 | 部分网络是动态 IP，白名单可能需长期维护 |
| 能看到行情但无法下单 | 当前只开读权限；或该市场（如合约）未单独开通 | 确认交易权限与该市场账户状态，再确认交易所 tentacle 支持该市场类型 | 现货与合约权限在交易所侧通常分属不同开关 |
| 请求被限频或频繁重连 | 调用频率高于该所限制、网络抖动或代理不稳定 | 查日志中的限频与重连记录，评估策略动作频率 | 网格类高频动作更容易触发限制，README 未给出逐所额度 |
| 订单被拒或数量非法 | 数量/价格精度不符合交易对规则，或低于最小下单量 | 核对目标交易对的最小下单量、步长与小数位要求 | 各交易对规则不同，不能按另一个币对的经验套用 |
| 怀疑 Key 泄露 | Key 曾出现在截图、日志、工单或代码仓库 | 立即撤销该 Key，检查订单与调用记录，再重建最小权限 Key | 删除文件不等于消除历史副本，公开过的 Key 应视为永久失效 |
逐所细节边界：本站未持有交易所账号或 API Key，未验证 Binance、Coinbase、Kraken、MEXC、Hyperliquid、OKX 或 Bybit 的现行界面与权限字段。不要把这份通用安全清单当作逐所操作说明；实际权限、现货/合约可用性、测试网及 IP 白名单均以交易所和 OctoBot 当前官方文档为准。
Capability matrix
OctoBot 交易所能力矩阵：逐项对照与核验日期
官方 README 只声明经 CCXT 接入 15+ 交易所，并不逐项承诺市场类型与订单能力。下表把交易所拆成可核对的行。
| 交易所 | 现货 | 合约 | 接口 | 订单类型 | 最后核验 | 适用场景与注意点 |
|---|---|---|---|---|---|---|
| Binance | 官方点名支持 | 官方点名支持 | 经 CCXT（REST；WebSocket 取决于 CCXT 与交易所支持） | 市价/限价等常规类型，细则以交易所为准 | 2026-09（官方 README） | 主流现货与合约接入；地区可用性需自行确认 |
| Coinbase | 官方点名支持 | 未在 README 点名 | 同上 | 以交易所实际支持为准 | 2026-09（官方 README） | 面向合规现货市场；合约能力需按交易所文档确认 |
| Hyperliquid | 官方点名支持（需 API Keys） | 未在 README 点名 | 同上 | 以交易所实际支持为准 | 2026-09（官方 README） | 去中心化永续交易场景；凭据形式与常规中心化平台不同 |
| MEXC | 官方点名支持 | 未在 README 点名 | 同上 | 以交易所实际支持为准 | 2026-09（官方 README） | 小市值交易对较多，流动性与深度需自行核对 |
| Kucoin | 官方点名支持 | 官方点名支持 | 同上 | 以交易所实际支持为准 | 2026-09（官方 README） | 现货与合约并行；风控规则以官方为准 |
| Bybit | README 曾点名支持 | README 曾点名支持 | 同上 | 以交易所实际支持为准 | 2026-09（官方 README） | README 提到将恢复；接入前先看官方最新说明 |
| OKX | 未在 README 逐项点名 | 未在 README 逐项点名 | 同上 | 以交易所实际支持为准 | 2026-10（本站未实测） | 属 CCXT 覆盖范围，能否稳定使用需自行验证 |
| Bitget | 未在 README 逐项点名 | 未在 README 逐项点名 | 同上 | 以交易所实际支持为准 | 2026-10（本站未实测） | 同上；现货与合约权限开关分开设置 |
| Gate.io | 未在 README 逐项点名 | 未在 README 逐项点名 | 同上 | 以交易所实际支持为准 | 2026-10（本站未实测） | 同上；小币种较多，注意最小下单额 |
| HollaEx（白标交易所） | 官方支持其白标方案 | 以官方为准 | 同上 | 以交易所实际支持为准 | 2026-09（官方 README） | 自建白标交易所的部署形态，与公共交易所不同 |
| 接入前通用核对 | 为什么核 | 到哪里看 | 适用场景 | 注意点 |
|---|---|---|---|---|
| 最小下单额与数量精度 | 低于门槛会被交易所直接拒绝，表现为「策略不下单」 | 交易所的交易规则页 | 小资金账户 | 每个交易对的门槛与精度都不同 |
| 手续费档位与 maker/taker 差别 | 直接决定网格与 DCA 这类高频动作能否成立 | 账户费率页与官方费率表 | 高频动作策略 | 档位随交易量与持仓变化，别按理想费率估算 |
| 现货与合约权限分开 | 只勾现货会拿不到合约数据，下单也会失败 | API 管理页的权限开关 | 合约策略 | 合约还涉及杠杆与仓位模式设置 |
| IP 白名单与提现权限 | 把泄露后的影响面压到最小 | API 管理页 | 所有实盘账户 | 提现权限始终不要开 |
| 地区可用性 | 部分地区无法注册或无法调用接口 | 交易所官方公告 | 海外云主机部署 | 可用性会变化，部署前先确认 |
| 测试网（若有） | 可在不承担资金风险的前提下验证链路 | 交易所测试网文档 | 首次联调 | 测试网流动性差，不要用它评估成交质量 |
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 限频、行情中断、极端行情下的滑点都是独立问题。官方免责声明也要求自负盈亏，并建议先在模拟模式运行一段时间。