okx/agent-trade-kit/okx-cex-skill-mp

OKX Skills Marketplace

Browse, search, install, and manage AI trading skills from the OKX Skills Marketplace. Skills are modular AI prompt packages that extend your trading assistant's capabilities — covering market analysis, trade execution, risk management, and portfolio optimization.

⚠️ Third-Party Content Notice

Skills available on the OKX Skills Marketplace are created and published by independent third-party developers, not by OKX. OKX does not author, review, endorse, or take responsibility for the content, accuracy, or behavior of any third-party skill. Always review a skill's SKILL.md before use, and only install skills from authors you trust.

When a skill is installed via okx skill add, it is downloaded from the marketplace and saved locally to your agent's skill directory (e.g., ~/.agents/skills/<skill-name>/). The skill runs entirely on your local machine with your agent's full permissions — treat it with the same caution as installing any third-party software.

Skill routing

• Skill marketplace → okx-cex-skill-mp (this skill)
• Market data / indicators → okx-cex-market
• Account balance / positions → okx-cex-portfolio
• Place / cancel orders → okx-cex-trade
• Grid / DCA bots → okx-cex-bot

Prerequisites

1. Install okx CLI:

``bash npm install -g @okx_ai/okx-trade-cli ``

1. Configure API credentials (required for marketplace access):

``bash okx config init ``

Installation Strategy

When the user wants to install a skill, follow this order strictly:

1. Always try `okx skill add <name>` first — this downloads the skill and installs it to all detected agents (Claude Code, OpenClaw, Cursor, Windsurf, etc.) in one step.
2. Only if `add` fails, fall back to manual download:

• Tell the user why add failed (network error, npx unavailable, permission issue, etc.)
• Offer okx skill download <name> --dir <path> as an alternative
• Guide the user to manually unzip and place files in their agent's skill directory

Never skip add and go straight to download unless add has already failed.

Command Reference

Add --json to any command for raw JSON output. Add --env to wrap the output as {"env", "profile", "data"}.

Commands in Detail

1. Search Skills

okx skill search grid

Output:

  NAME              VERSION   DESCRIPTION
  grid-premium      1.2.0     Enhanced grid trading with technical analysis
  grid-dca          1.0.0     Grid strategy combined with DCA
 
2 skills found (page 1/1). Use `okx skill add <name>` to install.

Search with category filter:

okx skill search --categories trading-strategy

Pagination (response includes totalPage for total pages):

okx skill search grid --page 2 --limit 5
# Output: "3 skills found (page 2/4). Use `okx skill add <name>` to install."

2. Browse Categories

okx skill categories

Output:

  ID                  NAME
  trading-strategy    Trading Strategy
  risk-management     Risk Management
  analysis            Market Analysis

3. Install a Skill

okx skill add grid-premium

Output:

Downloading grid-premium...
Verifying signature...
  Signature verified (key: okx-skill-signing-key-2026, files: 3)
Installing to detected agents...
✓ Skill "grid-premium" v1.2.0 installed
  Note: This skill was created by a third-party developer, not by OKX. Review SKILL.md before use.

What happens under the hood:

1. Downloads skill zip from OKX marketplace API
2. Extracts and validates the package (checks SKILL.md exists, reads metadata)
3. Verifies Ed25519 signature and SHA-256 file integrity — blocks installation if verification fails
4. Runs npx skills add to install to all locally detected agents
5. Records the installation (including verification status) in ~/.okx/skills/registry.json

Force-install (bypass verification):

okx skill add grid-premium --force

⚠️ Security warning: --force bypasses signature verification and installs the skill even if verification fails. Only use this if you trust the source and understand the risk. The bypass is recorded in the registry with status bypassed.

4. Download Only (No Install)

When add fails or the user wants the raw package:

okx skill download grid-premium --dir ~/Downloads/

Output:

✓ Downloaded grid-premium.zip
  Path: /Users/me/Downloads/grid-premium.zip

To download as .skill format (for agents that recognize the extension):

okx skill download grid-premium --dir ~/Downloads/ --format skill

The zip contains:

• SKILL.md — the skill's main instruction file
• _meta.json — metadata (name, version, title, description)
• reference/ — optional supporting documents

5. List Installed Skills

okx skill list

Output:

  NAME              VERSION   INSTALLED AT
  grid-premium      1.2.0     2026-03-25 10:30:00
  dca-smart         2.1.0     2026-03-20 14:00:00
 
2 skills installed.

6. Check for Updates

okx skill check grid-premium

Output:

grid-premium: installed v1.0.0 → latest v1.2.0 (update available)
  Use `okx skill add grid-premium` to update.

To update, simply run okx skill add <name> again — it overwrites the previous version.

7. Remove a Skill

okx skill remove grid-premium

Output:

✓ Skill "grid-premium" removed

8. Verify a Skill's Signature

Re-run signature verification on an already-installed skill without reinstalling it:

okx skill verify grid-premium

Output (success):

✓ grid-premium: signature verified (key: okx-skill-signing-key-2026, files: 3)

Output (failure):

✗ grid-premium: verification failed — Invalid signature

• Exit code is 1 on failure.
• Result is persisted back to ~/.okx/skills/registry.json.
• Use --json for machine-readable output.

MCP Tools (Alternative)

When the CLI is unavailable (e.g., Claude Desktop without terminal access), the same marketplace functionality is available via MCP tools:

Note: MCP tools only support search and download. The full install flow (add) requires CLI access.

Error Handling