用途:在 OKX 交易所管理两类机器人——网格机器人(现货网格 grid、合约网格 contract_grid,含币本位)和 DCA 马丁格尔机器人(现货 spot_dca、合约 contract_dca)。所有机器人运行于 OKX 服务端,不需要本地进程。
前置与安装:
- npm install -g @okx_ai/okx-trade-cli
- okx config init 选择站点并按浏览器 OAuth 流程完成配置。安全要求:绝不要在聊天中接受凭据,引导用户通过 okx config init 自行设置。
凭据与模式:每条需鉴权命令前先跑 okx config show --json(唯一权威的 API Key 存在依据)与 okx auth status --json(OAuth 会话状态)。有非空 api_key → API Key 模式,用 --profile <profile> 区分实盘/模拟;无 API Key 且 logged_in → OAuth 模式,实盘无需标志,模拟加 --demo。模式未明确时需向用户确认。命令后应标注 [mode: live] 或 [mode: demo]。遇到 401/会话过期,停止并加载 okx-cex-auth 重新登录后重试。
网格机器人命令:create(写入,需 --instId --algoOrdType --maxPx --minPx --gridNum 等)、amend(改价格区间、网格数或 TP/SL,tpTriggerPx 与 tpRatio、slTriggerPx 与 slRatio 互斥)、stop(--stopType 1 平仓清理 / 2 保留资产)、positions、liquidate-price、close-position、orders、details、sub-orders。
DCA 机器人命令:create(spot_dca/contract_dca,必填 --algoOrdType --instId --direction --initOrdAmt --maxSafetyOrds --tpPct,contract_dca 另需 --lever;maxSafetyOrds>0 时需 safetyOrdAmt、pxSteps 等)、stop(spot_dca 需 --stopType 1 卖光代币或 2 保留代币)、orders、details、sub-orders。
操作流程:先判断模块与动作;READ 命令确认 profile 后可直接执行,WRITE 命令需与用户确认关键参数一次;写入后需用 orders/details 验证结果。
关键规则:绝不自动转账,余额不足时报告缺口并让用户选择手动转账、缩量或取消;algoId 是机器人算法单 ID,非普通 ordId,必须从命令输出获取;网格 algoOrdType 必须与真实类型一致(不匹配会报 50016);操作已有机器人前先列表获取正确 ID。
限制:资料未提供收费、价格、性能或其他平台支持信息。