skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
starchild-ai-agent/official-skills96 installs

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-account
view source ↗

Is 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)

  1. Sign in at okx.com, top-right avatar → API
  2. Create V5 API Key → complete 2FA verification
  3. 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
  4. Submit → immediately copy and save all three values: API Key / Secret Key / Passphrase (Secret is shown only once)
  5. 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 summary
  • account_balance / account_config / positions / position_risk / fee_rates / bills
  • open_orders / order_history / fills_history
  • funding_balance / deposits / withdrawals / currencies / funding_rate

Scenarios

  • portfolio_snapshot: full account snapshot
  • perp_risk: perpetual risk monitoring (margin ratio + unrealized loss thresholds)
  • cashflow: deposits + withdrawals + 7d bills aggregation
  • trading_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 passphrase is 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.

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>