核心功能
TradeRouter 是专为 Solana 生态设计的交易执行基础设施，提供从即时兑换到复杂策略订单的完整交易能力。核心功能包括：
即时交易执行：通过 POST /swap 构建未签名交易，经客户端签名后通过 POST /protect 提交，享受 Jito MEV 保护与质押连接通道的优先处理。
高级订单类型：WebSocket 连接支持限价单（止盈/止损/抄底/突破）、追踪止损（自动跟随市场峰值回调触发）、TWAP 时间加权平均价订单，以及三者的组合策略（限价+TWAP、追踪+TWAP、限价+追踪、限价+追踪+TWAP）。
钱包与持仓管理：POST /holdings 扫描钱包 SPL Token 持仓，返回带有流动性池信息的可售代币列表。
市场数据服务：GET /mcap 提供代币市值、价格及流动性池信息；GET /flex 生成交易卡片 PNG 图片。
显著优点
1. 无需 API 密钥：钱包地址即唯一身份标识，降低密钥管理复杂度；WebSocket 订单通过挑战-响应签名机制实现去信任化认证
2. MEV 保护内置：所有交易默认通过 Jito 质押通道提交，防范三明治攻击与抢跑
3. 组合策略灵活：独创的订单类型叠加机制（如限价触发后进入追踪阶段，再触发后执行 TWAP 分散出货）满足专业交易者的复杂风控需求
4. 自托管安全架构：私钥始终留存客户端，服务端仅接收已签名交易，无托管风险
5. 生产级参考实现：提供完整 Node.js/Python 客户端代码，内置安全护栏（单日亏损上限、代币冷却期、紧急熔断开关）、详尽的预检清单与日志规范
潜在局限
- WebSocket 依赖：限价单、追踪单、TWAP 等高级订单必须保持 WebSocket 长连接，断线期间无法接收成交推送，需实现自动重连与重新注册逻辑
- 编码转换复杂：
/swap返回 base58 编码的未签名交易，而/protect要求 base64 编码的已签名交易，需严格的编解码流水线（解码→反序列化→签名→序列化→再编码） - 链上确认延迟：
/protect阻塞等待链上确认，网络拥堵时 30 秒超时可能触发，需配合 RPC 状态查询实现幂等重试 - 市值数据可靠性：
filled_mcap字段可能为 0 或 null，成交逻辑不可依赖该字段做有效性判断 - 无自动 DCA 链式执行：DCA 需客户端显式在每次成交后重新下单，非全自动托管
适合人群
- Solana 生态的量化交易开发者与自动化策略团队
- 需要 MEV 保护的专业 DeFi 交易者
- 希望实现止盈止损、追踪止损、TWAP 等高级订单的个人投资者
- 构建交易机器人、跟单系统或资管工具的开发者
常规风险
1. 智能合约风险：底层路由通过 Raydium、PumpSwap、Orca、Meteora 等 DEX 执行，需信任对应协议的安全性
2. WebSocket 连接风险：断线可能导致错过成交时机，需实现健壮的重连机制与状态同步
3. 滑点与流动性风险：新币/低流动性代币需设置 1500-2500 bps 滑点，否则交易易失败
4. 私钥泄露风险：客户端签名模式要求私钥可访问，需确保运行环境安全，禁止日志打印私钥
5. 服务器签名验证绕过风险：客户端可选择禁用服务端签名验证（TRADEROUTER_REQUIRE_SERVER_SIGNATURE=false），此模式仅建议测试环境使用，生产环境务必启用验证以防止恶意指令
6. 订单静默过期：订单在 expiry_hours 后自动失效，服务端不推送过期事件，需客户端主动轮询 list_orders 检测