用途:在 OKX 交易所查询账户资产与持仓、历史盈亏、账单流水、手续费等级、账户配置与可下单/可提现额度,并在不同账户间划转资金。支持实盘与模拟盘两种模式。
安装与配置:先安装 CLI:npm install -g @okx_ai/okx-trade-cli;再运行 okx config init,按提示选择站点并完成浏览器 OAuth 流程。要求 API 凭证;切勿在聊天中接收凭证,应引导用户通过 okx config init 自行配置。可用 okx --demo account balance 在模拟盘(无真实资金)测试。
主要能力(读命令):okx account balance-all 一次性返回交易账户、资金账户与估值快照;okx account balance [ccy] 查询交易账户权益/可用/冻结;okx account asset-balance [ccy] 查询资金账户,加 --valuation 可得跨账户总资产估值(默认 USDT,可用 --valuationCcy 指定);okx account positions 查询未平仓合约持仓,可用 --instType(SWAP | FUTURES | OPTION | MARGIN | EVENTS)、--instId 收窄;okx account positions-history 查询已平仓与已实现盈亏;okx account bills 查询账单;okx account fees --instType 查询手续费等级;okx account config 查询账户等级、持仓模式、UID;okx account max-size、okx account max-avail-size 估算下单量;okx account max-withdrawal 查询最大可提现额。
写命令:okx account set-position-mode 切换净/双向持仓模式;okx account transfer 在账户间划转(如 --ccy USDT --amt 100 --from 6 --to 18,6 为资金账户、18 为交易账户)。写命令执行前需确认模式与参数,执行后建议用 okx account config 或余额命令复核。
模式与鉴权:API Key 方式用 --profile <名称> 区分实盘/模拟;OAuth 方式实盘为默认,模拟盘加 --demo,不要用 --profile 切换模式。每次返回结果应标注 [mode: live] 或 [mode: demo]。鉴权错误(401、会话过期等)应停止重试并重新登录。相关市场行情请使用 okx-cex-market,下单使用 okx-cex-trade,机器人使用 okx-cex-bot。
限制:需有效 API 凭证或 OAuth 会话;模拟与实盘账户不可混用;具体费率、额度与可用币种以实际返回为准,资料未提供固定数值。