okx-cex-skill-mp

Original：🇺🇸 English
Translated

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', or any request to discover, install, update, 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, and removing 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).

4installs
Sourceokx/agent-skills
Added on

NPX Install

npx skill4agent add okx/agent-skills okx-cex-skill-mp

Tags

Translated version includes tags in frontmatter
okx-skill-marketplacecli-toolai-trading-skillskill-managementtrading-assistant

SKILL.md Content

View Translation Comparison →

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.
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
  2. 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

#CommandDescription
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>]
Download zip only (default: current dir)
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.

Commands in Detail

1. Search Skills

bash
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:
bash
okx skill search --categories trading-strategy
Pagination (response includes 
totalPage
for total pages):
bash
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

bash
okx skill categories
Output:
  ID                  NAME
  trading-strategy    Trading Strategy
  risk-management     Risk Management
  analysis            Market Analysis

3. Install a Skill

bash
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:
bash
okx skill download grid-premium --dir ~/Downloads/
Output:
✓ Downloaded grid-premium.zip
  Path: /Users/me/Downloads/grid-premium.zip
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

bash
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

bash
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

bash
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 ToolEquivalent CLIDescription
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 zip to directory
Note: MCP tools only support search and download. The full install flow (
add
) requires CLI access.

Error Handling

ErrorMeaningAction
70002 SKILL_DELETED
Skill has been removed from marketplaceChoose a different skill
70003 NO_APPROVED_VERSION
No approved version availableSkill is pending review, try later
70030 VERSION_NOT_APPROVED
Version not yet approved for downloadWait for review or use an older version
50111/50112/50113
Authentication errorRun 
okx config init
to set up credentials
npx skills add
fails		npx not available or network issueUse 
okx skill download
instead, then manually install