用途:该技能面向通过本地 OKX Trade CLI(okx 命令)操作用户本人 OKX 账户的场景,适用于终端或编码智能体可执行受支持 okx 命令时。若使用 ChatGPT、Claude Desktop 等 MCP 宿主中的 OKX MCP,应改用 mcp-user 技能。
主要能力:支持现货开仓/平仓、永续合约开仓/平仓,以及账户配置、余额、行情、成交、持仓等只读查询。示例流程默认使用模拟盘(--demo)。
必要用法:先检查 CLI 版本与命令帮助:which okx、okx --version、okx spot place --help、okx swap place --help、okx swap close --help,最低版本 1.4.4。下单类命令需传入 --aiBuilderCode <AI_BUILDER_CODE>,值为 1-16 位字母数字,非 OKX 凭证,须作为命令标志直接传入,不能只设为环境变量。凭证检查运行 okx config show --json 与 okx auth status --json:有非空 api_key 的 profile 用 API Key 模式(模拟盘 --profile <demo-profile>,实盘 --profile <live-profile> --live);无 API Key 且 OAuth 已登录用 OAuth 模式(模拟盘 --demo,无 profile 标志);未登录时运行 okx auth login --manual --site <global|eea|us|tr>。
限制:不要向聊天粘贴 API Key、密钥、口令或 OAuth 令牌。若命令帮助未暴露 --aiBuilderCode,应警告无法保证归因,不得编造其他标志或传原始 tag。实盘需用户明确要求并确认。下单前须汇总参数并等待明确确认,下单后用 orders、fills、positions 等只读命令验证。acctLv=1 时不支持合约流程;BTC-USD-SWAP 等反向合约不适用该线性合约流程。