← Back to Skills Marketplace
803
Downloads
0
Stars
6
Active Installs
9
Versions
Install in OpenClaw
/install okx-cex-trade
Description
Use this skill when the user asks to 'buy BTC', 'sell ETH', 'place a limit order', 'cancel my order', 'amend my order', 'long BTC perp', 'short ETH swap', 'o...
Usage Guidance
This skill's SKILL.md clearly expects the OKX CLI ('okx') and API credentials and even includes an npm install instruction, but the registry metadata omitted those requirements — that mismatch is the main red flag. Before installing or using it: (1) verify the npm package @okx_ai/okx-trade-cli on the npm registry (publisher identity, recent versions, source repo, and README); (2) prefer OAuth demo mode first and test with `okx --demo` to avoid risking real funds; (3) confirm you are comfortable with the skill reading your local OKX config (~/.okx/config.toml) and avoid pasting API secrets into chat; (4) if possible inspect the npm package source (or its GitHub release) to ensure it doesn't exfiltrate data or run unexpected actions; (5) ask the skill publisher/registry owner to fix the metadata to list required binaries/install steps and any config paths — the current inconsistency should be resolved before trusting the skill with live trading.
Capability Analysis
Type: OpenClaw Skill
Name: okx-cex-trade
Version: 1.3.2
The okx-cex-trade skill bundle is a comprehensive trading interface for the OKX exchange, covering spot, futures, swaps, options, and event contracts. It includes significant safety and security instructions for the AI agent, such as explicitly forbidding the collection of credentials in chat (directing users to a local CLI config instead), requiring user confirmation for all 'write' operations, and implementing a safeguard against automatically executing destructive actions suggested by API error messages. The logic is consistently aligned with its stated purpose, and no indicators of data exfiltration, malicious execution, or prompt injection were found.
Capability Tags
Capability Assessment
Purpose & Capability
The SKILL.md describes a trading skill that legitimately needs the OKX CLI and API credentials (OAuth or API key) and will run many okx commands; that purpose is coherent. However the package/registry metadata provided with the skill does not declare the required CLI binary, install step, or any credentials — the SKILL.md frontmatter itself includes an npm install for @okx_ai/okx-trade-cli and requires bin 'okx', but the registry summary lists none of that. This mismatch is surprising and should be clarified.
Instruction Scope
Instructions direct the agent to run many authenticated okx CLI commands, to check ~/.okx/config.toml via `okx config show --json`, and to load other OKX-related skills (okx-cex-auth, okx-cex-portfolio, okx-cex-market). Reading the local OKX config file and running auth-status checks are functionally required for trading, but they access local configuration that the registry did not declare. The skill also tells the agent to never accept credentials in chat and to prefer `okx config init` — good guidance.
Install Mechanism
SKILL.md frontmatter and body instruct installing an npm package (@okx_ai/okx-trade-cli) and declare the 'okx' binary; but the registry install section reported 'No install spec' and 'Required binaries none'. Either the registry metadata is incomplete or the skill expects the agent to install code at runtime. Installing a third-party npm package is a moderate-risk action and should be verified (publisher, package contents, checksum).
Credentials
The skill needs OKX API credentials (API key profiles or OAuth) to place live orders; that is proportionate to a trading skill. However the registry lists no required env vars or primary credential. The runtime instructions explicitly access local OKX config (~/.okx/config.toml via `okx config show --json`) which is a sensitive local file; the absence of declared config paths in metadata is an inconsistency. No unrelated credentials are requested.
Persistence & Privilege
The skill does not request 'always: true' and uses normal autonomous invocation defaults. It instructs using the okx CLI and other helper skills but does not request persistent elevation or alter other skills' configs. No concerning persistence behavior is declared.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install okx-cex-trade - After installation, invoke the skill by name or use
/okx-cex-trade - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.3.2
okx-cex-trade 1.3.2 — Improved authentication handling, CLI guidance, and event contract routing
- Added detailed support for both API key and OAuth authentication methods, with updated credential and profile checks.
- Clarified CLI usage, emphasizing correct subcommand syntax and deprecating hyphenated command forms.
- Updated demo/live mode switching rules for both auth methods; API key uses `--profile`, OAuth uses `--demo`.
- Expanded intent and routing to clearly support browsing and trading event contracts/prediction markets.
- Improved instructions and flow for authentication errors, including seamless integration with re-auth skill.
- Minor updates to the description and install instructions for better clarity and coverage.
v1.3.1
- Added support for event contracts (prediction markets, binary Yes/No or Up/Down outcome trades) on OKX CEX.
- Expanded skill description and usage examples to cover event contract orders.
- Added new references: event-commands.md and event-workflows.md.
- Updated routing rules to include event contracts within this skill.
v1.3.0
- Adds support for `tgtCcy=margin` mode for swap, futures, and option orders (allowing user to specify USDT margin directly).
- Updates and clarifies how ambiguous USDT notional vs margin sizing is handled—now prompts user to specify which mode.
- Adjusts option order sizing to accept `--tgtCcy quote_ccy` (notional) and `--tgtCcy margin` (margin cost), with improved guidance for high face value contracts.
- Expands documentation and examples for handling contract sizing across all derivatives types.
- Bumps skill version to 1.3.0.
v1.2.8
Version 1.2.8 introduces detailed, modular documentation for trading commands and updates contract handling guidance.
- Added comprehensive reference docs for spot, swap, futures, options commands, templates, and workflows.
- Updated SKILL.md to reference new documentation and improve clarity on contract face value checks before placing derivatives orders.
- Strengthened guidance to always fetch and confirm contract size (ctVal) for all SWAP/FUTURES/OPTION orders.
- Clarified and modularized instructions for position sizing, margin verification, and option order conversions.
- Simplified and organized documentation structure to support future extension and reduce duplication.
v1.2.7
okx-cex-trade v1.2.7
- Updated sz (size) handling for derivatives: SWAP and FUTURES orders now accept direct USDT amounts via --tgtCcy quote_ccy, passing the amount as --sz for automatic contract conversion by API.
- Clarified that for options orders, manual USDT-to-contract conversion is still required, and detailed step-by-step guidance is provided.
- Ambiguous plain number sz from user (no unit) now consistently prompts clarification before proceeding.
- Improved and simplified contract type handling and user confirmation flows for derivatives and options order sizing.
v1.2.6
No changes detected in this release.
- Version 1.2.6 has no file or documentation changes compared to the previous version.
v1.2.1
- Updated skill metadata field from "moltbot" to "agent" for compatibility.
- No functional or feature changes; internal metadata adjustment only.
- No changes to user-facing commands or documentation.
v1.2.0
okx-cex-trade 1.2.0
- No file changes detected from previous version.
- No user-facing changes or updates documented for this release.
v1.1.9
OKX CEX Trade Skill v1.1.9 introduces improved process guidance and stricter handling for trading commands and authentication.
- Adds clear step-by-step instructions for credential and profile validation before trade execution.
- Enforces use of `--profile` (live/demo) for all authenticated actions, with explicit user prompts when mode is unclear.
- Provides user guidance for resolving and verifying API credential/authentication errors, including 401 handling.
- Clarifies routing to other OKX skills for market data, portfolio, and bot trading tasks.
- Expanded, detailed quickstart and command index for all supported trade operations and scenarios.
Metadata
Frequently Asked Questions
What is okx-cex-trade?
Use this skill when the user asks to 'buy BTC', 'sell ETH', 'place a limit order', 'cancel my order', 'amend my order', 'long BTC perp', 'short ETH swap', 'o... It is an AI Agent Skill for Claude Code / OpenClaw, with 803 downloads so far.
How do I install okx-cex-trade?
Run "/install okx-cex-trade" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is okx-cex-trade free?
Yes, okx-cex-trade is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does okx-cex-trade support?
okx-cex-trade is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created okx-cex-trade?
It is built and maintained by numpy0001 (@numpy0001); the current version is v1.3.2.
More Skills