用途:这是一个只读的 OKX 账户追踪技能,基于官方 python-okx 库构建,用于在不进行交易的前提下监控 OKX 账户,例如查看账户权益、持仓、订单、成交和账单,适合账户跟踪、日报周报、风险预警与现金流归因。
主要能力:提供 summary 一次性摘要;account_balance、account_config、positions、position_risk、fee_rates、bills;open_orders、order_history、fills_history;funding_balance、deposits、withdrawals、currencies、funding_rate 等操作。场景脚本包括 portfolio_snapshot(完整账户快照)、perp_risk(永续风险监控,含保证金率与未实现亏损阈值)、cashflow(充值、提现与 7 日账单聚合)、trading_activity(按 instType 查看近期成交)。
使用方式:需先在 OKX API 管理创建仅勾选 Read only 的 V5 API Key,获得 api_key / secret / passphrase 三项凭证,并设置环境变量 OKX_RO_API_KEY、OKX_RO_SECRET、OKX_RO_PASSPHRASE。OKX 会屏蔽服务器 IP,脚本默认使用内部 HK 代理 HK_PROXY = "http://hk:x@sc-vpn.internal:8080",不要设置全局 HTTP_PROXY。运行命令:python3 skills/okx-account/scripts/okx_account.py <action> [options] 与 python3 skills/okx-account/scripts/account_scenarios.py <scenario> [options]。示例:python3 skills/okx-account/scripts/okx_account.py summary;python3 skills/okx-account/scripts/account_scenarios.py portfolio_snapshot;python3 skills/okx-account/scripts/account_scenarios.py perp_risk --loss-threshold 5000;python3 skills/okx-account/scripts/account_scenarios.py cashflow --limit 100;python3 skills/okx-account/scripts/account_scenarios.py trading_activity --inst-types SPOT,SWAP。
限制与注意:passphrase 是创建密钥时设置的新密码,并非登录密码,容易遗忘;若创建密钥时绑定了 IP 白名单,需禁用或加入代理出口 IP;高频成交数据应使用时间窗口分页。资料未提供收费、价格或平台支持范围等信息。