storyclaw-official Skill: trade-executor（接口定义）
接口层：定义前置条件、风控流程、用户确认格式、审计记录结构，与具体交易所无关。 各交易所的下单 API 和签名方式见
impl/目录：
impl/binance.md— Binance 实现impl/okx.md— OKX 实现新增交易所时，只需添加对应
impl/{exchange}.md，本文件无需修改。
概述
执行加密货币交易，包含完整的风控检查和用户确认流程。
触发条件
- 用户明确要求下单
- market-monitor 产生信号且用户已预授权（
confidence ≥ 0.85）
前置条件（全部满足才执行）
- 用户已明确确认交易意图
- 风控检查全部通过（见下方清单）
- 交易对在白名单中（见 openclaw.json
allowedPairs） - 目标交易所的 API Key 已配置且有效
风控检查清单
[RISK CHECK] 执行前逐项验证:
├── [ ] 交易对在白名单? (BTC/USDT, ETH/USDT, SOL/USDT)
├── [ ] 单笔金额 ≤ 1,000 USDT?
├── [ ] 今日交易笔数 < 20? ← 由网关跨 session 追踪
├── [ ] 今日累计亏损 < 500 USDT? ← 由网关跨 session 追踪
├── [ ] 操作类型安全? (非提币/转账/改权限)
├── [ ] 用户已确认?
└── [ ] 止损已设置?
任何一项未通过 → 拒绝执行，向用户说明具体原因。
执行流程
1. 参数验证
必需: exchange, pair, side (buy/sell), type (limit/market), quantity
可选: price（limit 单必须）, stopLoss, takeProfit
2. 用户确认展示
交易确认:
交易所: {exchange}
交易对: {pair}
方向: 买入 / 卖出
类型: 限价单 / 市价单
价格: ${price}
数量: {quantity} {base}
金额: ${amount}
止损: ${stopLoss} (-{pct}%)
止盈: ${takeProfit} (+{pct}%)
请回复 "确认" 执行，或 "取消" 放弃
3. 下单
根据 exchange 参数加载对应 impl/{exchange}.md，调用其下单 API。
4. 结果处理
- 成功：返回订单 ID 和成交详情
- 部分成交：通知用户，继续监控剩余数量
- 失败：返回错误说明，建议处理方式
审计记录格式
每笔交易由网关自动记录（Vega 无需写入）：
{
"tradeId": "uuid",
"timestamp": "ISO8601",
"exchange": "binance | okx",
"pair": "BTC/USDT",
"side": "buy | sell",
"type": "limit | market",
"price": 0.0,
"quantity": 0.0,
"amountUSD": 0.0,
"stopLoss": 0.0,
"takeProfit": 0.0,
"orderId": "exchange_order_id",
"status": "filled | partial | rejected | cancelled",
"riskChecks": { "allPassed": true, "details": [] },
"userConfirmed": true
}
安全约束
- 用户确认是强制流程，不可跳过，不可由代码自动确认
- exec = deny，write = deny（Vega 自身不写任何文件）
- 所有交易记录由网关写入审计日志
- 风控违规自动拒绝并告警