阅读时间 … 分钟

适用于 Bitfinex 交易策略的 AI 原生运行环境

在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署到托管云端运行环境，提供一流的 MCP 控制、日志和区域选择。

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
Bitfinex
平台类型
加密货币交易所（现货、杠杆、衍生品）
资产类别
加密货币
支持的产品
现货、杠杆（由点对点 funding pool 资助）、derivatives.bitfinex.com 上的衍生品（永续合约）。通过 Bitfinex Securities 交易的证券代币作为独立场所运营。
运行环境模式
容器化策略运行环境 (Kubernetes)
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 Bitfinex REST v2、WebSocket v2、Honeycomb FIX 4.4、CCXT (bitfinex, bitfinex2)、Freqtrade（通过 CCXT）、自定义
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、密钥管理、MCP 控制
Bitfinex 角色
交易所账户、API 密钥签发、市场接入、订单撮合、托管、结算
关联关系
TradingHost 是独立的，不隶属于 Bitfinex 或 iFinex Financial Technologies Limited。Bitfinex 不向美国居民提供服务。

第 02 部分 · Bitfinex 平台功能

Bitfinex 平台功能

Bitfinex 通过 REST v2 和 WebSocket v2 提供现货、杠杆和衍生品交易，并为机构客户提供 Honeycomb FIX 4.4。其杠杆交易由点对点 funding pool 资助，而非交易所直接提供，这使得出借端本身也成为一个策略维度。永续合约在 derivatives.bitfinex.com 上交易，采用 F0 symbols 命名规范（例如 tBTCF0:USTF0），且需要在专属衍生品钱包中持有 USDt0。具体端点细节可能会随时间变化；其基本架构是稳定的，具体的速率限制权重、手续费等级和交易对列表请参考 Bitfinex 官方文档。

市场与策略模式

  • 针对 tBTCUSD 和 tETHUSD 的现货做市
  • 通过点对点 funding pool 资助的杠杆交易
  • 在 derivatives.bitfinex.com 上的永续合约交易（F0 symbols）
  • 出借端的资金利率策略（fUSD、fBTC 报价）
  • Honeycomb FIX 4.4 机构高频交易
  • 基于 sub-accounts 范围的策略隔离
  • 只挂单 (Post-only) 和隐藏订单放置（订单标志）
  • 双向限价单 (OCO) 触发逻辑

API 接口

产品范围
现货、杠杆（funding pool）、衍生品（通过 F0 symbols 的永续合约，需在衍生品钱包中持有 USTF0）、证券（独立）。通过 tTESTBTCF0:TESTUSDTF0 进行模拟交易。
连接方式
REST v2（公共端点位于 api-pub.bitfinex.com，认证端点位于 api.bitfinex.com）、WebSocket v2（wss://api-pub.bitfinex.com/ws/2 和 wss://api.bitfinex.com/ws/2），以及面向机构的 Honeycomb FIX 4.4。v1 REST 和 WS 仍可用，但推荐使用 v2。
身份验证
API 密钥和私钥，配合严格递增的 nonce 和 HMAC-SHA384 签名。nonce ceiling 9007199254740991。每个并发客户端需要独立的密钥以避免 nonce 冲突。权限按密钥范围划分（账户信息、订单、杠杆、资金、提现）。

具体细节请参考 Bitfinex

具体端点、速率限制权重、交易对列表、手续费等级和版本历史请参考 Bitfinex 文档。请以官方文档为准。

第 03 部分 · 用 AI 构建

用 AI 构建您的 Bitfinex 策略

选择一种集成方式，派生 (fork) 一个 TradingHost 框架模板，然后在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 和基于 CLI 的 AI 智能体都适用于相同的 GitHub 原生部署循环。Bitfinex 独特的杠杆模型（由点对点 funding pool 资助，而非交易所提供）以及独立衍生品交易场所上的 F0 symbol 规范，决定了各个框架如何映射到该交易场所。

  • 原生 Bitfinex API

    通过 REST v2 和 WebSocket v2 直接控制 Bitfinex 特有的行为、账户数据和订单执行逻辑。

  • CCXT

    跨 Bitfinex 和其他加密货币交易所的通用接口。CCXT 通过两个 ID 暴露 Bitfinex：`bitfinex` (v1) 和 `bitfinex2` (v2)。新编写的代码应指向 `bitfinex2`。

    开始使用 CCXT

  • Freqtrade 或 Hummingbot

    使用其策略结构和配置模型的框架化部署。Freqtrade 通过 CCXT 连接 Bitfinex；Hummingbot 历史上提供 Bitfinex 现货连接器。

    开始使用 Freqtrade开始使用 Hummingbot

  • 自定义连接器

    您自己的内部交易引擎或专有的 Bitfinex 集成，包括面向机构客户的 Honeycomb FIX 4.4。

