用途:通过 ritmex-bot CLI 以智能体安全、兼容交易所的方式操作交易所,覆盖能力检查、行情/账户/持仓查询、订单操作与策略运行。
主要能力:根命令包括 help、doctor、exchange、market、account、position、order、strategy。exchange 可 list 与 capabilities;market 支持 ticker、depth、kline;account 支持 snapshot(summary 为别名);position 支持 list;order 支持 open、create、cancel、cancel-all;strategy run 支持 trend、swing、guardian、maker、maker-points、offset-maker、liquidity-maker、basis、grid 等策略 ID 及别名。
使用方式:入口可用 ritmex-bot <command>、npx ritmex-bot <command>、bunx ritmex-bot <command> 或 bun run index.ts <command>;不可用时从仓库根目录用 bun run index.ts。全局标志含 --exchange/-e、--symbol、--json/-j、--dry-run/-d、--timeout/-t(默认 25000)、--help/-h。写入操作建议先 --dry-run --json 验证,再在用户确认后执行实盘;自动化消费输出时优先 --json。
适用场景:需要查询行情、账户与持仓,或安全地创建/撤销订单、运行策略的智能体任务。
限制:不得更改或新增环境变量名,按当前 shell 环境读取配置;--symbol 原样传递,不做跨交易所映射;交易所不支持的功能返回 UNSUPPORTED,不得伪造行为。错误码与退出码:INVALID_ARGS→2、MISSING_ENV→3、UNSUPPORTED→5、EXCHANGE_ERROR→6、TIMEOUT→7。若运行时适配器无法初始化,capabilities 可能回退到静态元数据。具体支持的交易所、策略参数细节与收费信息暂未提供。