阅读时间 … 分钟

Bitvavo 交易策略的 AI 原生运行环境

在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署至托管云端运行环境，享有原生 MCP 控制、日志及欧洲区域选择支持。

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
Bitvavo
平台类型
加密货币交易所（中心化，总部位于欧盟）
资产类别
加密货币
支持的产品
仅限现货。无杠杆、无期货、无衍生品；单一现货交易平台，1:1 杠杆。
运行环境模式
容器化策略运行环境
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 Bitvavo REST 和 WebSocket、CCXT (`bitvavo`)、CCXT Pro、Freqtrade、官方 Bitvavo SDK（Python、Node.js、Go、Java）、自定义集成
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 及 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、MCP 控制
Bitvavo 角色
交易所账户、API 接入、市场准入、执行场所、EUR 资金通道
关联关系
TradingHost 保持独立，与 Bitvavo 无任何隶属关系。Bitvavo B.V. 受 AFM 依据 MiCA 进行行为监管（于 2025 年 6 月获得授权），并在 De Nederlandsche Bank (DNB) 注册。

第 02 部分 · Bitvavo 平台功能

Bitvavo 平台功能

Bitvavo 是一家总部位于欧盟的现货交易所，支持原生 EUR 法币通道（SEPA、SEPA Instant、iDEAL），并在整个 EEA 拥有 MiCA 授权。交易策略通过 REST 和 WebSocket 接入该平台，并使用经 HMAC-SHA256 签名的 API 密钥（限定特定权限）进行身份验证。这里没有衍生品、没有杠杆、没有永续合约；其 API 接口设计有意比多产品加密货币交易平台更为简洁。

市场与策略模式

  • EUR 现货网格交易
  • 主流资产的定期 EUR 定投 (DCA)
  • EUR 法币交易对与 USD 交易平台之间的套利
  • 邻近阿姆斯特丹的运行环境，实现欧盟地区低延迟执行
  • EUR 交易对的现货做市
  • EUR / 山寨币交易对的均值回归
  • 现货持仓的投资组合再平衡
  • 符合 MiCA 规范的零售策略托管（EEA 通行证）

API 接口

产品范围
仅限现货。无期货、无杠杆、无期权。以 EUR 计价的交易对占主导地位；同时也提供 USDC、USDT、BTC 计价的市场。
连接方式
REST 接口位于 `https://api.bitvavo.com/v2/`。WebSocket 接口位于 `wss://ws.bitvavo.com/v2/`。此外还为机构客户提供 FIX API（非自助服务）。
身份验证
API 密钥配合 HMAC-SHA256 签名请求。请求头：`Bitvavo-Access-Key`、`Bitvavo-Access-Signature`、`Bitvavo-Access-Timestamp`、`Bitvavo-Access-Window`（默认 10000 毫秒）。签名为 `timestamp + method + url + body` 的 SHA-256 HMAC 十六进制摘要，以 API 密钥私钥（secret）作为密钥。支持针对每个 API 密钥设置可选的 IP 白名单（强烈推荐）。API 密钥权限包括：View、Trade、Withdraw、Subaccount、Internal Transfer、Administrative。

具体细节请参考 Bitvavo

具体端点、限频权重、交易对列表和费率层级请参阅 Bitvavo 的官方文档。请以官方文档为准。

第 03 部分 · 用 AI 构建

用 AI 构建您的 Bitvavo 策略

选择一种集成方式，Fork 一个 TradingHost 框架模板，然后在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI Agent 均可无缝接入相同的 GitHub 原生部署循环。

  • 原生 Bitvavo API

    通过 REST、WebSocket 或机构级 FIX 直接控制 Bitvavo 的特定行为、账户数据和订单执行逻辑。

  • CCXT

    跨 Bitvavo 及其他加密货币交易所的通用接口。CCXT Pro 增加了 WebSocket 支持。

    开始使用 CCXT

  • Freqtrade

    使用 Freqtrade 策略结构的框架化部署。Bitvavo 支持通过 CCXT 进行了社区测试；不支持交易所端止损。

    开始使用 Freqtrade

  • 自定义连接器

    您自有的内部交易引擎、专属的 Bitvavo 集成，或使用官方 Bitvavo SDK（Python、Node.js、Go、Java）之一。

针对 Bitvavo 的框架支持

由于 Bitvavo 仅支持现货，因此其框架支持矩阵比多产品交易平台更为简单：无需填写 USD-M、COIN-M 或期权列。如果您的策略需要永续合约或 USD 保证金期货，请将 Bitvavo 与其他交易平台（例如 Binance、Bybit 或 OKX）结合使用以处理衍生品部分。对于仅限现货的 Bitvavo 策略，支持所有三大主流框架以及原生 API；Hummingbot 目前未提供 Bitvavo 连接器。

框架现货
Native Bitvavo API已支持
CCXT已支持
Freqtrade已支持
Hummingbot未记录支持

