用途:在交易所(Binance、OKX)执行加密货币交易,前置条件包括用户明确确认交易意图、风控全部通过、交易对在白名单、目标交易所 API Key 已配置且有效。触发条件为用户明确要求下单,或 market-monitor 产生信号且用户已预授权(confidence ≥ 0.85)。
主要能力:接口层定义前置条件、风控流程、用户确认格式与审计记录结构,与具体交易所无关;各交易所下单 API 与签名方式见 impl/binance.md、impl/okx.md,新增交易所只需添加 impl/{exchange}.md,本文件无需修改。
风控清单:交易对在白名单(BTC/USDT、ETH/USDT、SOL/USDT);单笔金额 ≤ 1,000 USDT;今日交易笔数 < 20(由网关跨 session 追踪);今日累计亏损 < 500 USDT(由网关跨 session 追踪);操作类型安全(非提币/转账/改权限);用户已确认;止损已设置。任一未通过即拒绝执行并说明原因。
使用方式:参数包括必需 exchange、pair、side(buy/sell)、type(limit/market)、quantity,可选 price(限价单必须)、stopLoss、takeProfit。执行前展示交易确认信息,用户回复“确认”执行或“取消”放弃;随后按 exchange 加载对应 impl 文件调用下单 API。结果分成功(返回订单 ID 与成交详情)、部分成交(通知用户并继续监控剩余数量)、失败(返回错误说明与建议)。
审计:每笔交易由网关自动记录,含 tradeId、timestamp、exchange、pair、side、type、price、quantity、amountUSD、stopLoss、takeProfit、orderId、status、riskChecks、userConfirmed。
限制与安全约束:用户确认为强制流程,不可跳过、不可由代码自动确认;exec = deny,write = deny(自身不写任何文件);交易记录由网关写入审计日志;风控违规自动拒绝并告警。具体价格、费用等未在资料中提供。