概念：策略、计划、纸面与实盘

策略

策略绑定在 Key 上，每次调用都校验。数值会被夹紧而非信任：maxNotionalUsd 1–10 000、dailyCapUsd 1–100 000，未知操作拒绝，币种大写去重并最多 50 个。

交易的两层限制

第一层是 Key 策略：超过单笔或每日上限返回 403，Agent 完全不会被触达。第二层是平台风险包络：最大持仓数、单仓大小、杠杆、止盈止损与日内熔断。超过平台仓位上限会被压缩；熔断拒绝返回 409。

计划与上限

账户的计划决定 Key 策略能申请的天花板；实际生效值取两者更小者。付费计划免收 8 bps 成交费。

纸面与实盘

纸面模式使用真实行情与模拟成交，账本可跨冷启动持久化。实盘模式通过已授权的 agent 钱包下真实订单。端点与策略完全相同，只是交易场所不同。

计量

已执行的订单写入 agent_op 事件（名义额、费用、模式）。spentTodayUsd 由这些事件累加，remainingTodayUsd = dailyCapUsd − spentTodayUsd − 本次订单。报价与发票不计量，因为没有资金移动。

错误告诉你问题来自哪一层

Key 与撤销

每个 Key 有权限（read、write）与策略。删除 Key 后密钥立即失效；在驾驶舱暂停 Agent 会停止新开仓，退出逻辑继续运行；在 Hyperliquid 上可以直接撤销 agent 钱包。