SuperAPI AI 工具集

okx-cex-portfolio

数据与分析

查看项目

更新于 10-16 02:36

技能介绍

用途:在 OKX 交易所查询账户资产与持仓,并执行资金划转等操作,属于交易前查询与资金准备环节的工具。

前置条件:需安装 okx CLI 并配置凭据:npm install -g @okx_ai/okx-trade-cli,随后运行 okx config init(选择站点后走浏览器 OAuth 流程)。安全要求:绝不在聊天中接受凭据,引导用户自行完成配置。

模式区分:实盘用真实资金,API Key 用户以 --profile <live-profile> 指定,OAuth 用户默认即为实盘;模拟盘使用模拟资金,API Key 用户用 --profile <demo-profile>,OAuth 用户加 --demo。可用 okx --demo account balance 在模拟模式下测试。所有命令回复需标注 [mode: live] 或 [mode: demo]。

主要能力:okx account balance-all 一次返回交易账户、资金账户与估值快照;okx account balance 查看交易账户权益;okx account asset-balance 查看资金账户余额,加 --valuation 可跨账户汇总估值;okx account positions 查看未平仓合约持仓;okx account positions-history 查看已平仓记录与已实现盈亏;okx account bills 查看账单流水;okx account fees --instType SPOT 查看手续费档位;okx account config 查看账户设置;okx account max-size / max-avail-size 估算下单量;okx account max-withdrawal 查询最大可提。写入类命令:okx account transfer(如 --ccy USDT --amt 100 --from 6 --to 18,6 为资金账户、18 为交易账户)与 okx account set-position-mode(切换净持仓/双向持仓)。

使用顺序:先做凭据与模式检查,读命令可直接执行,写命令(划转、改持仓模式)须先确认,执行后建议用只读命令复核结果。凭证检查需同时看 okx config show --json 与 okx auth status --json,前者判断 API Key 是否存在,后者判断 OAuth 会话状态。

适用场景:查询总资产与净价值、检查持仓与浮盈浮亏、交易或开机器人前核对可用余额、资金账户与交易账户之间划转。

限制:必须持有 OKX 账户并有可用凭据,否则认证失败;认证错误(401、会话过期)时应停止重试并重新登录;涉及资金变动的写操作存在账户模式误用风险,需谨慎确认;关于具体费率、限额与可用地区等,本资料未提供完整说明。