框架对 Bitfinex 产品的支持情况

支持范围因框架而异。原生 REST v2 配合 WebSocket v2 覆盖了完整的 Bitfinex 功能，包括衍生品交易场所上的 F0 永续合约和 funding pool。CCXT 通过两个 ID（`bitfinex` 对应 v1，`bitfinex2` 对应 v2）暴露 Bitfinex；推荐新策略使用 `bitfinex2`。Freqtrade 通过 CCXT 连接 Bitfinex 现货，官方不支持杠杆和期货。Hummingbot 提供仅限现货的 Bitfinex 连接器。

框架现货杠杆永续
Native Bitfinex (REST v2 + WS v2)已支持已支持已支持
CCXT (bitfinex, bitfinex2)已支持部分支持部分支持
Freqtrade已支持部分支持未记录支持
Hummingbot已支持未记录支持未记录支持

✓ 官方框架文档确认支持。“部分”或“受限”表示框架可接入该功能，但未覆盖完整的 Bitfinex 产品。“无”表示官方文档未说明支持。工作流链接指向目前正在编写的 /workflows/ 页面。

TradingHost 不强求特定的框架，它只负责运行您的项目。

使用 AI 编写

上述框架模板与 AI IDE 是绝佳的搭配。TradingHost 的 MCP 控制面实现了闭环：AI 工具可以与您一同检查部署、查看日志并管理运行环境，但绝不会介入交易执行路径。

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

Bitfinex 提供交易所和 API 访问。TradingHost 则提供生产环境，用于运行您连接到 Bitfinex 的策略。

无需在笔记本电脑、台式机、通用 VPS 或手动配置的服务器上运行策略代码，您只需从 GitHub 部署到由 TradingHost 托管的容器运行环境中。

您

  • 您的代码库包含您的代码。
  • 您的部署定义了其运行方式。
  • 您的策略连接到 Bitfinex。

TradingHost

  • 保持运行环境持续在线。
  • 呈现日志和健康状况检查。
  • 区域选择。
  • 受控的部署环境。

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

    将 TradingHost 指向您现有的策略代码库，或者派生 (fork) 一个 TradingHost 框架运行环境（CCXT、Freqtrade 或 Hummingbot）以获取可直接运行的基础模板。

  3. 步骤 03

    部署至 TradingHost 容器

    选择一个区域（EU 或 US-East），提供策略所需的环境变量（Bitfinex API key 与 secret 等），然后进行部署。TradingHost 会从代码仓库构建您的容器，并在托管的 Kubernetes 基础设施上运行您的策略。由于 Bitfinex 严格要求每个 key 的 nonce 必须单调递增，因此每个工作进程请仅运行一个 API key；若要运行多个并发策略，请在 sub-accounts 下为每个策略分别创建 key，以避免在共享的 nonce 空间中发生冲突。无需在本地安装 Docker。

  4. 步骤 04

    监控日志与健康状况

    通过 TradingHost 控制面板实时查看日志、健康状况和运行状态。该界面同样支持在任何 AI IDE 中通过 MCP 进行访问，方便 Cursor、Claude Code 或 CLI 智能体与您协同读取部署状态并管理运行环境。

  5. 步骤 05

    更新与重新部署

    将代码更改推送到 GitHub 的主分支（main branch），TradingHost 便会自动重新部署。

部署

Section 05 · 运维说明

Bitfinex 运维说明