✓ 表示根据官方框架文档确认支持。“no connector” 表示该框架未提供 Bitvavo 连接器。工作流链接指向目前正在编写的 /workflows/ 页面。

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

使用 AI 编写

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

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

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

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

    将 TradingHost 指向您现有的策略仓库，或者派生 (fork) 一个 TradingHost 框架运行环境（CCXT 或 Freqtrade）作为可运行的基础模板。

  3. 步骤 03

    部署至 TradingHost 容器

    选择一个区域（EU 或 US-East），提供您策略所需的环境变量（Bitvavo API 密钥：`Bitvavo-Access-Key`、`Bitvavo-Access-Signature`、`Bitvavo-Access-Timestamp` 和 `Bitvavo-Access-Window` 请求头将基于这些密钥构建），然后进行部署。TradingHost 会从您的代码仓库构建容器，并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。

  4. 步骤 04

    监控日志与健康状况

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

  5. 步骤 05

    更新与重新部署

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

部署

Section 05 · 运维说明

Bitvavo 运维说明

在容器化云端运行环境中实际运行 Bitvavo 策略时可能遇到的隐蔽问题，这些内容在 Bitvavo 的文档或框架的 README 中并未提及。以下所有陈述均引用或转述自 Bitvavo 的官方文档；部署侧的指南则源自我们在 TradingHost 上运行 these 策略的实际经验。

  1. 01 · 速率限制

    基于权重的速率限制，每分钟 1000 点

    Bitvavo 实施 REST 和 WebSocket 共享的权重速率限制。默认上限为每分钟 1000 权重点，通过身份验证时按 API 密钥跟踪，否则按 IP 跟踪。响应中包含 `bitvavo-ratelimit-limit`、`bitvavo-ratelimit-remaining` 和 `bitvavo-ratelimit-resetat` 请求头。超出限制将返回 HTTP 429 及 `errorCode 105`，并对已验证的调用者封禁 1 分钟（未验证的调用者封禁 15 分钟）。

    来源Bitvavo rate limits

  2. 02 · WebSocket

    单一端点，基于 JSON action 的订阅方式

    位于 `wss://ws.bitvavo.com/v2/` 的单一 WebSocket 端点可同时处理公共市场数据和身份验证交易。订阅和订单操作以包含 `action` 参数的 JSON 消息形式发送。标准限流允许每秒最多 5000 条消息；Market Data Pro 限制为 50/s；超出限制时两者均会返回 `errorCode 112`。

    来源Bitvavo WebSocket overview

  3. 03 · API 密钥

    细粒度权限范围及 IP 白名单

    在 Bitvavo 控制面板中创建密钥时，您可以选择 View、Trade、Withdraw、Subaccount、Internal Transfer 和 Administrative 权限范围的任意组合。IP 白名单是可选的，但强烈建议配置；如果不配置，任何持有该凭证的人都可以对账户进行操作。Bitvavo 提示，通过 API 发起的提币会绕过 2FA，因此仅在确实需要时才应启用 Withdraw 权限。

    来源Bitvavo API key creation and permissions

  4. 04 · 身份验证错误

    需注意的签名与 IP 失败错误代码：305 / 307 / 309

    开发者最常遇到的身份验证失败是：当调用主机不在白名单内时返回的 `errorCode 307`（“此密钥不允许从此 IP 访问”），以及当 HMAC 构建错误或复制密钥时带有空格时返回的 `errorCode 309`（“签名无效”）。`errorCode 304` 对应时间戳/窗口不匹配。Bitvavo 建议重新生成密钥，而不是去排查 nonce 或复制粘贴问题。

    来源Bitvavo API error messages

  5. 05 · EUR 渠道

    支持 SEPA、SEPA Instant 和 iDEAL 入金

    法币入金原生支持 EUR，可通过免费的 SEPA 银行转账（荷兰账户 1 个工作日，其他 EEA 地区 2 个工作日）、支持银行的 SEPA Instant，以及单笔最高 50,000 欧元的 iDEAL 进行。同时支持定期 SEPA 存款。不提供 USD 入金通道；策略必须以 EUR 定价，或接受外汇风险敞口。

    来源Bitvavo SEPA deposits

  6. 06 · 充值网络

    每个资产仅支持单一网络，不支持 TRC-20 稳定币

    与多链交易所不同，Bitvavo 为降低误送风险，特意对每个列出的资产仅支持一个区块链网络。值得注意的是，不支持以太坊计价资产的 TRC-20 充值。在生成充值地址前，地址推导程序必须检查 Bitvavo 针对每个资产支持的网络列表；误送的资金无法找回。

    来源Bitvavo supported blockchain networks

  7. 07 · 监管合规

    经 AFM 获得 MiCA 授权，EEA 通行证已启用

    Bitvavo 于 2025 年 6 月获得荷兰 AFM 的 MiCA 授权，范围涵盖托管、交易平台运营以及在所有欧盟成员国及挪威、冰岛和列支敦士登之间的加密资产转移。此前的 DNB 注册在反洗钱/反恐怖融资（AML/CFT）监管方面依然有效。大多数成员国对未获许可的 CASP 的 MiCA 过渡期已于 2026 年年中结束；对于居住在 EEA 的策略运营者而言，使用获得 MiCA 许可的交易平台已成为合规的默认选择。

    来源Bitvavo obtains MiCA licence

