阅读时间 … 分钟

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

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

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
Kraken
平台类型
加密货币交易所（现货、杠杆、期货、衍生品）
资产类别
加密货币，以及 xStocks 代币化美股
支持的产品
现货、杠杆，以及通过 Kraken Futures（位于 futures.kraken.com 的独立交易平台）提供的永续和定期交割期货、代币化股票（xStocks）。通过 Payward 于 2026 年 5 月收购 Bitnomial 引入的受 CFTC 监管的美国衍生品体系正在扩展；根据 Kraken 的公告，永续合约和期权也将陆续推出。
运行环境模式
容器化策略运行环境
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 Kraken REST、WebSocket 和 FIX，CCXT (kraken, krakenfutures)，Freqtrade，Hummingbot，以及自定义连接器
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、MCP 控制
Kraken 角色
交易所账户、API 访问、市场准入、执行场所
关联关系
TradingHost 是独立平台，与 Kraken 或其母公司 Payward 无任何隶属关系。Payward 于 2026 年 5 月 4 日完成了对 Bitnomial 的收购。

第 02 部分 · Kraken 平台功能

Kraken 平台功能

Kraken 现货和杠杆交易运行在 api.kraken.com，支持 HMAC-SHA512 签名的 REST 请求以及 v1 和 v2 版本的 WebSocket 推送。Kraken Futures 运行在 futures.kraken.com，作为一个独立的交易平台，拥有自己的 API 密钥集和签名方案，涵盖永续合约和定期交割合约。两个平台均向机构客户提供 FIX 4.4 接口。Payward 于 2026 年 5 月通过收购 Bitnomial 引入的受 CFTC 监管的美国衍生品体系正在向永续合约和期权领域扩展。具体端点可能会随时间调整；但整体架构是稳定的，具体的速率限制权重、手续费等级和交易对列表请参考 Kraken 的官方文档。

市场与策略模式

  • 针对 Kraken Pro 交易对的现货做市
  • 在支持的交易对上进行高达 5 倍的杠杆交易
  • Kraken Futures 上的永续合约（多币种保证金，USD 结算）
  • Kraken Futures 上的定期交割期货（月度及季度）
  • Kraken 现货与 Kraken Futures 之间的跨平台套利
  • 通过 Kraken 现货执行 xStocks 代币化股票策略
  • 通过同城共置（colocated）的运行环境进行 FIX 4.4 机构级执行
  • 通过基于 Bitnomial 的 Payward 体系执行受 CFTC 监管的美国衍生品交易

API 接口

产品范围
现货和杠杆通过 api.kraken.com 访问，期货（永续和定期交割）通过 futures.kraken.com 访问。仅在 demo-futures.kraken.com 提供期货模拟环境。现货没有公开测试网，因此模拟运行（dry-run）需要使用极小额订单或历史录制数据请求实盘 API。
连接方式
REST、WebSocket v1、WebSocket v2（自 2023 年 12 月起结束测试，两者均在维护中），以及适用于现货和期货的 FIX 4.4（仅限机构，需要 FIX 类型的现货 API 密钥）。
身份验证
现货 REST 使用 HMAC-SHA512 对 (URI 路径 + SHA256(nonce + POST 数据)) 进行签名，并带有 API-Key 和 API-Sign 请求头，以及单调递增的 nonce。期货 REST 使用在 futures.kraken.com 生成的独立 API 密钥集，带有 APIKey + Authent 请求头，并采用不同的签名方案。支持在 API 密钥上启用可选的双重身份验证（2FA，如 TOTP 或静态密码）。现货和期货的认证接口完全独立。

具体细节请参考 Kraken

具体端点、速率限制权重、交易对列表、手续费等级和版本历史均记录在 Kraken 的官方文档中。请以此作为最终参考。

第 03 部分 · 用 AI 构建

用 AI 构建您的 Kraken 策略

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

  • 原生 Kraken API

    直接控制 Kraken 特有的行为、账户数据和订单执行逻辑。

  • CCXT

    跨 Kraken 现货、Kraken Futures 及其他加密货币交易所的通用接口。CCXT 将 Kraken 拆分为两个独立的交易所 ID：`kraken` 用于现货和杠杆，`krakenfutures` 用于永续和定期交割期货。

    开始使用 CCXT

  • Freqtrade 或 Hummingbot

    基于框架的部署，使用其策略结构和配置模型。这两个框架都开箱即用地支持 Kraken 现货。

    开始使用 Freqtrade开始使用 Hummingbot

  • 自定义连接器

    您自己的内部交易引擎或专有的 Kraken 集成。

框架对 Kraken 产品的支持情况

