BitMart 交易策略的 AI 原生运行环境
在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署到托管云端运行环境，享有原生 MCP 控制、日志查看和区域选择支持。
第 01 部分 · 一览
一览
- 交易平台
- BitMart
- 平台类型
- 加密货币交易所
- 资产类别
- 加密货币
- 支持的产品
- 现货、isolated margin、USDT 保证金期货和币本位反向期货（通过独立的端点系列提供）
- 运行环境模式
- 容器化策略运行环境
- 部署源
- GitHub
- 编程语言
- 任何可在容器中运行的语言
- 常用集成
- 原生 BitMart REST 和 WebSocket、CCXT、Freqtrade、Hummingbot、自定义连接器
- AI 工作流集成
- 适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
- TradingHost 角色
- 运行环境、部署、日志、健康检查、区域选择、MCP 控制
- BitMart 角色
- 交易所账户、API 访问、市场接入、执行场所
- 关联关系
- TradingHost 独立运行，不隶属于 BitMart
第 02 部分 · BitMart 平台功能
BitMart 平台功能
BitMart 通过三个独立的端点系列（各拥有独立的频率限制池）提供现货、isolated margin、USDT 保证金期货和反向期货。身份验证需要使用 API key、secret 以及通过 HMAC-SHA256 签名的 memo 字符串；如果缺失 memo，即使 HMAC 正确也会触发签名错误。KYC 等级决定了频率限制的上限。美国、Hong Kong SAR 及其他部分地区限制进行期货交易；该限制在创建账户和提交订单时强制执行。具体端点细节可能会随时间变化。整体架构是稳定的；具体的频限权重、手续费等级和交易对列表请参考 BitMart 官方文档。
市场与策略模式
- 基于 USDT 和 BTC 交易对的现货策略
- USDT 保证金永续合约（非限制司法管辖区）
- 反向（币本位）永续合约
- isolated margin 借贷策略
- 享有更高频率限制的 KYC 分级执行
- 子账户隔离的多策略部署
- WebSocket 订单簿与交易流数据消费
- 跨系列执行（现货 + 期货，使用独立域名）
API 接口
- 产品范围
- 开放 API 门户上的 Spot v3、isolated margin 端点，以及位于独立域名的期货端点。每个系列都拥有独立的频率限制池和身份验证范围。美国、Hong Kong SAR 及其他部分地区限制进行期货交易；该限制在创建账户和提交订单时强制执行，而不仅在登录时。
- 连接方式
- REST 用于下单和账户查询。WebSocket 用于市场数据和私有账户事件。公共 WebSocket 流无需验证；私有 WebSocket 订阅则根据 key 的权限范围进行限制。
- 身份验证
- API key、secret 以及通过 HMAC-SHA256（小写十六进制）签名的 memo。Key 的权限按系列（现货、杠杆、期货）划分，且 KYC 等级决定了频率限制的上限。memo 字符串为 BitMart 特有，并在服务器端进行验证；如果缺失 memo，即使 HMAC 本身正确，也会返回签名错误。
具体细节请参考 BitMart
具体端点、频限权重、交易对列表、手续费等级和版本历史记录请参见 BitMart 官方文档。请以官方文档为准。
第 03 部分 · 用 AI 构建
用 AI 构建您的 BitMart 策略
选择一种集成方式，Fork 一个 TradingHost 框架模板，然后在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI Agent 均可无缝接入相同的 GitHub 原生部署循环。
原生 BitMart API
直接控制三个端点系列中 BitMart 特有的行为、账户数据和订单执行逻辑。
自定义连接器
运行您自己的内部交易引擎或专有的 BitMart 集成，使用包含 BitMart memo 字符串的 HMAC-SHA256 对请求进行签名。
框架对 BitMart 产品的支持情况
支持范围因框架而异。CCXT 涵盖 BitMart 现货和掉期市场；Freqtrade 涵盖现货；Hummingbot 涵盖现货并提供部分永续合约支持；原生 BitMart API 访问则涵盖 BitMart 提供的所有功能，包括 isolated margin 和期货系列。无论使用何种框架，受限制司法管辖区的账户均无法使用期货功能。
✓ 表示官方框架文档确认支持。“no” 表示官方文档未说明支持。“partial” 表示支持范围有限。工作流链接指向目前正在编写的 /workflows/ 页面。
TradingHost 不强求特定的框架，它只负责运行您的项目。
使用 AI 编写
上述框架模板与 AI IDE 是绝佳的搭配。TradingHost 的 MCP 控制面实现了闭环：AI 工具可以与您一同检查部署、查看日志并管理运行环境，但绝不会介入交易执行路径。
Section 04 · 在 TradingHost 上运行
在 TradingHost 上运行您的代码
BitMart 提供交易所和 API 访问。TradingHost 则提供生产环境，用于运行您连接到 BitMart 的策略。
无需在笔记本电脑、台式机、通用 VPS 或手动配置的服务器上运行策略代码，您只需从 GitHub 部署到由 TradingHost 托管的容器运行环境中。
您
- 您的代码库包含您的代码。
- 您的部署定义了其运行方式。
- 您的策略连接到 BitMart。
TradingHost
- 保持运行环境持续在线。
- 呈现日志和健康状况检查。
- 区域选择。
- 受控的部署环境。
部署流程
- 步骤 01
连接 GitHub
授权 TradingHost 访问您的 GitHub 帐户。
- 步骤 02
关联代码库或从框架开始
将 TradingHost 指向您现有的策略代码库，或者派生 (fork) 一个 TradingHost 框架运行环境（CCXT、Freqtrade 或 Hummingbot）以获取可直接运行的基础模板。
- 步骤 03
部署至 TradingHost 容器
选择一个区域（EU 或 US-East），提供策略所需的环境变量（BitMart API 密钥、Secret、memo 字符串以及任何特定接口系列的 Scope 标志），然后进行部署。TradingHost 会根据您的仓库构建容器，并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。
- 步骤 04
监控日志与健康状况
通过 TradingHost 控制面板实时查看日志、健康状况和运行状态。该界面同样支持在任何 AI IDE 中通过 MCP 进行访问，方便 Cursor、Claude Code 或 CLI 智能体与您协同读取部署状态并管理运行环境。
- 步骤 05
更新与重新部署
将代码更改推送到 GitHub 的主分支（main branch），TradingHost 便会自动重新部署。
Section 05 · 运维说明
BitMart 运维说明
在容器化云端运行环境中实际运行 BitMart 策略时会遇到的坑，这些在 BitMart 文档或框架的 README 中是找不到的。以下所有内容均引用或转述自 BitMart 官方文档；部署端的指南则源自我们在 TradingHost 上运行这些策略的实际经验。
01 · 三个系列
Spot v3、Margin 和 Futures 位于独立的端点系列后
BitMart 的 REST 接口分为三个系列：开放 API 门户上的 Spot v3、isolated Margin 端点，以及位于独立域名的 Futures。每个系列都拥有独立的频率限制池、身份验证范围和错误代码体系。同时涉及现货和期货的策略必须针对每个系列的限制池分别进行预算，而不是使用单一的合并上限；如果忽略这一划分而进行跨系列重试，可能会导致一侧被限流，而另一侧仍有额度。
02 · 签名 memo
API memo 字符串是签名的一部分，而非标签
BitMart 的 HMAC-SHA256 签名方案要求在 key 和 secret 之外同时包含 API memo 字符串。该 memo 在创建 key 时设置，并在每次签名请求时进行服务端验证。一个常见的隐性错误是将 memo 误认为普通的 UI 标签，从而在签名负载中将其遗漏；此时即使 HMAC 计算完全正确，请求也会返回签名错误。请将 memo 与 key 和 secret 存储在同一个机密（secrets）条目中，并确保客户端代码在缺少 memo 时拒绝进行签名。
03 · 期货地域限制
期货交易在美国、Hong Kong SAR 及其他地区受限
BitMart 限制在美国、Hong Kong SAR 以及其他部分地区进行期货交易。该限制在账户创建和订单提交时强制执行，因此来自受限司法管辖区账户的期货订单将被拒绝，无论 key 的级别或 KYC 等级如何。如果您的策略涉及多个司法管辖区，请将交易平台/地区选择作为一等配置值（first-class config value）进行编码，而不是作为针对单个 key 的开关，以便在运行地处于受限列表时，让策略自动绕过 BitMart。
04 · KYC 等级
KYC 等级决定了频控上限和提币额度
API 访问权限受账户级 KYC 等级限制：更高的等级可解锁更高的频控上限和提币配额。在已认证账户上运行顺畅的策略，如果复制到较低等级的新账户上，可能会遇到意料之外的 429 错误。在评估策略吞吐量之前，请确保测试账户与生产账户处于相同的 KYC 等级，并将每秒发送速率限制在每账户配置中，而不是使用硬编码常量。
05 · 安全事件后防范
轮换 2021 年 12 月安全事件之前创建的 key
BitMart 在 2021 年 12 月披露了一起安全事件，其热钱包损失了约 1.96 亿美元。此后，该交易所重构了 key 的发放和子账户验证控制。如果您持有该时期之前创建且至今未轮换的 BitMart API key，请将其视为存在风险并重新生成。虽然签名方案没有改变，但从操作规范的角度来看，应轮换所有在安全事件发生前创建的 key。
Section 06 · 适用场景
适用场景
TradingHost BitMart 运行环境最适合用于：
- 在 AI IDE（Cursor、Claude Code）中构建策略的开发者
- 系统化加密货币交易员
- 量化开发人员
- CCXT、Freqtrade 和 Hummingbot 用户
- 正在从 VPS 托管转向容器化部署的团队
连接 GitHub 并创建首个策略完全免费。
Section 08 · 常见问题
常见问题
没有。TradingHost 是独立的，与 BitMart 没有任何隶属或合作关系。
不会。您的策略代码会根据您自己的逻辑、账户权限和集成方式连接到 BitMart 并发送指令。TradingHost 仅提供运行该代码的托管运行环境（runtime）。
不提供。BitMart API 访问权限由 BitMart 提供。您需要自行负责您的 BitMart 账户、API 权限、凭据以及对 BitMart 条款的合规性。
不是。TradingHost 是运行您策略代码的云端运行环境。我们不提供交易信号、AI 预测模型或预建的机器人。使用 TradingHost，您需要自己编写或生成策略（通常使用 Cursor 或 Claude Code），将其作为您自己的代码保存在 GitHub 中，并使用 TradingHost 在生产环境中运行它。3Commas、Cryptohopper 及类似产品拥有策略逻辑，而 TradingHost 则是运行您自己的策略。
AWS 和 DigitalOcean 提供的是原始算力。您需要自己处理操作系统更新、容器编排、日志传输、机密轮换、区域容灾和在线率监控。而 TradingHost 为您提供专为交易策略打造的托管运行环境：开箱即用的 GitHub 原生部署、通过 AI IDE 进行的 MCP 驱动控制，以及日志和健康状况监控界面。如果您想自己运营基础设施，AWS 可以满足需求。如果您希望将运行环境作为托管服务使用，TradingHost 是更便捷的途径。
可以。TradingHost 支持运行 Python 策略；您可以选择与您的技术栈匹配的框架运行环境，或者直接部署您自己的代码仓库。
可以。TradingHost 支持任何可以在容器内运行的语言。
可以。CCXT 通过统一的 `bitmart` 类公开了 BitMart 的现货和永续合约（swap）市场。只需将您的 CCXT 策略放入容器中，并将其指向 GitHub，TradingHost 就会像运行任何其他 Python 或 Node 项目一样运行它。请参阅 CCXT 框架运行环境了解完整的设置流程。
可以，只要您的项目是这样设计的。您可以在一个运行环境中运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中，以实现隔离和清晰的运维管理。请参阅 TradingHost 运行环境页面了解多策略模型。
最快的方法是 fork 一个 TradingHost 框架运行环境（如 CCXT、Freqtrade 或 Hummingbot）以获取开箱即用的项目，或者直接关联您自己的 GitHub 策略仓库。关联 GitHub 仓库和创建策略是免费的；运行环境方案已在定价页面列出。
存储在您由 GitHub 控制的机密（secrets）工作流中。TradingHost 在运行时通过 GitHub 仓库机密、环境机密或您自己认可的机密管理流程读取它们。TradingHost 不需要托管您的 BitMart API key、secret 或 memo 字符串。请参阅平台机密了解完整的处理模型。
不需要。策略绝不应该需要提币权限。请使用有范围限制的权限（只读、现货交易、期货交易），并确保策略 key 禁用提币功能。对于转账和日常运营任务，请使用单独的手动管理 key。
可以。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 即可触发重新部署。
运行环境会检测到崩溃并展示相关的日志和健康信息。在支持的情况下，受影响的策略可以重新启动，而不会干扰在同一容器中运行的其他策略。您的策略代码仍需负责安全的错误处理、重复订单保护和风险控制。请参阅可观测性了解日志和健康状况界面。
BitMart 在司法管辖区级别强制执行期货限制，而不仅仅是在 key 级别。无论 key 的范围如何，美国、Hong Kong SAR 和许多其他地区都无法进行 BitMart 期货交易。如果您的账户是在受限司法管辖区创建的，期货订单将返回区域性拒绝，更改任何 key 都无法解锁。请将您的期货交易流路由到不受限制的平台，或者在该账户上仅将 BitMart 用于现货交易。请参阅上方的“运营说明”部分了解完整指南。
TradingHost 在 EU 和 US-East 区域运行。请选择最靠近您策略所依赖的撮合引擎的区域。有关路由和延迟详情，请参阅区域页面。
不支持。TradingHost 专注于生产环境的运行与部署。回测应在您的研究技术栈、框架或 AlgoBuilder 中进行。