构建 CLOB 连接器
交易所 API 要求¶
参见 交易所 API 要求 了解支持最新 Hummingbot 现货和永续连接器标准所需的交易所 API 要求。
构建连接器¶
为了更深入地了解 Hummingbot 连接器的工作原理，我们建议阅读 Hummingbot 原始技术创始人的以下工程文章：
以下页面提供了有关连接器的各种组件和类的更多详细信息：
- 连接器架构：连接器工作原理概述
- 订单生命周期和市场事件：连接器如何处理订单生命周期
- 使用 API 限流器处理速率限制：使用
AsyncThrottler类处理交易所速率限制 - 调试和测试连接器：测试和调试连接器的各种方法
现货连接器¶
现货连接器为交易所提供的基于现货订单簿的市场提供基于 WebSocket 和 REST 的集成，这些交易所可能是中心化交易所 (CEX) 或去中心化交易所 (DEX)。每个连接器都是 hummingbot/connector/exchange 文件夹中的一个文件夹。
- 现货连接器 v2.1 Notion 模板：使用此模板构建符合最新标准的
spot连接器，以使其可用于 V2 策略。 - 现货连接器开发者检查清单：类似于 Notion 模板，此页面提供了每个类的关键步骤和主要组件及功能的检查清单
- 现货连接器 QA 检查清单：我们的 QA 团队在批准
spot连接器之前会执行这些测试
永续连接器¶
永续合约连接器为交易所提供的基于永续期货订单簿的市场提供基于WebSocket和REST的集成，这些交易所可能是中心化交易所（CEX）或去中心化交易所（DEX）。每个连接器都是 hummingbot/connector/derivative 文件夹中的一个文件夹。按照惯例，这些连接器名称以 _perpetual 结尾。
- Perp Connector v2.1 Notion 模板：使用此模板构建符合最新标准的
perp连接器，使其可以与 V2 策略 一起使用。 - Perp 连接器开发者检查清单：类似于 Notion 模板，此页面提供了每个类的关键步骤和主要组件及功能的检查清单
- Perp 连接器 QA 检查清单：我们的 QA 团队在批准
perp连接器之前会进行这些测试
贡献连接器¶
将交易所连接器引入 Hummingbot 代码库需要 Hummingbot 基金会团队和贡献开发者共同承诺维护高质量的代码和软件可靠性标准。
我们鼓励并欢迎社区贡献新的连接器，但需遵守以下指南和期望。
- 连接器文件夹：一个包含基于上述示例的完整连接器文件的文件夹。
- 遵循标准：连接器应通过其类型的开发者和 QA 检查清单
- 单元测试： 拉取请求应通过代码覆盖率检查
- 文档：向
hummingbot-site仓库提交配套文档拉取请求 - 内联代码注释 特别是对于与模板明显不同的任何代码
以下是将新连接器合并到代码库的过程概述：
- Fork Hummingbot 或 Gateway 仓库并添加满足上述相应要求的
spot或perp连接器。 - 按照 贡献指南 在 GitHub 中向
development分支提交包含连接器的拉取请求。 - 在 Hummingbot NCP 快照 中提交 新连接器提案
附加资源¶
如有问题，请访问我们 Discord 上的 #developer-chat 频道。