okx/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:

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

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

   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

| # | Command | Description | |---|---------|-------------| | 1 | okx skill search <keyword> | Search marketplace by keyword | | 2 | okx skill search --categories <id> | Filter skills by category | | 3 | okx skill categories | List all available categories | | 4 | okx skill add <name> | Download + install to all detected agents | | 5 | okx skill download <name> [--dir <path>] [--format zip\|skill] | Download package (default format: zip) | | 6 | okx skill list | List locally installed skills | | 7 | okx skill check <name> | Check if a newer version is available | | 8 | okx skill remove <name> | Uninstall a skill |

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...
Installing to detected agents...
✓ Skill "grid-premium" v1.2.0 installed

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. Runs npx skills add to install to all locally detected agents
4. Records the installation in ~/.okx/skills/registry.json

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

---

MCP Tools (Alternative)

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

| MCP Tool | Equivalent CLI | Description | |----------|---------------|-------------| | skills_search | okx skill search | Search by keyword/category. Response includes totalPage for pagination. | | skills_get_categories | okx skill categories | List categories | | skills_download | okx skill download | Download package to directory (default format: .skill; pass format: "zip" for zip) |

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

---

Error Handling

| Error | Meaning | Action | |-------|---------|--------| | 70002 SKILL_DELETED | Skill has been removed from marketplace | Choose a different skill | | 70003 NO_APPROVED_VERSION | No approved version available | Skill is pending review, try later | | 70030 VERSION_NOT_APPROVED | Version not yet approved for download | Wait for review or use an older version | | 50111/50112/50113 | Authentication error | Run okx config init to set up credentials | | npx skills add fails | npx not available or network issue | Use okx skill download instead, then manually install |