适用于 Bitso 交易策略的 AI 原生运行环境
在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署到托管云运行环境，享受一流的 MCP 控制、日志和拉美原生执行。
第 01 部分 · 一览
一览
- 交易平台
- Bitso
- 平台类型
- 加密货币交易所（拉美枢纽）
- 资产类别
- 加密货币
- 支持的产品
- 仅限现货。文档中提及杠杆交易（Margin）正在开发中；无期货或永续合约。
- 运行环境模式
- 容器化策略运行环境
- 部署源
- GitHub
- 编程语言
- 任何可在容器中运行的语言
- 常用集成
- 原生 Bitso REST 和 WebSocket，CCXT (`bitso`)，自定义
- AI 工作流集成
- MCP 控制面板
- TradingHost 角色
- 运行环境、部署、日志、健康检查、区域选择、MCP 控制
- Bitso 角色
- 交易所账户、API 访问、市场准入、执行场所、MXN/BRL/ARS 法币通道（SPEI、PIX）
- 关联关系
- TradingHost 是独立平台，与 Bitso 无任何隶属关系。Bitso 根据墨西哥的 Ley Fintech（受 CNBV 监管）运营，在阿根廷 CNV 注册为 PSAV no. 51（自 2024 年 7 月 19 日起），并持有直布罗陀 GFSC 颁发的机构虚拟资产服务牌照。
第 02 部分 · Bitso 平台功能
Bitso 平台功能
Bitso 是一家总部位于拉美的仅限现货的交易所，支持 MXN、BRL 和 ARS 法币通道（墨西哥的 SPEI、巴西的 PIX、阿根廷的本地 CBU/Alias）。策略通过 REST 和 WebSocket 连接到该交易所，并使用单个经 HMAC-SHA256 签名的 `Authorization: Bitso <key>:<nonce>:<sig>` 请求头进行身份验证。不提供衍生品、永续合约或期权；文档中提及的杠杆交易（margin）目前仅在开发中。
市场与策略模式
- MXN/USD 稳定币套利（USDT_MXN、USDC_MXN 价差）
- BRL 交易对执行（BTC_BRL、ETH_BRL 流动性捕获）
- ARS 溢价捕获（比索-稳定币溢价路由）
- 跨拉美盘口的 USDC/USDT 现货轮动
- 跨拉美投资组合再平衡（MXN、BRL、ARS、COP）
- 基于 SPEI/PIX 资金的稳定币交易台策略
- 结合前 20 档订单簿流的 BTC_MXN 做市
- 汇款通道库存对冲（墨西哥至美国资金流）
API 接口
- 产品范围
- 现货。沙盒地址为 `https://api-sandbox.bitso.com/api/v3/`（充值使用 BTC 测试网和 Ethereum 测试网）。
- 连接方式
- REST 接口地址为 `https://api.bitso.com/api/v3/`。WebSocket 接口地址为 `wss://ws.bitso.com`，包含 `trades`、`orders` 和 `diff-orders` 频道。
- 身份验证
- HMAC-SHA256。单个 `Authorization` 请求头，字面格式为 `Bitso <key>:<nonce>:<signature>`。签名为对 `nonce + HTTP_METHOD + request_path + json_payload` 进行 HMAC-SHA256 计算并进行十六进制编码。Nonce v2 正在逐步推出。
具体细节请参考 Bitso
具体端点、限频权重、交易对列表和费率层级请参见 Bitso 官方文档。请以官方文档为准。
第 03 部分 · 用 AI 构建
用 AI 构建您的 Bitso 策略
选择一种集成方式，Fork 一个 TradingHost 框架模板，然后在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI Agent 均可无缝接入相同的 GitHub 原生部署循环。
原生 Bitso API
通过 REST 和 WebSocket 直接控制 Bitso 的特定行为、账户数据和订单执行逻辑。
自定义连接器
您自己的内部交易引擎或专有的 Bitso 集成。
框架对 Bitso 的支持情况
Bitso 仅限现货交易，因此其框架支持矩阵比多产品交易所更简单：无需填写 USD-M、COIN-M 或期权列。如果您的策略需要永续合约或以 USD 为保证金的期货，请将 Bitso 与其他交易所（例如 Binance、Bybit 或 OKX）结合使用以执行衍生品部分。对于仅限现货的 Bitso 策略，原生 API 和 CCXT 是主要支持路径；Freqtrade 通过 CCXT 社区测试可用，而 Hummingbot 目前未提供 Bitso 连接器。
✓ 表示官方框架文档确认支持。“partial” 表示通过 CCXT 进行了社区测试，但未正式列出。“no connector” 表示该框架未提供 Bitso 连接器。工作流链接指向目前正在编写的 /workflows/ 页面。
TradingHost 不强求特定的框架，它只负责运行您的项目。
使用 AI 编写
上述框架模板与 AI IDE 是绝佳的搭配。TradingHost 的 MCP 控制面实现了闭环：AI 工具可以与您一同检查部署、查看日志并管理运行环境，但绝不会介入交易执行路径。
Section 04 · 在 TradingHost 上运行
在 TradingHost 上运行您的代码
Bitso 提供交易所和 API 访问。TradingHost 则提供生产环境，用于运行您连接到 Bitso 的策略。
无需在笔记本电脑、台式机、通用 VPS 或手动配置的服务器上运行策略代码，您只需从 GitHub 部署到由 TradingHost 托管的容器运行环境中。
您
- 您的代码库包含您的代码。
- 您的部署定义了其运行方式。
- 您的策略连接到 Bitso。
TradingHost
- 保持运行环境持续在线。
- 呈现日志和健康状况检查。
- 区域选择。
- 受控的部署环境。
部署流程
- 步骤 01
连接 GitHub
授权 TradingHost 访问您的 GitHub 帐户。
- 步骤 02
关联代码库或从框架开始
将 TradingHost 指向您现有的策略仓库，或者派生（fork）一个 TradingHost 框架运行环境（CCXT）作为可运行的基础模板。
- 步骤 03
部署至 TradingHost 容器
选择一个运行区域（EU 或 US-East），提供策略所需的环境变量（即您的 Bitso API 密钥，用于在每个签名请求中构建 Authorization: Bitso <key>:<nonce>:<sig> 请求头），然后一键部署。TradingHost 将直接从您的代码仓库构建容器，并在托管的 Kubernetes 基础设施上运行您的策略。您无需在本地安装 Docker。
- 步骤 04
监控日志与健康状况
通过 TradingHost 控制面板实时查看日志、健康状况和运行状态。该界面同样支持在任何 AI IDE 中通过 MCP 进行访问，方便 Cursor、Claude Code 或 CLI 智能体与您协同读取部署状态并管理运行环境。
- 步骤 05
更新与重新部署
将代码更改推送到 GitHub 的主分支（main branch），TradingHost 便会自动重新部署。
Section 05 · 运维说明
Bitso 运维说明
在容器化云运行环境中实际运行 Bitso 策略时可能会遇到的陷阱，这些内容未在 Bitso 文档或框架 README 中提及。以下每项说明均引用或改写自 Bitso 官方文档；部署侧的指南则源自于在 TradingHost 上运行这些策略的实际经验。
01 · 法币通道
SPEI、PIX 和本地 CBU/Alias 路由拉美法币
Bitso 通过 SPEI（墨西哥）路由 MXN，通过 PIX（巴西）路由 BRL，实现近乎即时的结算；ARS 则使用本地 CBU/Alias 通道。依赖法币充值的策略应考虑到通道截止时间和银行节假日。
02 · 频率限制
公共接口 60 RPM，私有接口 300 RPM
公共端点限制为每个 IP 每分钟 60 次请求；私有端点限制为每个账户在一分钟窗口内 300 次请求。超出限制将触发一分钟的锁定。请相应地规划轮询和下单节奏；行情数据建议优先使用 WebSocket。
03 · 身份验证签名
包含 key、nonce 和 signature 的单一 Authorization 请求头
Bitso 使用单一的 `Authorization: Bitso <key>:<nonce>:<sig>` 请求头。每个 key 的 nonce 必须严格递增；时钟漂移和并发工作线程是导致 error `0215`（请求签名不正确）以及 nonce 无效被拒的常见原因。
04 · KYC 等级
认证账户解锁私有 API 及更高额度
认证账户可解锁私有 API 访问权限以及更高的充提限额。根据墨西哥 2025 年 7 月的反洗钱（AML）改革，等级限制和强制交易报告要求已收紧（210 UMA 报告门槛，约合 1,180 美元）。
05 · 合规监管
墨西哥 Ley Fintech、阿根廷 CNV PSAV、直布罗陀 GFSC
Bitso 在墨西哥根据由 CNBV 监管的 2018 年金融科技法（Ley Fintech）运营。机构虚拟资产服务通过直布罗陀 GFSC 实体获得许可。在阿根廷，Bitso 是向 CNV 注册的 PSAV no. 51（于 2024 年 7 月 19 日注册），且必须在 2025 年 12 月 31 日前满足 General Resolution 1058 的要求。
Section 06 · 适用场景
适用场景
TradingHost Bitso 运行环境最适合用于：
- 在单一运行环境中运行 MXN、BRL 和 ARS 交易对的拉美量化团队
- 运行以 SPEI 资金支持的自动化策略的墨西哥开发者
- 将 PIX 流动性引入 BRL 现货订单簿的巴西加密货币交易台
- 针对拉美法币进行 USDC/USDT 稳定币套利的套利操作员
- 在墨西哥至美国通道中使用稳定币通道的汇款与财资团队
连接 GitHub 并创建首个策略完全免费。
Section 08 · 常见问题
常见问题
没有。TradingHost 是独立的，与 Bitso 没有任何隶属关系。
不会。您的策略代码会根据您自己的逻辑、账户权限和集成方式连接到 Bitso 并发送指令。TradingHost 仅提供运行该代码的托管环境。
不提供。Bitso API 访问权限由 Bitso 提供。您需要自行负责您的 Bitso 账户、API 权限、凭据以及对 Bitso 条款的合规性。
不是。TradingHost 是运行您策略代码的云端运行环境。我们不提供交易信号、AI 预测模型或预建的机器人。使用 TradingHost，您需要自己编写或生成策略（通常使用 Cursor 或 Claude Code），将其作为代码保存在 GitHub 中，并使用 TradingHost 在生产环境中运行它。3Commas、Cryptohopper 及类似产品拥有策略逻辑；而 TradingHost 则是运行您自己的策略。
AWS 和 DigitalOcean 为您提供的是原始算力。您需要自己处理操作系统更新、容器编排、日志传输、密钥轮换、区域故障转移和在线率监控。而 TradingHost 为您提供专为交易策略构建的托管运行环境：开箱即用的 GitHub 原生部署、AI IDE 的 MCP 驱动控制、日志和健康状况监控界面。如果您想自己运营基础设施，AWS 可以满足需求。如果您希望将运行环境作为托管服务，TradingHost 是更便捷的途径。
可以。TradingHost 支持运行 Python 策略；选择与您的技术栈匹配的框架运行环境，或者直接部署您自己的代码库。
可以。TradingHost 支持任何可以在容器内运行的语言。
可以。CCXT 的 bitso 交易所模块涵盖了现货端点，处理 HMAC-SHA256 签名，并且无需修改即可在 TradingHost 容器内运行。由于 Bitso 仅提供现货交易，因此不适用杠杆和期货方法。有关完整配置说明，请参阅 CCXT 框架运行环境文档。
可以，只要您的项目是这样设计的。您可以在一个运行环境中运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中，以实现隔离和运行清晰度。有关多策略模型的更多信息，请参阅 TradingHost 运行环境页面。
最快的方法是 fork 一个 TradingHost 框架运行环境：例如使用 CCXT 获取开箱即用的部署项目。或者连接您自己的 GitHub 策略代码库。关联 GitHub 代码库并创建策略是免费的；运行环境方案已在定价页面列出。
保存在您由 GitHub 控制的机密（secrets）工作流中。TradingHost 在运行时通过 GitHub 仓库机密、环境机密或您自己认可的密钥管理流程来读取它们。TradingHost 不需要托管您的 API key 和 secret。有关完整的处理模型，请参阅平台机密文档。
不需要。策略绝不应该需要提币权限。请使用限定范围的权限（只读、交易），并在合适的地方启用 IP 白名单。请将提币权限保留给您在固定 IP 主机上手动操作的密钥。
可以。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 即可触发重新部署。
运行环境会检测到崩溃并展示相关的日志和健康信息。在支持的情况下，受影响的策略可以重新启动，而不会干扰在同一容器中运行的其他策略。您的策略代码仍需负责安全的错误处理、防重复下单保护和风险控制。有关日志和健康状况界面，请参阅可观测性文档。
这几乎总是 nonce 或签名构建问题。Bitso 要求每个 key 的 nonce 严格递增（正在推广 Nonce v2），并使用 HMAC-SHA256 对 nonce + METHOD + path + body 进行十六进制编码签名。常见原因包括：多副本之间的时钟偏差、两个工作线程共享同一个 key，或者路径末尾的斜杠被去掉了。
墨西哥的 SPEI (MXN)、巴西的 PIX (BRL) 以及阿根廷的本地 CBU/Alias (ARS)。虽然 PIX 和 SPEI 均可在数秒内完成结算，但仍受通道截止时间和银行节假日限制。自动平衡法币库存的策略应将通道可用性视为运行时（runtime）输入。
Bitso 在墨西哥受 CNBV 监管并依据 Ley Fintech 运营，在阿根廷 CNV 注册为 PSAV no. 51，在巴西设有分支机构，并持有直布罗陀 GFSC 牌照以提供机构级虚拟资产服务。墨西哥 2025 年 7 月的反洗钱（AML）改革对虚拟资产服务商（VASP）增加了报告义务，单笔交易额达到约 1,180 美元即需申报。
不开放。Bitso 不向美国居民提供账户，并对包括美国和加拿大在内的约 33 个司法管辖区实施限制。虽然 TradingHost 可以在任何地区运行您的策略，但 Bitso 账户本身必须符合 Bitso 的服务条款。
TradingHost 在 EU 和 US-East 区域运行。请选择最靠近您策略所依赖的撮合引擎的区域。有关路由和延迟的详细信息，请参阅区域页面。
不支持。TradingHost 专注于生产环境的运行和部署。回测应当在您的研究技术栈、框架或 AlgoBuilder 中进行。