用途:在 OKX 交易所执行现货、永续合约、交割期货、期权及事件合约的交易管理,包括下单、撤单、改单、监控订单、查询期权链与希腊值、设置止盈止损和追踪止损、管理杠杆与持仓。
安装与配置: 安装 okx CLI:npm install -g @okx_ai/okx-trade-cli 配置凭据:okx config init(选择站点后按浏览器 OAuth 流程操作) 可用模拟盘测试:okx --demo spot orders 安全要求:绝不接受在聊天中提供凭据,应引导用户通过 okx config init 设置。
凭据与模式检查:执行任何需鉴权命令前,先用 okx config show --json 和 okx auth status --json 判断鉴权方式(API Key 模式或 OAuth 模式),并确认实盘/模拟盘。API Key 用户通过 --profile <name> 选择;OAuth 用户实盘无需标志,模拟盘加 --demo。每条响应后需附加 [mode: live] 或 [mode: demo]。鉴权失败(401、会话过期等)时立即停止,改用 okx-cex-auth 技能重新登录后再重试。
主要能力:现货订单(place/cancel/amend/algo/trail/orders/get/fills/leverage);永续合约订单(place/cancel/amend/close/leverage/algo/trail/positions/orders/fills 等);交割期货订单;期权(instruments/greeks/place/cancel/amend/batch-cancel/orders/positions/fills);事件合约(browse/series/events/markets/place/amend/cancel/orders/fills)。
用法要点:子命令用空格而非连字符,不能把 MCP 工具名(如 swap_place_algo_order)转成连字符命令,否则会报 Unknown command。下单前须用 market_get_instruments 获取合约面值 ctVal,不可假设合约大小。当用户给出 USDT 金额或纯数字且未指定含义时,须先确认是名义价值还是保证金成本,分别使用 --tgtCcy quote_ccy 或 --tgtCcy margin。反向合约以 BTC 结算,须提醒用户。
限制:资料未提供收费、价格和性能等说明;所有交易命令需 API 凭据或 OAuth 登录;实盘操作涉及真实资金且不可逆。