← Back to Skills Marketplace
597
Downloads
0
Stars
5
Active Installs
9
Versions
Install in OpenClaw
/install okx-cex-portfolio
Description
This skill should be used when the user asks about 'account balance', 'how much USDT do I have', 'my funding account', 'show my positions', 'open positions',...
Usage Guidance
This skill appears to do what it says: it uses an OKX CLI to inspect account balances, positions, and transfers. Before installing/use: 1) Verify the npm package @okx_ai/okx-trade-cli on npmjs.org / GitHub to ensure it is the official OKX tool and check its source and recent activity. 2) Use demo mode for initial testing. 3) Create least-privilege API keys (no withdrawal permission, restrict IPs) rather than full-access keys. 4) Do NOT paste your API key or full config output into chat; be cautious when running commands like okx config show --json because they can reveal secrets in command output. 5) Note the small inconsistency: registry metadata indicated 'instruction-only' but the SKILL.md calls for installing an npm CLI — confirm you are comfortable installing that external binary before proceeding.
Capability Analysis
Type: OpenClaw Skill
Name: okx-cex-portfolio
Version: 1.3.2
The okx-cex-portfolio skill is a well-documented tool for managing OKX exchange accounts, covering balances, positions, and transfers. It demonstrates good security practices by explicitly instructing the agent never to accept credentials in chat and directing users to a local CLI configuration flow (`okx config init`). The logic for distinguishing between 'Live' and 'Demo' modes is clearly defined to prevent accidental trades, and no evidence of data exfiltration, malicious execution, or harmful prompt injection was found in SKILL.md or _meta.json.
Capability Tags
Capability Assessment
Purpose & Capability
Name and description match the actions the SKILL.md instructs (account balance, positions, P&L, bills, transfers). The skill depends on an OKX CLI and expects stored API credentials or OAuth, which is appropriate for the claimed functionality.
Instruction Scope
Runtime instructions stay within the OKX account domain (run okx account balance, positions, bills, transfer, etc.) and explicitly tell the user how to check auth and trading mode. Note: the instructions require running commands that can output configuration and potentially sensitive API keys (e.g., okx config show --json). The skill advises not to accept credentials in chat but does not explicitly instruct the agent/user to redact secrets from command output; that is an operational risk to consider.
Install Mechanism
The SKILL.md frontmatter and Quickstart instruct installing @okx_ai/okx-trade-cli via npm (global). Using an npm package for a CLI is proportionate to the task. Minor inconsistency: registry metadata stated 'No install spec / instruction-only' while the SKILL.md contains an install entry and explicit npm install guidance — the presence of an external package should be validated (package provenance, published source).
Credentials
The skill requires API credentials in practice, but it does not request environment variables — instead it relies on the okx CLI's local config or OAuth session. This is coherent, but the skill instructs commands (okx config show --json) that expose config contents; users should avoid pasting config outputs into chat and prefer demo mode or least-privilege API keys.
Persistence & Privilege
The skill is not force-included (always: false) and does not request persistent platform privileges. It does instruct installing a system/global npm CLI binary, which modifies the environment; that is expected but worth user approval. The skill also references other OKX-related skills for auth or trade flows, which is normal routing behavior.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install okx-cex-portfolio - After installation, invoke the skill by name or use
/okx-cex-portfolio - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.3.2
**Version 1.3.2 – Adds full account overview and unifies API/OAuth logic**
- Now supports requests for total net worth, all assets/balances, "总资产", "full balance", and similar asset-overview queries.
- Updated credential detection: distinguishes API key vs OAuth login, checks both CLI and OAuth session state.
- Clarified and unified demo/live trading mode switching rules for both API key and OAuth users.
- Added explicit instructions for handling authentication failures (with proper skill routing to re-authentication).
- Updated install instructions and metadata to reference latest CLI version.
v1.3.1
- Version bumped to 1.3.1 in metadata.
- No other changes detected; documentation and functionality remain the same.
v1.3.0
Version 1.3.0
- Updated funding-to-trading transfer direction in sample commands and workflows (from `--from 6 --to 18` to `--from 18 --to 6` and vice versa) for improved clarity.
- Bumped version number from 1.2.8 to 1.3.0.
- No code changes; documentation adjustments only.
v1.2.8
- Updated version to 1.2.8 in metadata.
- Added a "Preflight" section pointing to a shared preflight instructions file and referencing metadata.version.
- Expanded command usage for asset-balance: `okx account asset-balance [ccy] [--valuation]` now documents the `--valuation` option.
- No functional logic changes; documentation only.
v1.2.7
Version 1.2.7 of okx-cex-portfolio
- No file changes detected in this release.
- All CLI functionality, workflows, and instructions remain the same.
v1.2.6
No changes detected in this version.
- Version 1.2.6 does not include any file updates or changes from the previous release.
- All features and documentation remain unchanged.
v1.2.1
Version 1.2.1
- Updated metadata to replace the deprecated "moltbot" field with the "agent" field for compatibility.
- No user-facing changes; all functionality and documentation remain the same.
v1.2.0
Version 1.2.0
- No file changes detected in this release.
- No updates or new features introduced; all documentation and commands remain unchanged.
v1.1.9
- Adds a comprehensive SKILL.md with detailed usage, credential checks, profile switching, and supported command lists for OKX account/portfolio operations.
- Clarifies this skill’s scope: account balances, positions, P&L, bills, fees, and fund transfers only; explicitly excludes market data, order placement/cancellation, and bots.
- Specifies strict API credential handling, 401 error recovery steps, and profile (live/demo) confirmation workflow for all authenticated commands.
- Includes command quickstart, cross-skill workflows, and precise routing rules for integration with other OKX skill modules.
- Ensures all portfolio actions confirm and display active profile ([profile: live] or [profile: demo]) after every command.
Metadata
Frequently Asked Questions
What is okx-cex-portfolio?
This skill should be used when the user asks about 'account balance', 'how much USDT do I have', 'my funding account', 'show my positions', 'open positions',... It is an AI Agent Skill for Claude Code / OpenClaw, with 597 downloads so far.
How do I install okx-cex-portfolio?
Run "/install okx-cex-portfolio" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is okx-cex-portfolio free?
Yes, okx-cex-portfolio is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does okx-cex-portfolio support?
okx-cex-portfolio is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created okx-cex-portfolio?
It is built and maintained by numpy0001 (@numpy0001); the current version is v1.3.2.
More Skills