okx-cex-skill-mp

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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

浏览、搜索、安装并管理OKX Skills Marketplace中的AI交易skill。Skill是模块化的AI提示词包，可以扩展你的交易助手能力，覆盖市场分析、交易执行、风险管理和投资组合优化等场景。

Skill路由规则

技能市场 →
```
okx-cex-skill-mp
```
（即当前skill）
市场数据/指标 →
```
okx-cex-market
```
账户余额/持仓 →
```
okx-cex-portfolio
```
下单/撤单 →
```
okx-cex-trade
```
网格/DCA机器人 →
```
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
```

安装
```
okx
```
CLI:
bash
```
npm install -g @okx_ai/okx-trade-cli
```
配置API凭证（访问市场必须）:
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.

当用户想要安装skill时，请严格遵循以下顺序：

始终优先尝试
okx skill add <name>
第一 —— 该命令会一键下载skill并安装到所有检测到的Agent（Claude Code、OpenClaw、Cursor、Windsurf等）中。
仅当
add
命令失败时，才回退到手动下载方案：
- 告知用户
```
add
```
  失败的原因（网络错误、npx不可用、权限问题等）
- 提供替代方案
```
okx skill download <name> --dir <path>
```
- 引导用户手动解压并将文件放置到其Agent的skill目录下

除非

add

已经失败，否则永远不要跳过

add

直接使用

download

。

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.


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	描述
1	`okx skill search <keyword>`	按关键词搜索技能市场
2	`okx skill search --categories <id>`	按分类筛选skill
3	`okx skill categories`	列出所有可用分类
4	`okx skill add <name>`	下载并安装到所有检测到的Agent
5	`okx skill download <name> [--dir <path>]`	仅下载zip压缩包（默认保存到当前目录）
6	`okx skill list`	列出本地已安装的skill
7	`okx skill check <name>`	检查是否有可用的新版本
8	`okx skill remove <name>`	卸载某个skill

任意命令后添加

--json

可获取原始JSON格式输出。

Commands in Detail

命令详情

1. Search Skills

1. 搜索Skill

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

bash

okx skill search grid

输出:

  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.

按分类筛选搜索:

bash

okx skill search --categories trading-strategy

分页（响应中包含

totalPage

表示总页数）:

bash

okx skill search grid --page 2 --limit 5

Output: "3 skills found (page 2/4). Use

okx skill add <name>

to install."

输出: "3 skills found (page 2/4). Use

okx skill add <name>

to install."

undefined

undefined

2. Browse Categories

2. 浏览分类

bash

okx skill categories

Output:

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

bash

okx skill categories

输出:

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

3. Install a Skill

3. 安装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
```

bash

okx skill add grid-premium

输出:

Downloading grid-premium...
Installing to detected agents...
✓ Skill "grid-premium" v1.2.0 installed

底层执行逻辑:

从OKX市场API下载skill压缩包
解压并验证包（检查SKILL.md是否存在、读取元数据）
运行
```
npx skills add
```
安装到所有本地检测到的Agent
将安装记录写入
```
~/.okx/skills/registry.json
```

4. Download Only (No Install)

4. 仅下载（不安装）

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

当

add

命令失败或用户想要原始安装包时使用:

bash

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

输出:

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

压缩包包含:

```
SKILL.md
```
—— skill的主说明文件
```
_meta.json
```
—— 元数据（名称、版本、标题、描述）
```
reference/
```
—— 可选的辅助文档

5. List Installed Skills

5. 列出已安装的Skill

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.

bash

okx skill list

输出:

  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

6. 检查更新

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.

bash

okx skill check grid-premium

输出:

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

如需更新，只需再次执行

okx skill add <name>

即可，它会覆盖旧版本。

7. Remove a Skill

7. 移除Skill

bash

okx skill remove grid-premium

Output:

✓ Skill "grid-premium" removed

bash

okx skill remove grid-premium

输出:

✓ Skill "grid-premium" removed

MCP Tools (Alternative)

MCP Tools（替代方案）

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.

当CLI不可用时（例如没有终端访问权限的Claude Desktop），可以通过MCP工具使用相同的市场功能:

MCP Tool	等效CLI命令	描述
`skills_search`	`okx skill search`	按关键词/分类搜索，响应中包含 `totalPage` 用于分页。
`skills_get_categories`	`okx skill categories`	列出分类
`skills_download`	`okx skill download`	下载zip压缩包到指定目录

注意：MCP工具仅支持搜索和下载，完整的安装流程（

add

命令）需要CLI访问权限。

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

错误码	含义	处理方案
`70002 SKILL_DELETED`	该skill已从技能市场下架	选择其他skill
`70003 NO_APPROVED_VERSION`	无可用的已审核版本	Skill正在审核中，请稍后再试
`70030 VERSION_NOT_APPROVED`	对应版本尚未通过审核，无法下载	等待审核完成或使用旧版本
`50111/50112/50113`	认证错误	执行 `okx config init` 配置凭证
`npx skills add` 执行失败	npx不可用或网络问题	改用 `okx skill download` 代替，然后手动安装

okx-cex-skill-mp

Original

Translation

OKX Skills Marketplace

OKX Skills Marketplace

Prerequisites

前置要求

Installation Strategy

安装策略

Command Reference

命令参考

Commands in Detail

命令详情

1. Search Skills

1. 搜索Skill

Output: "3 skills found (page 2/4). Use
`okx skill add <name>`
to install."

输出: "3 skills found (page 2/4). Use
`okx skill add <name>`
to install."

2. Browse Categories

2. 浏览分类

3. Install a Skill

3. 安装Skill

4. Download Only (No Install)

4. 仅下载（不安装）

5. List Installed Skills

5. 列出已安装的Skill

6. Check for Updates

6. 检查更新

7. Remove a Skill

7. 移除Skill

MCP Tools (Alternative)

MCP Tools（替代方案）

Error Handling

错误处理