框架支持程度各有不同。CCXT 通过一个库和两个独立的交易所 ID（`kraken` 和 `krakenfutures`）同时覆盖 Kraken 现货和 Kraken Futures。Freqtrade 和 Hummingbot 提供了对 Kraken 现货的一流支持。原生 Kraken API 访问则覆盖了全部接口，包括 api.kraken.com 上的杠杆交易以及 futures.kraken.com 上的独立期货交易平台。

框架现货杠杆期货
Native Kraken API已支持已支持已支持
CCXT已支持已支持已支持
Freqtrade已支持未记录支持未记录支持
Hummingbot已支持未记录支持未记录支持

✓ 表示官方框架文档确认支持。“no” 表示官方文档未明确说明支持。

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

使用 AI 编写

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

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

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

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

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

  3. 步骤 03

    部署至 TradingHost 容器

    选择区域（EU 或 US-East），提供策略所需的环境变量（例如用于 Spot 和/或 Futures 的 Kraken API 密钥等），然后进行部署。TradingHost 会从代码仓库构建您的容器，并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。

  4. 步骤 04

    监控日志与健康状况

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

  5. 步骤 05

    更新与重新部署

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

部署

Section 05 · 运维说明

Kraken 运维说明

在容器化云端运行环境中实际运行 Kraken 策略时可能遇到的陷阱，这些内容在 Kraken 的文档或框架的 README 中通常找不到。以下所有陈述均引用或改写自 Kraken 的官方文档；部署方面的指南则源自我们在 TradingHost 上运行这些策略的实际经验。

  1. 01 · Nonce

    Kraken 的 nonce 校验非常严格，且每个密钥共享

    针对现货 REST 的每个私有请求，其 API 密钥必须携带严格递增的 nonce。并发请求或进程之间的任何时钟偏差都会导致 EAPI:Invalid nonce 错误。标准的解决方法是为每个工作进程分配一个密钥，并使用纳秒级分辨率的 nonce；此外，Kraken 还允许在每个密钥上配置 Nonce Window，以容忍乱序到达的请求。

    来源Kraken support: Invalid nonce errors

  2. 02 · WebSockets

    v1 和 v2 均可用，推荐使用 v2

    WebSocket v2 于 2023 年 12 月结束测试，是 Kraken 推荐新集成采用的 API。它具有类似 FIX 的架构、RFC3339 时间戳和纯数字价格。v1 仍会接收补丁，且尚未宣布停用计划，但除非您依赖仅在 v1 中提供的推送，否则新代码应以 v2 为目标。

    来源Kraken API change logKraken WebSocket v2 overview

  3. 03 · 独立系统

    现货与期货采用两套不同的 API 和密钥

    现货 API 位于 api.kraken.com，使用 HMAC-SHA512 签名。期货 API 则位于 futures.kraken.com，使用 APIKey + Authent 请求头组合以及不同的签名算法。两者的密钥在不同的账户区域生成，无法互换。如果编写的统一策略需要同时访问这两个市场，则必须配置两套凭据并初始化两个客户端。

    来源Kraken Futures REST introduction

  4. 04 · 速率限制

    随时间持续衰减的账户分级计数器

    Kraken 采用计数器模型，每次 API 调用会消耗固定额度，计数器则根据账户认证级别按秒衰减：Starter 级别上限为 60，衰减速度为 -1/s；Intermediate 级别上限为 125，衰减速度为 -2.34/s；Pro 级别上限为 180，衰减速度为 -3.75/s。REST、WebSocket 和 FIX 共享同一个计数器，因此无法通过切换传输协议来绕过限制。一旦触发限制，系统将返回 EOrder:Rate limit exceeded。

    来源Kraken Spot REST rate limits

  5. 05 · 测试网

    期货提供真实的 demo 环境，现货则没有

    Kraken 在 demo-futures.kraken.com 提供了一个完整的 demo 环境，镜像了实盘期货的 REST 和 WebSocket 接口，但需要单独注册并使用独立的密钥。现货市场没有对应的沙盒环境。若要验证现货策略，必须在实盘 API 上使用最小下单量进行测试，或者使用历史录制数据。

    来源Kraken support: Futures demo environment

  6. 06 · 订单类型

    支持只挂单、冰山单、跟踪止损及完整的 TIF 模式

    Kraken 的订单结构在现货和期货市场均支持只挂单（post-only）、冰山单（最低可仅显示 order_qty 的 1/15）以及跟踪止损。生效时限（Time-in-force）涵盖 GTC、IOC、GTD 和 PO。这些参数可以完美映射到 CCXT 的参数中，但 Freqtrade 仅支持 GTC、IOC 和 PO。

    来源Kraken WebSocket v2 add_order schema

  7. 07 · 错误代码

    识别错误前缀：EAPI、EOrder 与 EGeneral

    EAPI:Invalid key 通常表示签名构建错误（路径错误、HMAC 错误或 base64 编码错误），而非密钥失效。EAPI:Invalid nonce 通常与请求顺序有关，而非凭据问题。EOrder:Insufficient funds 反映的是扣除未成交订单和持仓后的可用余额，而不是钱包的原始总余额。EGeneral:Permission denied 则表示密钥缺少相应的权限范围（scopes）。

    来源Kraken support: API error messagesKraken Spot errors reference