在容器化云端运行环境中实际运行 Bitfinex 策略时可能遇到的陷阱，这些内容既不在 Bitfinex 的文档中，也不在框架的 README 中。以下所有说明均引用或转述自 Bitfinex 官方文档；部署侧的指南源自于在 TradingHost 上运行这些策略的实际经验。

  1. 01 · Nonce 单调性

    每个密钥严格递增，且有硬性上限

    每个经过身份验证的请求都需要针对每个 API 密钥提供严格递增的 nonce；该值还具有 9007199254740991 的硬性上限 (nonce ceiling 9007199254740991)。共享密钥的并发进程会发生冲突。解决方案：每个运行的策略或容器使用一个 API 密钥，并通过 sub-accounts 进行范围隔离。

    来源Bitfinex requirements and limitations

  2. 02 · v1 与 v2

    v2 是目前支持的演进方向

    REST v1 仍使用 X-BFX-APIKEY、X-BFX-PAYLOAD 和 X-BFX-SIGNATURE 请求头以及 Base64 编码的 JSON 载荷进行身份验证。v2 是目前支持的路径，具有更快的端点和统一的响应格式；新编写的代码应以 v2 为目标。

    来源Bitfinex API introduction

  3. 03 · sub-accounts

    一个主账户，多个 sub-accounts，独立的 nonce 空间

    Bitfinex 支持在一个主账户下开设多个 sub-accounts。每个 sub-account 拥有独立的 API 密钥、钱包和 nonce 空间，这是隔离策略并避免 nonce 冲突的推荐方式。

    来源Bitfinex API access

  4. 04 · funding pool

    杠杆资金来自点对点借贷，而非交易所提供

    Bitfinex 的杠杆资金由点对点贷方提供，他们发布 fUSD、fBTC 等资金报价。借贷策略和放贷策略都在同一个资金账本上运行；`No Var Rates` 标志 (524288) 可在匹配时排除浮动利率报价。

    来源Bitfinex flag values

  5. 05 · 衍生品分离

    永续合约作为 F0 symbols 在独立板块交易

    永续合约作为 F0 symbols（例如 tBTCF0:USTF0、tETHF0:USTF0）进行交易，由 iFinex Financial Technologies Limited 运营。交易这些合约需要将 USDt0 存入专属的衍生品钱包；请使用 Transfer Between Wallets 端点划转资金。默认杠杆为 10 倍，可在下单时设置为 1 到 100 倍。

    来源Bitfinex derivatives

  6. 06 · Honeycomb FIX

    FIX 4.4 属于受限的机构通道

    FIX 是机构级接口，无法直接在标准 API 页面自主开通。在 TradingHost 部署中依赖 FIX 之前，请预留时间完成额外的准入和凭证审核流程。

    来源Bitfinex Honey Framework (FIX) reference

  7. 07 · 速率限制

    单 IP REST 限制与 WebSocket 连接上限

    REST 限制约为单 IP 每分钟 10 到 90 次请求（取决于具体端点），超出限制将触发 60 秒的冷却期。WebSocket 限制：每 15 秒最多 5 个身份验证连接，每分钟最多 20 个公共连接，每个连接最多订阅 25 个频道。针对多市场铺开的策略应批量订阅频道，而不是开启大量套接字连接。

    来源Bitfinex requirements and limitations

Section 06 · 适用场景

适用场景

TradingHost Bitfinex 运行环境最适合用于：

  • 寻找深度优秀、长期运行的 USD/USDT 交易场所的现货做市商
  • 偏好点对点 funding pool 模式的杠杆交易员
  • 针对 fUSD、fBTC、fETH 报价运行利率策略的资金端放贷人
  • 使用 tBTCF0:USTF0 及其他 F0 交易对的永续合约交易员
  • 在 HTTP 和 WebSocket 之外，还需要 FIX 4.4 连接能力的机构交易台

连接 GitHub 并创建首个策略完全免费。

Section 08 · 常见问题

常见问题

没有。TradingHost 是独立的，与 Bitfinex 或 Bitfinex 衍生品板块的运营商 iFinex Financial Technologies Limited 均无任何关联。

不会。您的策略代码会根据您自己的逻辑、账户权限和集成方式连接到 Bitfinex 并发送指令。TradingHost 仅提供运行该代码的托管环境。

不提供。Bitfinex API 访问权限由 Bitfinex 官方提供。您需要自行负责您的 Bitfinex 账户、API 权限、凭证以及对 Bitfinex 条款的合规性。

不是。TradingHost 是运行您策略代码的云端托管环境。我们不提供交易信号、AI 预测模型或预建的机器人。使用 TradingHost，您可以自己编写或生成策略（通常配合 Cursor 或 Claude Code），将其作为代码保存在 GitHub 中，并使用 TradingHost 在生产环境中运行。3Commas、Cryptohopper 等产品拥有策略逻辑本身，而 TradingHost 则是运行您自己的策略。

AWS 和 DigitalOcean 为您提供的是原始算力。您需要自己处理操作系统更新、容器编排、日志传输、密钥轮换、区域容灾和在线率监控。TradingHost 则为您提供专为交易策略打造的托管环境：GitHub 原生部署、来自 AI IDE 的 MCP 驱动控制，以及开箱即用的日志和健康监测界面。如果您想自己运营基础设施，AWS 完全可行。如果您希望将运行环境作为托管服务，TradingHost 是更便捷的途径。

