/okx-cex-skill-mp

name: okx-cex-skill-mp
description: "Use this skill when the user asks to: 'find a trading skill', 'search for skills', 'install a skill', 'add a skill', 'download a skill', 'browse skill marketplace', 'what skills are available', 'update a skill', 'check for skill updates', 'remove a skill', 'uninstall a skill', 'list installed skills', 'show my skills', 'skill categories', 'verify skill signature', 'verify installed skill', 're-verify a skill', 'check skill integrity', or any request to discover, install, update, verify, or manage AI trading skills from the OKX Skills Marketplace. This skill covers searching, browsing categories, installing via CLI, downloading zip packages, checking for updates, removing installed skills, and verifying Ed25519 signatures of installed skills. Requires API credentials for marketplace API access. Do NOT use for placing orders (use okx-cex-trade), market data (use okx-cex-market), or bot management (use okx-cex-bot)."
license: MIT
metadata:
  author: okx
  version: "1.4.1"
  homepage: "https://www.okx.com"
  agent:
    requires:
      bins: ["okx"]
    install:
      - id: npm
        kind: node
        package: "@okx_ai/okx-trade-cli@1.4.1"
        bins: ["okx"]
        label: "Install okx CLI (npm)"

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 | | 9 | `okx skill verify <name>` | Re-verify an installed skill's signature on demand |

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 warn