Section 06 · 适用场景

适用场景

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

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

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

Section 08 · 常见问题

常见问题

没有。TradingHost 是独立的运行平台，与 Kraken 及其母公司 Payward 没有任何隶属或合作关系。

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

不提供。Kraken API 的访问权限由 Kraken 官方提供。您需要自行管理您的 Kraken 账户、API 权限、凭据，并遵守 Kraken 的服务条款。

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

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

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

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

可以。CCXT 提供了两个独立的交易所类：用于现货和杠杆交易的 kraken，以及用于永续和交割期货的 krakenfutures。它们需要两套不同的 API 密钥。TradingHost 可以运行您的 CCXT 容器来连接其中之一或两者。您只需将正确的凭据挂载为机密（secrets）即可。具体配置步骤请参阅 CCXT 框架运行环境文档。

是的。现货密钥是在 kraken.com 的主账户中创建的；期货密钥则需要在 futures.kraken.com 下单独创建。两者的身份验证机制不同（现货使用 HMAC-SHA512 配合 API-Sign，期货使用 APIKey + Authent 请求头），因此同时交易这两个市场的策略需要两套凭据，并且通常需要初始化两个客户端。

如果只做现货交易，Freqtrade 对 Kraken 提供了极佳的支持。如果是跨平台交易或永续合约业务，CCXT 可以通过单个库同时覆盖 kraken 和 krakenfutures。Hummingbot 的 kraken 连接器是做市交易最简洁的选择，但仅支持现货。

可以，只要您的项目结构支持。您可以在单个运行环境中运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中，以实现隔离和更清晰的运维管理。具体请参阅 TradingHost 运行环境页面了解多策略模型。

最快的方法是 fork 一个 TradingHost 框架运行环境：CCXT、Freqtrade 或 Hummingbot，以获取开箱即用的项目。或者，您也可以直接连接自己的 GitHub 策略仓库。关联 GitHub 仓库并创建策略是免费的；运行环境方案及费用请参阅定价页面。

保存在您通过 GitHub 控制的机密（secrets）工作流中。TradingHost 在运行时通过 GitHub 仓库机密、环境机密或您认可的其他机密管理流程来读取它们。TradingHost 不需要托管您的 API 密钥和私钥。详情请参阅平台机密管理了解完整的处理机制。

不需要。交易策略绝不应该开启提币权限。请仅使用受限的权限（查询资金、查询未成交订单、创建/修改订单、Websocket 访问），并在可行的情况下配置 IP 白名单。

可以。TradingHost 支持针对 AI IDE 的 MCP 控制，包括 Cursor、Claude Code、GitHub Copilot 以及基于命令行（CLI）的 AI Agent。AI 工具可以检查部署状态、查看日志、重启策略并管理运行环境工作流。需要注意的是，MCP 仅作为控制和观测界面，并非交易执行路径。详情请参阅 MCP 控制界面。

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

运行时会检测到崩溃，并提供相关的日志和健康信息。在支持的场景下，受影响的策略可以独立重启，而不会干扰同一容器中运行的其他策略。你的策略代码仍需负责安全的错误处理、防重单保护和风险控制。有关日志和健康状态接口，请参阅可观测性页面。

Kraken 要求每个 API 密钥的 nonce 必须单调递增，任何并行处理都会破坏这一机制。建议每个工作进程仅运行一个密钥，使用纳秒级分辨率的 nonce。如果在高并发负载下仍遇到冲突，请在 Kraken 设置中调大该密钥的 Nonce Window。TradingHost 会直接在容器日志中显示这些错误。完整指南请参阅上方的“运行说明”部分。

对于 Futures，是的：demo-futures.kraken.com 是实盘 Futures API 的完整镜像，拥有独立的注册通道和密钥。对于 Spot，目前没有公开的沙盒，因此模拟运行（dry-run）需要通过实盘 API 使用最小订单尺寸进行，或者在运行时内针对历史记录数据进行。

TradingHost 在 EU 和 US-East 区域运行。请选择最靠近您策略所依赖的撮合引擎的区域。有关路由和物理距离的详情，请参阅区域页面。

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