适用于 Coins.ph 交易策略的 AI 原生运行时
在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署到托管云端运行时，享有原生 MCP 控制、日志和区域选择支持。
第 01 部分 · 一览
一览
- 交易平台
- Coins.ph
- 平台类型
- 加密货币交易所（受菲律宾 BSP 监管）
- 资产类别
- 支持 PHP 法币计价的加密货币
- 支持的产品
- PHP 计价交易对（BTCPHP、ETHPHP、USDCPHP 等）及 USDT 和 USDC 稳定币对的现货交易，母账户与虚拟子账户层级，以及支持 INSTANT、MANUAL_DEFER 和 AUTO_DEFER 结算模式的 TradeDesk OTC
- 运行环境模式
- 容器化策略运行时
- 部署源
- GitHub
- 编程语言
- 任何可在容器中运行的语言
- 常用集成
- 原生 Coins.ph REST 和 WebSocket、CCXT、自定义连接器
- AI 工作流集成
- 适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 代理的 MCP 控制面
- TradingHost 角色
- 运行时、部署、日志、健康检查、区域选择、MCP 控制
- Coins.ph 角色
- 交易所账户、API 访问、市场接入、执行场所
- 关联关系
- TradingHost 是独立平台，与 Coins.ph 无任何隶属关系
第 02 部分 · Coins.ph 平台功能
Coins.ph 平台功能
Coins.ph 通过 REST 和 WebSocket API 提供 PHP 计价交易对（BTCPHP、ETHPHP、USDCPHP 等）以及 USDT/USDC 稳定币对的现货交易。策略通过限定路由类别的 `X-COINS-APIKEY` 请求头进行身份验证，该交易所还提供母账户和虚拟子账户，以实现各策略间的隔离。具体端点可能会随时间变化。虽然整体架构保持稳定，但具体的速率限制权重、交易对列表和法币通道限制请以 Coins.ph 的官方文档为准。
市场与策略模式
- PHP 计价现货策略（BTCPHP、ETHPHP、USDCPHP）
- USDT/USDC 与 PHP 之间的稳定币-法币套利
- 通过 INSTAPAY 资金通道运行的日内策略
- TradeDesk OTC 结算（INSTANT、MANUAL_DEFER、AUTO_DEFER）
- 基于母账户和虚拟子账户隔离的多策略部署
- 带 5 分钟心跳维持的 WebSocket 用户数据流（User Data Stream）消费者
- 菲律宾比索计价基差对冲与 USDT 套利策略
API 接口
- 产品范围
- 通过公开的 REST 和 WebSocket API 进行 PHP 计价交易对和 USDT/USDC 交易对的现货交易。母账户和虚拟子账户层级支持针对单个策略设置 IP 限制和细粒度的资产划转控制。TradeDesk OTC 支持 INSTANT、MANUAL_DEFER 和 AUTO_DEFER 结算模式，适用于大额资金流。
- 连接方式
- REST 用于下单和账户查询。WebSocket 流用于实时行情和深度数据。WebSocket 用户数据流（User Data Streams）用于账户、余额和订单事件。Coins.ph 要求每 5 分钟发送一次心跳（ping）；闲置的 WebSocket 连接在此窗口期后会自动断开。
- 身份验证
- 每个策略需配置独立的 API Key 和 Secret。`X-COINS-APIKEY` 请求头限定了路由类别（仅限 TRADE、USER_DATA、USER_STREAM），默认允许所有路由。建议针对每个策略收窄权限。在权限范围之外，还需遵守基于 IP 的速率限制。
具体细节请参考 Coins.ph
具体端点、速率限制权重、交易对列表、手续费等级和版本历史均记录在 Coins.ph 的官方文档中。请以此为准。
第 03 部分 · 用 AI 构建
用 AI 构建您的 Coins.ph 策略
选择一种集成方式，Fork 一个 TradingHost 框架模板，然后在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI Agent 均可无缝接入相同的 GitHub 原生部署循环。
原生 Coins.ph API
直接控制 Coins.ph 特有的行为、子账户层级以及 PHP 计价订单路由。
Freqtrade 或 Hummingbot
目前这两个框架均未将 Coins.ph 列为原生支持的交易所。最佳路径是采用自定义实现或基于 CCXT 的实现。
自定义连接器
您自己内部的交易引擎，或针对 REST 和 WebSocket API 的专属 Coins.ph 集成。
框架对 Coins.ph 产品的支持情况
各框架的支持程度有所不同。Coins.ph 在交易所层面仅支持现货（无原生永续合约或期权），因此该矩阵设计较为精简。CCXT 通过其统一的 `coinsph` 类提供 Coins.ph 现货支持。目前 Freqtrade 和 Hummingbot 均未将 Coins.ph 列为原生支持的交易所；通过原生 API 访问则可对接 Coins.ph 开放的所有功能。
✓ 表示官方框架文档确认支持。"no" 表示官方文档未记录支持。工作流链接指向目前正在编写的 /workflows/ 页面。
TradingHost 不强求特定的框架，它只负责运行您的项目。
使用 AI 编写
上述框架模板与 AI IDE 是绝佳的搭配。TradingHost 的 MCP 控制面实现了闭环：AI 工具可以与您一同检查部署、查看日志并管理运行环境，但绝不会介入交易执行路径。
Section 04 · 在 TradingHost 上运行
在 TradingHost 上运行您的代码
Coins.ph 提供交易所和 API 访问。TradingHost 则提供生产环境，用于运行您连接到 Coins.ph 的策略。
无需在笔记本电脑、台式机、通用 VPS 或手动配置的服务器上运行策略代码，您只需从 GitHub 部署到由 TradingHost 托管的容器运行环境中。
您
- 您的代码库包含您的代码。
- 您的部署定义了其运行方式。
- 您的策略连接到 Coins.ph。
TradingHost
- 保持运行环境持续在线。
- 呈现日志和健康状况检查。
- 区域选择。
- 受控的部署环境。
部署流程
- 步骤 01
连接 GitHub
授权 TradingHost 访问您的 GitHub 帐户。
- 步骤 02
关联代码库或从框架开始
将 TradingHost 指向您现有的策略仓库，或者派生（fork）一个 TradingHost 框架运行时（CCXT），以建立对接 Coins.ph REST 和 WebSocket API 的可用基线。
- 步骤 03
部署至 TradingHost 容器
选择一个区域（EU 或 US-East），提供策略所需的环境变量（Coins.ph API 密钥、密钥、子账户标识符），然后部署。TradingHost 将从仓库构建您的容器，并在托管的 Kubernetes 基础设施上运行您的策略。无需本地安装 Docker。
- 步骤 04
监控日志与健康状况
通过 TradingHost 控制面板实时查看日志、健康状况和运行状态。该界面同样支持在任何 AI IDE 中通过 MCP 进行访问，方便 Cursor、Claude Code 或 CLI 智能体与您协同读取部署状态并管理运行环境。
- 步骤 05
更新与重新部署
将代码更改推送到 GitHub 的主分支（main branch），TradingHost 便会自动重新部署。
Section 05 · 运维说明
Coins.ph 运维说明
在容器化云端运行时中实际运行 Coins.ph 策略时会遇到的坑，这些在 Coins.ph 文档或框架的 README 中是找不到的。以下所有说明均引用或改写自 Coins.ph 的官方文档；部署侧的指南则源自我们在 TradingHost 上运行这些策略的实际经验。
01 · 速率限制
基于 IP 的单端点 120 次请求/分钟限制；HTTP 418 封禁时间从 2 分钟递增至 3 天
Coins.ph 对 REST API 实施基于 IP 的单端点每分钟 120 次请求的速率限制。重复违规会导致封禁时间从 2 分钟递增至 3 天。在不同 Pod 之间重新调度容器的云运行时可能会反复触发同一个 IP 的限制。在 TradingHost 上，容器的出口 IP 在每个区域都是固定的，因此正确的做法是根据官方公布的单端点限制来规划您的请求频率，并在遇到 HTTP 418 时采用带指数抖动的退避策略，而不是立即重试。
02 · WebSocket 心跳维持
无 ping 信号时，闲置的 WebSocket 连接将在 5 分钟后自动断开
Coins.ph 要求 WebSocket 连接每 5 分钟发送一次心跳 ping。超过该时间的无活动连接将触发自动断开。在容器中 24/7 运行的策略必须实现心跳循环和带退避机制的重连策略。订阅丢失是静默的：在 WebSocket 会话失效期间通过 REST 下达的订单仍会成交，但在重新建立连接之前，订单状态回调将停止触发。
03 · API Key 权限范围
`X-COINS-APIKEY` 权限范围默认包含所有路由；建议按策略进行最小权限配置
`X-COINS-APIKEY` 请求头按路由类别（TRADE-only、USER_DATA、USER_STREAM）划分权限范围，但默认允许访问所有路由。更安全的模式是为每个策略配置一个专属的、仅包含该策略所需路由类别的 API Key。泄露的 TRADE-only 密钥无法读取其他用户的余额；而泄露的默认权限密钥则可以执行该账户被允许的所有操作。交易策略绝不需要提现权限。
04 · OTC 结算模式
TradeDesk OTC 支持 INSTANT、MANUAL_DEFER 和 AUTO_DEFER
对于通过 Coins.ph TradeDesk OTC 柜台而非公开订单簿路由的大额资金流，结算支持以下三种模式之一：INSTANT（按约定价格立即执行）、MANUAL_DEFER（在您确认的未来时间结算）、AUTO_DEFER（根据柜台的时间表自动延迟结算）。集成 TradeDesk 路径的策略必须将结算模式的选择作为核心配置，因为 INSTANT 与延迟结算模式之间的持仓生命周期存在实质性差异。
05 · 法币通道限制
INSTAPAY 和 SWIFTPAY_PESONET 设有独立的每日、每月和年度限额
通过 INSTAPAY（实时，24/7）和 SWIFTPAY_PESONET（批量，工作日）进行的 PHP 出金受限于独立的每日、每月和年度限额，这些限额适用于账户级别，而非单个策略。针对 PHP 法币出金通道的策略必须对照您 Coins.ph 账户中公布的机构级 TradeDesk 限额进行资金预算；额度耗尽会表现为提现请求被延迟或拒绝，而不是 API 错误。在规划策略资金部署时，应考虑通道限制，而非仅看订单簿。
06 · 子账户
主账户与虚拟子账户层级提供单策略 IP 与划转隔离
Coins.ph 支持主/虚拟子账户层级，并提供细粒度的 IP 限制和资产划转控制。多策略部署的正确模式是为每个策略分配一个虚拟子账户，每个子账户拥有自己专属权限的 API Key、绑定到 TradingHost 区域出口的 IP 白名单以及明确的划转额度。这样，单个策略的故障不会影响其他策略，且密钥泄露的影响范围也被限制在对应虚拟子账户的余额内。
Section 06 · 适用场景
适用场景
TradingHost Coins.ph 运行环境最适合用于：
- 在 AI IDE（Cursor、Claude Code）中构建策略的开发者
- 系统化加密货币交易员
- 量化开发者
- CCXT 用户
- 正在从 VPS 托管转向容器化部署的团队
连接 GitHub 并创建首个策略完全免费。
Section 08 · 常见问题
常见问题
没有。TradingHost 是独立的，与 Coins.ph 没有任何隶属或合作关系。
不会。您的策略代码会连接 to Coins.ph，并根据您自己的逻辑、账户权限和集成方式发送交易指令。TradingHost 仅提供运行该代码的托管环境。
不提供。Coins.ph API 访问权限由 Coins.ph 官方提供。您需要自行负责您的 Coins.ph 账户、API 权限、凭据以及对 Coins.ph 条款的合规性。
不是。TradingHost 是运行您策略代码的云端运行环境。我们不提供交易信号、AI 预测模型或预建的机器人。使用 TradingHost，您需要自己编写或生成策略（通常使用 Cursor 或 Claude Code），将其作为您自己的代码保存在 GitHub 中，然后使用 TradingHost 在生产环境中运行它。3Commas、Cryptohopper 及类似产品拥有并提供策略逻辑；而 TradingHost 则是运行您自己的策略。
AWS 和 DigitalOcean 为您提供的是原始算力。您需要自己处理操作系统更新、容器编排、日志传输、密钥轮换、区域容灾和在线率监控。TradingHost 则为您提供专为交易策略打造的托管运行环境：原生支持 GitHub 部署、支持通过 AI IDE 进行 MCP 驱动的控制，并开箱即用提供日志和健康状态面板。如果您想自己运营基础设施，AWS 没问题。如果您希望将运行环境作为托管服务，TradingHost 是更便捷的途径。
可以。TradingHost 支持运行 Python 策略；选择与您的技术栈匹配的框架运行环境，或直接部署您自己的代码仓库。
可以。TradingHost 支持任何可以在容器内运行的语言。
可以。CCXT 提供了一个统一的 `coinsph` 类，涵盖了 Coins.ph 上以 PHP 计价的交易对的现货交易。将您的 CCXT 策略放入容器中，将其指向 GitHub，TradingHost 就会像运行其他任何 Python 或 Node 项目一样运行它。有关完整设置，请参阅 CCXT 框架运行环境。
可以。Coins.ph 的 PHP 计价交易对（BTCPHP、ETHPHP、USDCPHP 等）与稳定币交易对一样，都是通过相同的 REST 和 WebSocket API 进行访问。您容器内的策略代码使用您的 Coins.ph API Key 进行身份验证，而 TradingHost 在运行环境层面上是与交易平台无关的。PHP 资金通道（INSTAPAY、SWIFTPAY_PESONET）和 TradeDesk OTC 结算发生在 Coins.ph 侧，而非 TradingHost 内部。
可以，只要您的项目是这样设计的。您可以在一个运行环境中运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中，以实现隔离和运行清晰度。针对 Coins.ph，建议将每个策略与一个虚拟子账户配对，这样在交易平台层面上也能控制影响范围。有关多策略模式，请参阅 TradingHost 运行环境页面。
最快的方法是 fork 一个 TradingHost 框架运行环境：例如使用 CCXT 获取开箱即用的项目。或者连接您自己的 GitHub 策略仓库。关联 GitHub 仓库并创建策略是免费的；运行环境方案已在定价页面列出。
存储在您通过 GitHub 控制的机密（secrets）工作流中。TradingHost 在运行时通过 GitHub 仓库机密、环境机密或您自己认可的机密管理流程读取它们。TradingHost 不需要托管您的 API Key 和密钥。有关完整的处理模式，请参阅平台机密。
不需要。交易策略绝不应该需要提现权限。请将 `X-COINS-APIKEY` 的范围限制在您策略实际使用的路由类别（如仅限 TRADE-only 或 USER_DATA），并完全关闭该密钥的提现功能。
可以。TradingHost 支持针对 AI IDE 的基于 MCP 的控制，包括 Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI 智能体。AI 工具可以检查部署、查看日志、重启策略并管理运行环境工作流。MCP 是一个控制和可观测性界面，而不是交易执行路径。有关完整信息，请参阅 MCP 控制界面。
两者皆可。MCP 控制界面在基于 CLI 的智能体（Claude Code CLI、自定义 MCP 客户端、脚本化 MCP 调用）和 IDE 内部同样表现出色。原生的 GitHub 部署循环在没有任何 AI 工具的情况下也能正常工作：向您的主分支进行常规的 git push 即可触发重新部署。
运行环境会检测到崩溃，并展示相关的日志和健康信息。在支持的情况下，受影响的策略可以被重启，而不会干扰在同一个容器中运行的其他策略。您的策略代码仍需负责安全错误处理、重复订单保护和风险控制。有关日志和健康界面，请参阅可观测性。
Coins.ph 强制执行基于 IP 的每个端点 120 次请求/分钟的速率限制，并在重复违规时将 HTTP 418 封禁时间从 2 分钟逐步升级至 3 天。解决方法是将您的请求频率调整到公布的每个端点限制内，在首次遇到 418 时使用指数退避和抖动（exponential jitter）进行重试，而不是立即重试，并避免轮询循环产生的突发流量。有关完整指南，请参阅上方的“运行说明”部分。
TradingHost 在 EU 和 US-East 区域运行。请选择最靠近您策略所依赖的撮合引擎的区域。有关路由和邻近度详情，请参阅区域页面。
不支持。TradingHost 专注于生产环境的运行和部署。回测属于您的研究技术栈、框架或 AlgoBuilder 的范畴。