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

3installs

Sourceokx/agent-skills

Added on2026-04-03

NPX Install

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

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

Install
```
okx
```
CLI:
bash
```
npm install -g @okx_ai/okx-trade-cli
```
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:

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


okx skill search <keyword>
okx skill search --categories <id>
okx skill categories
okx skill add <name>
okx skill download <name> [--dir <path>]
okx skill list
okx skill check <name>
okx skill remove <name>

#	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>]`	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:

Downloads skill zip from OKX marketplace API
Extracts and validates the package (checks SKILL.md exists, reads metadata)
Runs
```
npx skills add
```
to install to all locally detected agents
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 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 zip to directory

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

okx-cex-skill-mp

NPX Install

Tags

SKILL.md Content

OKX Skills Marketplace

Prerequisites

Installation Strategy

Command Reference

Commands in Detail

1. Search Skills

2. Browse Categories

3. Install a Skill

4. Download Only (No Install)

5. List Installed Skills

6. Check for Updates

7. Remove a Skill

MCP Tools (Alternative)

Error Handling