Section 06 · 适用场景

适用场景

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

  • 在 AI IDE（Cursor、Claude Code）中构建策略的开发者
  • 系统化加密货币交易员
  • 总部位于欧盟的量化开发人员
  • CCXT 和 Freqtrade 用户
  • 从 VPS 托管转向容器化部署的团队

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

Section 08 · 常见问题

常见问题

没有。TradingHost 是独立的，与 Bitvavo 没有任何隶属或合作关系。

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

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

不是。TradingHost 是运行您策略代码的云端运行环境。我们不提供交易信号、AI 预测模型或预建的机器人。使用 TradingHost，您需要自己编写或生成策略（通常使用 Cursor 或 Claude Code），将其作为代码保存在 GitHub 中，然后使用 TradingHost 在生产环境中运行。3Commas、Cryptohopper 及类似产品拥有策略逻辑；而 TradingHost 则是运行您自己的策略。

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

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

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

可以。CCXT 和 CCXT Pro 均支持 Bitvavo，交易所 ID 为 bitvavo，涵盖 REST 和 WebSocket。如果您更喜欢原生客户端，Bitvavo 还发布了 Python、Node.js、Go 和 Java 的官方 SDK。完整配置说明请参阅 CCXT 框架运行环境。

可以，只要您的项目是这样设计的。您可以在一个运行环境中运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中，以实现隔离和运营清晰度。多策略模型请参阅 TradingHost 运行环境页面。

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

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

不需要。策略绝不应该需要 Withdraw 权限。请仅使用 View 和 Trade 权限，并在合适的地方启用 IP 白名单。Bitvavo 提示，通过 API 发起的提币会绕过 2FA，因此 Withdraw 权限属于高风险权限，应仅保留给您在固定 IP 主机上手动操作的密钥。

可以。TradingHost 支持针对 AI IDE 的基于 MCP 的控制，包括 Cursor、Claude Code、GitHub Copilot 和基于 CLI 的 AI 智能体。AI 工具可以检查部署、查看日志、重启策略并管理运行环境工作流。MCP 是一个控制和可观测性界面，而不是交易执行路径。完整架构请参阅 MCP 控制界面。

两者皆可。MCP 控制面在基于 CLI 的智能体（例如 Claude Code CLI、自定义 MCP 客户端、脚本化 MCP 调用）和 IDE 内部同样适用。此外，GitHub 原生部署流程无需任何 AI 工具即可运行：只需向 main 分支执行常规的 git push 即可触发重新部署。

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

这是 Bitvavo 的 IP 白名单拒绝错误。您可以在 Bitvavo 控制面板中将 TradingHost 运行时的出口 IP 添加到 API 密钥的白名单中，或者重新生成不带白名单的密钥（不推荐）。在添加白名单之前，请通过 TradingHost 的运行时信息确认出口 IP。

这通常是因为 HMAC 构建不正确，或者复制 API 密钥（secret）时夹带了多余的空格。请将签名重新计算为 HMAC-SHA256(secret, timestamp + method + url + body) 的十六进制摘要，确保请求体字符串与签名的内容完全一致，并检查 Bitvavo-Access-Timestamp 是否为毫秒，且处于 Bitvavo-Access-Window 范围内。如果密钥可能已损坏，重新生成密钥是最快的解决方法。

不可以。Bitvavo 仅支持现货交易，杠杆比例为 1:1；不提供期货、永续合约、期权或杠杆产品。如需交易永续合约或 USD-M 期货，请针对 Binance、Bybit 或 OKX 部署独立的策略。

是的。Bitvavo 已于 2025 年 6 月获得荷兰 AFM 依据 MiCA 授予的许可，并自 2020 年起在 De Nederlandsche Bank 注册。MiCA 许可在整个 EEA 范围内通用，因此居住在 EEA 的策略运营者可以在获得许可的交易场所托管策略，而无需在每个国家单独注册。Bitvavo 是 CASP（加密资产服务提供商），而非信用机构；这并不会将 MiFID 保护延伸至交易活动。

可通过免费的 SEPA 银行转账（1 至 2 个工作日）存入 EUR，如果您的银行支持，也可以使用 SEPA Instant，或者使用 iDEAL 进行荷兰银行即时充值（单笔交易最高 50,000 欧元）。该平台不提供 USD 法币通道；以 USD 计价的盈亏（PnL）需要进行稳定币或外汇兑换。

TradingHost 运行在 EU 和 US-East 区域。特别是对于 Bitvavo，EU 区域在地理位置上最接近 Bitvavo 位于阿姆斯特丹附近的撮合引擎，通常能提供最低的往返延迟。请参阅区域页面以获取路由和邻近度的详细信息。

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