okx-account
Read-only OKX tracking: unified-account equity, perp positions, orders, fills, bills. Use when monitoring OKX without trading (e.g. account equity, current PnL, recent fills, withdrawal history, margin level).
How do I install this agent skill?
npx skills add https://github.com/starchild-ai-agent/official-skills --skill okx-accountIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a read-only OKX account tracker that uses official libraries and follows standard security practices for secret management.
- Socketwarn
3 alerts: gptAnomaly
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
OKX Account (Read-Only)
Read-only OKX account tracker built on the official python-okx library.
Use it for account tracking, daily/weekly reports, risk alerts, and cashflow attribution.
How to Get an OKX API Key (Read-Only)
- Sign in at okx.com, top-right avatar → API
- Direct link: https://www.okx.com/account/my-api
- Create V5 API Key → complete 2FA verification
- Fill the form:
- API name: anything
- Passphrase: ⚠️ a brand-new password used to sign API requests, NOT your login password. Lose it and you can only delete the key and create a new one.
- Permissions: tick Read only, leave Trade / Withdraw off
- IP whitelist: leave empty
- Submit → immediately copy and save all three values:
API Key/Secret Key/Passphrase(Secret is shown only once) - Set them into this skill's environment variables
Reference: OKX official tutorial
Prerequisites
1) API key
In OKX API Management create a key with Read only. OKX requires three credentials: api_key / secret / passphrase (the password you set when creating the key — not the login password).
2) Environment variables
OKX_RO_API_KEY=...
OKX_RO_SECRET=...
OKX_RO_PASSPHRASE=...
3) Geo restriction (required)
OKX geo-blocks server IPs. Scripts default to the SC internal HK proxy:
HK_PROXY = "http://hk:x@sc-vpn.internal:8080"
Do not set a global HTTP_PROXY.
Scripts
python3 skills/okx-account/scripts/okx_account.py <action> [options]
python3 skills/okx-account/scripts/account_scenarios.py <scenario> [options]
Actions
summary: one-shot summaryaccount_balance/account_config/positions/position_risk/fee_rates/billsopen_orders/order_history/fills_historyfunding_balance/deposits/withdrawals/currencies/funding_rate
Scenarios
portfolio_snapshot: full account snapshotperp_risk: perpetual risk monitoring (margin ratio + unrealized loss thresholds)cashflow: deposits + withdrawals + 7d bills aggregationtrading_activity: recent fills activity by instType
Common usage
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
Notes
- The
passphraseis easy to forget — it is the password you set when creating the key, not your login password. - If you bound an IP whitelist when creating the key, either disable it or add the proxy egress IP.
- Use time-windowed pagination for high-volume fills.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/starchild-ai-agent/official-skills/okx-account">View okx-account on skillZs</a>