用途
okx-cex-trade 是 OKX 交易所的中心化交易（CEX）命令行工具，用于现货、永续合约（swap）、交割期货（futures）、期权（option）以及事件合约（event contract，即预测市场）的订单管理与交易操作。适用场景包括：根据用户指令买入/卖出标的、挂限价单或市价单、撤单与改单、开多/开空永续合约、设置止盈止损与跟踪止损、管理杠杆与仓位、查询期权链与 Greeks，以及交易二元结果事件合约（Yes/No、Up/Down）。使用需要 API 凭证或 OAuth 登录。
主要能力
按产品模块划分，该技能提供以下命令组：
- 现货订单（12 个命令）：下单、撤单、改单、现货止盈止损、跟踪止损、查询订单与成交明细、设置现货杠杆等。
- 永续合约订单（15 个命令）：下单、撤单、改单、市价全平、设置杠杆、止盈止损、跟踪止损、查询持仓/订单/成交/杠杆等。
- 交割期货订单（15 个命令）：下单、撤单、改单、市价全平、设置杠杆、止盈止损、跟踪止损、查询订单/持仓/成交/杠杆等。
- 期权订单（10 个命令）：查询期权链、查询隐含波动率与 Greeks（delta/gamma/theta/vega）、下单、撤单、改单、批量撤单、查询订单/持仓/成交。
- 事件合约订单（9 个命令）：浏览事件合约、列出事件系列、列出系列内的事件与市场、下单（需指定 outcome）、改单、撤单、查询挂单/历史订单/成交。
使用方式
安装 CLI：
npm install -g @okx_ai/okx-trade-cli
配置凭证：
okx config init # 选择站点，随后按浏览器 OAuth 流程完成
可用模拟模式测试（模拟交易，不涉及真实资金）：
okx --demo spot orders
安全提示：不要通过聊天接受凭证，应引导用户使用 okx config init 完成设置。
命令命名规则：子命令使用空格（如 okx swap algo place、okx bot grid create），不要将 MCP 工具标识符（如 swap_place_algo_order）转换成连字符连接的命令（如 okx swap place-algo），否则会返回“Unknown command”。
凭证与模式检查：在执行任何需要认证的命令前，需先运行检查。okx config show --json 用于发现 API-key 配置（TOML），okx auth status --json 用于发现 OAuth 会话状态。根据结果判断使用 API Key 模式或 OAuth 模式，并确认交易模式。
交易模式：实盘（live，真实资金，不可逆）与模拟盘（demo，模拟资金）。API Key 模式通过 --profile <live-profile> 或 --profile <demo-profile> 指定；OAuth 模式默认实盘，加 --demo 切换为模拟盘，不使用 --profile 切换模式。每条命令结果后应追加 [mode: live] 或 [mode: demo]。
认证错误处理：若出现 401、Session expired 或提示先运行 okx auth login，应立即停止、不重试，告知用户会话可能过期，加载 okx-cex-auth 技能完成重新认证后再重试原命令。
合约面值处理：下任何 SWAP/FUTURES/OPTION 订单前，必须先调用 market_get_instruments 获取 ctVal（合约面值），不可假设合约大小，因不同合约面值不同（例如 ETH-USDT-SWAP = 0.1 ETH/张，BTC-USDT-SWAP = 0.01 BTC/张）。
USDT 金额歧义：当用户只给 USDT 金额（如 200U、500 USDT、$1000）或未带单位的数字时，属于歧义，必须先向用户确认是“名义价值（notional）”还是“保证金成本（margin）”。名义价值对应 --tgtCcy quote_ccy，保证金成本对应 --tgtCcy margin。若用户指定张数，应先校验 ctVal，再用 --sz 传入张数并确认实际价值。反向合约（*-USD-SWAP）需提示保证金与盈亏以 BTC 结算。
技能路由：市场数据（价格、图表、深度、资金费率）使用 okx-cex-market；账户余额、盈亏、持仓、手续费、划转使用 okx-cex-portfolio；网格与定投机器人使用 okx-cex-bot；常规现货/合约/期货/期权/算法订单以及事件合约的浏览与交易使用本技能。注意事件合约相关“contracts”应路由到本技能，而非 okx-cex-portfolio。
适用场景与限制
适用场景：需要以命令行方式在 OKX 进行多产品交易与订单管理、需要查询期权链与 Greeks、需要交易预测市场类型的事件合约、或需要以模拟盘无风险测试交易流程的用户。
限制与注意事项：使用需要 API 凭证或 OAuth 登录；实盘涉及真实资金且不可逆；部分命令需按产品模块查阅 references 目录下的完整命令语法与参数表（如 spot-commands.md、swap-commands.md、futures-commands.md、options-commands.md、event-commands.md）；关于具体收费标准、价格、平台兼容性与效果等事实，本资料暂未提供。