可以。TradingHost 支持运行 Python 策略；您可以选择与您的技术栈匹配的框架运行环境，或者直接部署您自己的代码仓库。

可以。TradingHost 支持任何可以在容器内运行的语言。

可以。CCXT 在两个 ID 下公开了 Bitfinex：bitfinex 针对 v1 API，而 bitfinex2 针对 v2。新策略请使用 bitfinex2，因为 v2 是目前支持的路径。请注意，某些 Bitfinex 交易对列表在底层实际为 USDT 时仍显示为 USD，CCXT 会在转换过程中对其进行规范化。有关完整配置说明，请参阅 CCXT 框架运行环境文档。

杠杆资金由点对点账本提供，而非交易所。贷方发布 fUSD、fBTC 等资金报价；借方在开立杠杆仓位时使用这些资金。放贷端本身也是一个策略操作面，这在主流交易场所中并不多见。

永续合约在 derivatives.bitfinex.com 上以 F0 symbols（例如 tBTCF0:USTF0）进行交易。交易需要将 USDt0 存入专属的衍生品钱包，该板块由 iFinex Financial Technologies Limited 运营。您可以通过 Transfer Between Wallets 端点划转资金。杠杆可在每笔订单中单独配置，默认 10 倍，最高可达 100 倍。

不行。Bitfinex 不向常驻美国的客户提供服务。如果您在美国，请改用 Coinbase 或 Kraken。TradingHost 可以在任何地区运行您的托管环境，但交易场所本身必须接受您的账户。

可以，只要您的项目是这样设计的。您可以在一个运行环境中运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中，以实现隔离和清晰的运营。每个运行的策略都应该持有自己的 API 密钥（最好在 sub-account 下），这样严格的单密钥 nonce 单调递增限制就不会发生冲突。有关多策略模型的更多信息，请参阅 TradingHost 运行环境页面。

最快的方法是 fork 一个 TradingHost 框架运行环境：选择 CCXT 或 Freqtrade 以获取开箱即用的项目。或者连接您自己的 GitHub 策略仓库。关联 GitHub 仓库和创建策略是免费的；运行环境方案已在定价页面列出。

保存在您由 GitHub 控制的 secrets 工作流中。TradingHost 在运行时通过 GitHub 仓库 secrets、环境 secrets 或您自己批准的密钥管理流程读取它们。TradingHost 不需要托管您的 API 密钥和私钥。有关完整的处理模型，请参阅平台 secrets。

不需要。交易策略绝不应该需要提币权限。请使用限定范围的权限（账户信息、订单、保证金、资金），并且只启用策略实际接触的接口。

可以。TradingHost 支持针对 AI IDE（包括 Cursor、Claude Code、GitHub Copilot）以及基于 CLI 的 AI 智能体的 MCP 控制。AI 工具可以检查部署、查看日志、重启策略并管理运行时的自动化工作流。MCP 是一个控制和可观测性界面，而非交易执行路径。请参阅 MCP 控制界面以了解全貌。

两者皆可。MCP 控制界面在基于 CLI 的智能体（Claude Code CLI、自定义 MCP 客户端、脚本化 MCP 调用）和 IDE 内部同样适用。此外，源自 GitHub 的原生部署循环在没有任何 AI 工具的情况下也能正常工作：向 main 分支进行常规的 git push 即可触发重新部署。

运行时会检测到崩溃，并公开相关的日志和健康信息。在支持的情况下，受影响的策略可以重新启动，而不会干扰在同一容器中运行的其他策略。您的策略代码仍需负责安全错误处理、防重复下单保护和风险控制。有关日志和健康界面的信息，请参阅可观测性。

Bitfinex 要求每个 API 密钥的 nonce 必须严格递增，上限为 9007199254740991。两个进程共享同一个密钥会导致冲突，其中一个将被拒绝。解决方法是为每个运行的策略分配其专属的 API 密钥，最好是在其专属的 sub-accounts 下。请参阅上方的“运营说明”部分以获取完整指南。

TradingHost 运行在 EU 和 US-East 区域。请选择最靠近您策略所依赖的撮合引擎的区域。请参阅区域页面以了解路由和延迟详情。

不提供。TradingHost 专注于生产环境的运行时和部署。回测应该在您的研究技术栈、框架或 AlgoBuilder 中进行。