trade-router-mcp

Trade Router — ClawHub 技能

面向 AI Agent 的非托管 Solana 交易 API。 一个接口即可处理兑换、MEV 保护执行、钱包持仓、限价订单、追踪止损、DCA、TWAP 和组合订单。私钥始终由调用 API 的 Agent 持有。

这安全吗？

安全，原因如下。 私钥永远不会通过网络发送到 api.traderouter.ai。POST /swap 会返回一笔未签名的交易；Agent 在本地签名；只有已签名的交易才会发送到 POST /protect（受 Jito MEV 保护的交易捆绑包）。服务器响应会根据硬编码的信任锚点进行 Ed25519 验证。完整的威胁模型、数据流图和权限清单，请参阅 SECURITY.md。

签名流程：

1. Agent 调用该技能的 swap 操作 → 通过 HTTPS 向 api.traderouter.ai 发送钱包地址（公钥）、代币 mint 和数量
2. API 返回一笔未签名的交易
3. Agent 使用自己的私钥在本地签署交易
4. 已签名的交易会提交到 /protect（受 Jito MEV 保护的交易捆绑包）
5. 服务器确认交易并返回余额变化。私钥不会离开 Agent 所在的计算机。

使用此技能的两种方式

A. 直接集成 API（SKILL.md 中的文档说明）

阅读 SKILL.md，了解完整的 API 规范，包括 REST 端点、WebSocket 订单协议、请求/响应格式、错误处理和参考 Agent 示例代码。配合任意 HTTP 客户端和 Solana 签名库使用。

SKILL.md 中的示例代码采用以下约定（你可以自行选择其他约定——这些只是 Agent 的选择，并非 API 强制要求）：

示例环境变量	示例默认值	在参考 Agent 中的用途
PRIVATE_KEY	（必需）	Agent 进程持有的 Solana base58 私钥
DRY_RUN	true	默认安全防护机制——只有将 DRY_RUN=false 时才会提交兑换操作
MAX_DAILY_LOSS_LAMPORTS	2_000_000_000（2 SOL）	超过此限额时，会激活参考 Agent 的 KILL_SWITCH

这些是参考 Agent 自己的约定。API 本身不要求使用其中任何一项。

B. 现成的 MCP 服务（@traderouter/trade-router-mcp）

对于 Claude Desktop、Cursor、Cline 以及任何兼容 MCP 的客户端，已发布的 MCP 服务可封装同一 API：

npx -y @traderouter/trade-router-mcp

或者将其接入 MCP 客户端配置：

{
  "mcpServers": {
    "traderouter": {
      "command": "npx",
      "args": ["-y", "@traderouter/trade-router-mcp"],
      "env": {
        "TRADEROUTER_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

MCP 服务的环境变量约定与 SKILL.md 中的示例代码不同——为避免多 MCP 环境中的命名空间冲突，变量均以 TRADEROUTER_ 为前缀：

MCP 环境变量	必需	用途
TRADEROUTER_PRIVATE_KEY	✅	Solana base58 私钥（仅本地使用）
SOLANA_RPC_URL	❌	自定义 RPC（默认使用 mainnet-beta）
TRADEROUTER_SERVER_PUBKEY	❌	覆盖服务器 Ed25519 信任锚点
TRADEROUTER_SERVER_PUBKEY_NEXT	❌	服务器轮换期间接受额外的密钥
TRADEROUTER_REQUIRE_SERVER_SIGNATURE	❌	默认值为 true；order_filled 验证失败时拒绝通过
TRADEROUTER_REQUIRE_ORDER_CREATED_SIGNATURE	❌	默认值为 true；order_created 验证失败时拒绝通过

MCP 服务目前尚未实现 DRY_RUN 或每日亏损上限——这些功能仅存在于 SKILL.md 中的参考 Agent 示例。如需端到端实现这些功能，可以直接采用参考 Agent 模式，或为 MCP 工具调用添加自己的防护机制。

完整详情、全部 21 个工具以及 LangChain 适配器代码片段，请参阅 npm 包 README：https://www.npmjs.com/package/@traderouter/trade-router-mcp

功能

REST 端点

端点	用途
POST /swap	构建未签名的兑换交易（支持多个 DEX：Raydium、PumpSwap、Orca、Meteora）
POST /protect	通过 Jito bundle 提交已签名的交易 — 受 MEV 保护，并返回已确认的余额变动
POST /holdings	精确扫描钱包 — 可捕获标准 RPC 会漏掉的代币
GET /mcap	查询任意代币的市值和价格
GET /flex	生成交易卡片 PNG
GET /security	获取服务信任锚公钥

WebSocket（wss://api.traderouter.ai/ws）

用于服务端订单监控的持久连接：

• 限价订单 — 按市值或价格触发
• 追踪止损 — 百分比或绝对值
• DCA / TWAP — 按时间加权执行
• 组合订单 — 限价+追踪止损、限价+TWAP、追踪止损+TWAP、限价+追踪止损+TWAP

服务端约每 5s 轮询一次市值。订单触发时，你会收到一笔未签名交易 → 在本地签名 → 提交。

信任锚

内置的服务端公钥为 EXX3nRzfDUvbjZSmxFzHDdiSYeGVP1EGr77iziFZ4Jd4。每条 order_filled、order_created 和 twap_execution 消息都会先使用此密钥进行 Ed25519 验证，再视为权威信息。服务端可通过 TRADEROUTER_SERVER_PUBKEY_NEXT 轮换密钥。

费用

兑换交易量按固定费率 1% 收费，并在 /protect 路由时计入。无需订阅、API 密钥或月度最低消费。只读端点（/holdings、/mcap）免费。

链接

• 网站： https://traderouter.ai
• llms.txt： https://traderouter.ai/llms.txt
• npm（MCP 服务）： https://www.npmjs.com/package/@traderouter/trade-router-mcp
• PyPI（MCP 服务）： https://pypi.org/project/traderouter-mcp/
• MCP Registry： https://registry.modelcontextprotocol.io/v0/servers?search=trade-router
• ClawHub 列表： https://clawhub.ai/re-bruce-wayne/trade-router
• GitHub 源码： https://github.com/re-bruce-wayne/openclaw-skills/tree/main/trade-router
• X/Twitter： https://x.com/trade_router
• Moltbook： https://moltbook.com/u/traderouter

安全漏洞披露

发现漏洞？请发送邮件至 [email protected]，或使用此仓库的 GitHub Security Advisories。我们会在 48 小时内确认收到。完整政策请参阅 SECURITY.md。

许可证

MIT。请参阅 LICENSE。

更新日志

请参阅 CHANGELOG.md。