适用于 Mercado Bitcoin 交易策略的 AI 原生运行环境
在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署到托管云端运行环境，享受一流的 MCP 控制、日志和原生 BRL 执行。
第 01 部分 · 一览
一览
- 交易平台
- Mercado Bitcoin
- 平台类型
- 加密货币交易所（总部位于巴西，拉美最大的数字资产平台）
- 资产类别
- 加密货币，以及巴西的代币化固定收益和受监管现实世界资产
- 支持的产品
- 现货交易、代币化资产（XRP Ledger 上的受监管金融资产，包括固定收益）、NEAR、ADA、SOL、ETH、CHZ 质押。在 TRON 上发行的锚定 BRL 稳定币 MBRL（2024 年 11 月）。不提供面向零售用户的公开加密货币衍生品或永续合约。
- 运行环境模式
- 容器化策略运行环境
- 部署源
- GitHub
- 编程语言
- 任何可在容器中运行的语言
- 常用集成
- 原生 Mercado Bitcoin API v4 (REST)、Mercado Bitcoin WebSocket v0、传统 TAPI v3、CCXT (`mercado`)、自定义
- AI 工作流集成
- 适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
- TradingHost 角色
- 运行环境、部署、日志、健康检查、区域选择、MCP 控制
- Mercado Bitcoin 角色
- 交易所账户、API 访问、市场准入、执行场所、通过 PIX 的 BRL 法币通道、托管
- 关联关系
- TradingHost 保持独立，与 Mercado Bitcoin 及其母公司 2TM Participações 无关联。Mercado Bitcoin 依据巴西虚拟资产法 (Lei 14.478/2022) 以及 Banco Central do Brasil SPSAV 框架（2025 年 11 月起的 Resolutions 519, 520 and 521）运营。
第 02 部分 · Mercado Bitcoin 平台功能
Mercado Bitcoin 平台功能
Mercado Bitcoin 是拉美最大的数字资产平台，以 BRL 为本位，并以 PIX 作为主要的法币通道。策略通过当前 API v4（先授权后获取令牌）的 REST 和 WebSocket，或通过传统的 TAPI v3（HMAC-SHA512 签名路径）连接到该平台。除了加密货币现货，MB 还提供 XRPL 上受监管的代币化现实世界资产项目，以及在 TRON 上发行的锚定 BRL 稳定币 MBRL；不提供面向零售用户的公开加密货币衍生品或永续合约。
市场与策略模式
- BRL 现货网格
- PIX 资金定投 (DCA)
- BRL/USDT 三角套利
- 巴西及拉美低延迟执行
- MBRL 和 BRZ 稳定币对
- 代币化固定收益再平衡（挂钩 Tesouro，XRPL RWA）
- 投资组合再平衡
- 做市
API 接口
- 产品范围
- 现货、代币化资产（面向消费者的界面）。MB 开发者文档中未宣传公开沙盒；请将其视为仅限生产环境，并通过 TradingHost 模拟运行 (dry-run) 进行测试。
- 连接方式
- REST 接口位于 `https://api.mercadobitcoin.net/api/v4`（当前）。WebSocket 接口位于 `wss://ws.mercadobitcoin.net/ws/v4`，文档见 `https://ws.mercadobitcoin.net/docs/v0/`。
- 身份验证
- 新的 API v4 使用授权令牌流程（使用 API 密钥 + 密钥 POST `/authorize`，然后在私有端点上使用不记名令牌样式的请求头）。传统的 TAPI v3 使用 HMAC-SHA512，通过 `TAPI-ID` / `TAPI-MAC` 请求头对 `/tapi/v3/` 请求路径进行签名。对于新集成，新的 v4 取代了 TAPI。PIX 是法币通道，由 MB Pay（支付机构分支）处理，而非交易 API。
具体细节请参考 Mercado Bitcoin
具体端点、速率限制权重、交易对列表和费用层级请参见 Mercado Bitcoin 的文档。请以这些文档为准。
第 03 部分 · 用 AI 构建
用 AI 构建您的 Mercado Bitcoin 策略
选择一种集成方式，Fork 一个 TradingHost 框架模板，然后在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI Agent 均可无缝接入相同的 GitHub 原生部署循环。
原生 Mercado Bitcoin API
通过当前的 REST API v4（先授权后获取令牌）或传统的 TAPI v3（HMAC-SHA512 签名路径），直接控制 Mercado Bitcoin 特有的行为、账户数据和订单执行逻辑。
Freqtrade
使用 Freqtrade 策略结构的基于框架的部署。通过 CCXT 在社区层级提供 Mercado Bitcoin 支持；在上线前，请务必针对 MB 验证市场元数据和订单类型。
自定义连接器
您自己的内部交易引擎或专有的 Mercado Bitcoin 集成，包括用于低延迟 BRL 现货策略的直接 WebSocket 消费者。
针对 Mercado Bitcoin 的框架支持
仅限现货的矩阵与 Mercado Bitcoin 的产品范围相匹配：没有可填充的 USD-M、COIN-M 或期权列。如果您的策略需要永续合约或 U 本位合约，请将 Mercado Bitcoin 与其他交易平台（例如 Binance、Bybit 或 OKX）配对以进行衍生品交易。MB 的代币化现实世界资产项目（基于 XRPL 的受监管系列、挂钩固定收益的代币）不属于标准程序化加密货币对范围，目前不包含在此矩阵中。
✓ 根据官方框架文档确认支持。“partial” 表示社区层级的支持，可能需要额外的验证。“no connector” 表示该框架未提供 Mercado Bitcoin 连接器。工作流链接指向当前正在编写的 /workflows/ 页面。
TradingHost 不强求特定的框架，它只负责运行您的项目。
使用 AI 编写
上述框架模板与 AI IDE 是绝佳的搭配。TradingHost 的 MCP 控制面实现了闭环：AI 工具可以与您一同检查部署、查看日志并管理运行环境，但绝不会介入交易执行路径。
Section 04 · 在 TradingHost 上运行
在 TradingHost 上运行您的代码
Mercado Bitcoin 提供交易所和 API 访问。TradingHost 则提供生产环境，用于运行您连接到 Mercado Bitcoin 的策略。
无需在笔记本电脑、台式机、通用 VPS 或手动配置的服务器上运行策略代码，您只需从 GitHub 部署到由 TradingHost 托管的容器运行环境中。
您
- 您的代码库包含您的代码。
- 您的部署定义了其运行方式。
- 您的策略连接到 Mercado Bitcoin。
TradingHost
- 保持运行环境持续在线。
- 呈现日志和健康状况检查。
- 区域选择。
- 受控的部署环境。
部署流程
- 步骤 01
连接 GitHub
授权 TradingHost 访问您的 GitHub 帐户。
- 步骤 02
关联代码库或从框架开始
将 TradingHost 指向您现有的策略仓库，或者派生 (fork) 一个 TradingHost 框架运行环境（CCXT 或 Freqtrade）作为可运行的基础模板。
- 步骤 03
部署至 TradingHost 容器
选择一个区域（EU 或 US-East），提供策略所需的环境变量（Mercado Bitcoin API v4 凭证驱动“授权-获取令牌”流程：使用您的 API key 和 secret 向 `/authorize` 发送 POST 请求，并在后续的私有端点请求中携带返回的 bearer token），然后进行部署。TradingHost 会从代码仓库构建您的容器，并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。
- 步骤 04
监控日志与健康状况
通过 TradingHost 控制面板实时查看日志、健康状况和运行状态。该界面同样支持在任何 AI IDE 中通过 MCP 进行访问，方便 Cursor、Claude Code 或 CLI 智能体与您协同读取部署状态并管理运行环境。
- 步骤 05
更新与重新部署
将代码更改推送到 GitHub 的主分支（main branch），TradingHost 便会自动重新部署。
Section 05 · 运维说明
Mercado Bitcoin 运维说明
在容器化云端运行环境中实际运行 Mercado Bitcoin 策略时会遇到的坑，这些在 Mercado Bitcoin 的文档或框架的 README 中是找不到的。以下所有内容均引用或转述自 Mercado Bitcoin 官方文档及已公布的巴西监管记录；部署方面的指南源自于在 TradingHost 上运行这些策略的实际经验。
01 · API 版本
两个并行的 API 接口，v4 是未来的方向
传统的 TAPI v3 位于 `/tapi/v3/`，使用 HMAC-SHA512 对请求路径进行签名，并配有 `TAPI-ID` 和 `TAPI-MAC` 请求头。当前 API v4 位于 `api.mercadobitcoin.net/api/v4`，采用先授权后获取令牌的模型。请针对 v4 构建新策略；仅在端点尚未移植时才回退到 TAPI。
02 · PIX 通道
巴西即时支付处理 BRL 资金
BRL 的充值和提现均使用 PIX（Banco Central do Brasil 的即时支付网络）。PIX 清算全年无休（24x7x365），包括周末和节假日。通过 PIX 充值的资金几乎实时到达 MB 账户；根据 MB 公布的条款，BRL 提现最多需要 1 个工作日处理。PIX 的处理独立于交易 API 之外。
03 · KYC 等级
经认证的账户可解锁自动化额度限制
未认证账户的 24 小时提现额度上限为 R$1,000，年充值额度上限为 R$50,000。完全认证（CPF 加身份验证）的账户可解锁每日 R$50,000 的提现额度，且无充值上限。KYC 等级直接影响自动化策略可执行的交易规模。
04 · 代币化资产
RWA 系列资产根据其自身的市场结构进行交易
现货加密货币对提供 24x7 交易。代币化合规资产（MB 的 XRPL RWA 项目、固定收益挂钩代币）遵循标的资产的行为模式，并可能存在结算限制；请勿假设代币化系列资产会像 BTC/BRL 那样具有连续的价格发现。
05 · 监管合规
Lei 14.478/2022、SPSAV 决议及 CVM 监管
MB 在巴西虚拟资产法（Lei 14.478/2022）下运营。2025 年 11 月 10 日，Banco Central do Brasil 发布了 Resolutions 519, 520 and 521，确立了 SPSAV (sociedade prestadora de serviços de ativos virtuais) 框架。交易所必须获得 SPSAV 授权，遵守最低实收资本要求（中介机构 R$100 万，托管机构 R$200 万，经纪商 R$300 万），且 CVM 对符合证券定义的代币化资产保留管辖权。对策略运行的影响：在大额 PIX 资金流转时，可能会遇到定期的 KYC 重新验证和资金来源审查要求。
Section 06 · 适用场景
适用场景
TradingHost Mercado Bitcoin 运行环境最适合用于：
- 构建 BRL 原生策略的巴西及拉美量化开发者
- 在 PIX 通道上运行生产级 BRL 现货账簿的金融科技与加密货币交易台
- 使用 Cursor 和 Claude Code 将策略部署到巴西执行场所的 AI IDE 优先开发者
- 使用 MB 合规代币化技术栈的代币化资产与 RWA 团队
- 在 BRL 交易对中交易 MBRL、BRZ、USDT、USDC 的稳定币与外汇套利团队
连接 GitHub 并创建首个策略完全免费。
Section 08 · 常见问题
常见问题
不是。TradingHost 是独立的，不隶属于 Mercado Bitcoin 或其母公司 2TM Participações。
不会。您的策略代码会连接 to Mercado Bitcoin，并根据您自己的逻辑、账户权限和集成方式发送指令。TradingHost 仅提供运行该代码的托管运行环境（runtime）。
不提供。Mercado Bitcoin API 的访问权限由 Mercado Bitcoin 提供。您需要自行负责您的 Mercado Bitcoin 账户、API 权限、凭据以及对 Mercado Bitcoin 条款的合规性。
不是。TradingHost 是运行您策略代码的云端运行环境。我们不提供交易信号、AI 预测模型或预建的机器人。使用 TradingHost，您需要自己编写或生成策略（通常使用 Cursor 或 Claude Code），将其作为代码保存在 GitHub 中，并使用 TradingHost 在生产环境中运行。3Commas、Cryptohopper 及类似产品拥有策略逻辑；而 TradingHost 则是运行您自己的策略。
AWS 和 DigitalOcean 为您提供的是原始算力。您需要自己处理操作系统更新、容器编排、日志传输、密钥轮转、区域故障转移以及在线率监控。而 TradingHost 为您提供的是专为交易策略打造的托管运行环境：开箱即用的 GitHub 原生部署、来自 AI IDE 的 MCP 驱动控制、日志和健康状况监控界面。如果您想自己运营基础设施，AWS 可以满足需求。如果您希望将运行环境作为托管服务，TradingHost 是更快捷的途径。
可以。TradingHost 支持运行 Python 策略；选择与您的技术栈匹配的框架运行环境，或者直接部署您自己的 GitHub 仓库。
可以。TradingHost 支持任何可以在容器内运行的语言。
支持。交易所 ID 为 mercado。它通过标准的 CCXT 统一接口公开 MB 现货市场。如果您在 TradingHost 上使用 Freqtrade 或任何其他基于 CCXT 的框架，请将交易所名称设置为 mercado。目前没有官方的 Hummingbot 连接器，该途径需要自定义连接器。请参阅 CCXT 框架运行环境以获取完整的配置说明。
可以，只要您的项目是这样设计的。您可以在单个运行环境中运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中，以实现隔离和清晰的运营管理。请参阅 TradingHost 运行环境页面了解多策略模型。
最快的方法是 fork 一个 TradingHost 框架运行环境：使用 CCXT 获取开箱即用的项目，或者连接您自己的 GitHub 策略仓库。关联 GitHub 仓库并创建策略是免费的；运行环境方案已在定价页面列出。
保存在您由 GitHub 控制的机密（secrets）工作流中。TradingHost 在运行时通过 GitHub 仓库机密、环境机密或您自己认可的密钥管理流程读取它们。TradingHost 不需要托管您的 API 密钥和私钥。请参阅平台机密了解完整的处理模型。
不需要。策略绝不应该需要提现权限。请使用所需的最小权限范围（读取加交易），并启用 Mercado Bitcoin 为您的密钥提供的任何 IP 白名单功能。具有提现功能的密钥应保留给您从固定主机手动操作的账户。
可以。TradingHost 支持针对 AI IDE 的基于 MCP 的控制，包括 Cursor、Claude Code、GitHub Copilot 和基于 CLI 的 AI 智能体（agents）。AI 工具可以检查部署、查看日志、重启策略并管理运行环境工作流。MCP 是控制和可观测性界面，而不是交易执行路径。请参阅 MCP 控制界面了解全貌。
两者皆可。MCP 控制界面在基于 CLI 的智能体（Claude Code CLI、自定义 MCP 客户端、脚本化 MCP 调用）和 IDE 内部同样表现出色。GitHub 原生部署循环在没有任何 AI 工具的情况下也能正常工作：向您的主分支进行常规的 git push 即可触发重新部署。
运行环境将检测到崩溃并展示相关的日志和健康信息。在支持的情况下，可以重启受影响的策略，而不会干扰在同一容器中运行的其他策略。您的策略代码仍需负责安全错误处理、重复订单保护和风险控制。请参阅可观测性了解日志和健康状况界面。
请确认您调用的是哪一代 API。新的 API /api/v4 使用 /authorize 流程，该流程会颁发一个在后续私有请求中发送的令牌；而传统的 TAPI /tapi/v3/ 在请求路径上使用 HMAC-SHA512，并带有 TAPI-ID 和 TAPI-MAC 请求头。混用这两者是最常见的原因。此外，请检查您的服务器时钟是否同步，以及 API 密钥是否已为您调用的操作（读取、交易、提现）启用了相应权限。
是的。BRL 资金充值由 MB 的 PIX 集成在交易 API 之外处理。PIX 在巴西银行系统中提供 24/7 全天候运行，因此存款通常会即时到账。一旦 BRL 进入您的 MB 账户，运行在 TradingHost 容器中的策略就会调用 MB API v4，针对 BRL 交易对进行下单。TradingHost 不会接触 PIX 或您的银行凭据。
MB 在巴西《虚拟资产法》（Lei 14.478/2022）框架下运营。Banco Central do Brasil 于 2025 年 11 月发布的 SPSAV Resolutions 519, 520 and 521 定义了虚拟资产服务商的许可制度，而 CVM 则负责监管符合证券定义的代币化资产。实盘交易需要完成完整的 KYC；提现额度与验证等级挂钩；代币化资产的端点可能会适用适当性或准入规则。这些都不会影响您的代码在 TradingHost 容器中的运行方式；它只影响 API key 背后的 MB 账户被允许执行的操作。
如需进行程序化访问，请在运行时检查有哪些系列通过 API v4 的 markets 端点公开。CVM 规则可能会对某些工具进行限制。MBRL 是 MB 在 TRON 上发行的锚定 BRL 的稳定币（于 2024 年 11 月推出），可在 MB 的订单簿上进行交易，是 BRL 端自动化的天然现金腿。请将 XRPL 上的代币化固定收益 RWA 系列视为具有自身市场结构的独立工具，而非 24x7 全天候运行的加密货币对。
TradingHost 在 EU 和 US-East 区域运行。请选择最靠近您策略所依赖的撮合引擎的区域。针对 Mercado Bitcoin，相比 EU，US-East 到圣保罗（São Paulo）区域云端点的往返延迟通常更低。有关路由和邻近性的详细信息，请参阅区域页面。
不支持。TradingHost 专注于实盘运行与部署。回测应当在您的研究技术栈、框架或 AlgoBuilder 中进行。