# okx cex skill mp
## Metadata

- Canonical URL: https://6ducklearn.com/skills/okx-cex-skill-mp/
- Markdown URL: https://6ducklearn.com/skills/okx-cex-skill-mp/index.md
- Product: skills
- Category: integrations
- Tags: okx, trading, official, curated, integrations
- Updated: 2026-07-11T06:17:26.001373+00:00
## Summary
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).
## Content
> **6DuckLearn provenance:** Official OKX skill from https://github.com/okx/agent-skills. Curated here means source-reviewed by 6DuckLearn; it is not an endorsement of a strategy, asset, return claim, or suitability.
>
> **Financial safety boundary:** Never request secrets in chat. Before any external API call or action that places, cancels, or amends an order; changes leverage; transfers funds; creates or stops a bot; subscribes to or redeems an earn product; or signs/broadcasts a transaction, show the exact live/demo profile, instrument, side, size, price constraints, fees, and worst-case loss, then obtain explicit user approval. Default to read-only or demo mode when uncertain. Treat all analysis as research, not investment advice.

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

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

```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...
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):**
```bash
okx skill add grid-premium --force
```
> ⚠️ **Security warning**: `--force` bypasses signature verification and installs the skill even if verification fails. Only use this if you trust the source and understand the risk. The bypass is recorded in the registry with status `bypassed`.

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

To download as `.skill` format (for agents that recognize the extension):
```bash
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

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

### 8. Verify a Skill's Signature

Re-run signature verification on an already-installed skill without reinstalling it:

```bash
okx skill verify grid-premium
```

Output (success):
```
✓ grid-premium: signature verified (key: okx-skill-signing-key-2026, files: 3)
```

Output (failure):
```
✗ grid-premium: verification failed — Invalid signature
```

- Exit code is `1` on failure.
- Result is persisted back to `~/.okx/skills/registry.json`.
- Use `--json` for machine-readable output.

---

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

## Related Skills

- [okx cex auth](https://6ducklearn.com/skills/okx-cex-auth/index.md): Use this skill when the user wants to 'login/log in/sign in', 'authenticate', 'authorize', 'connect OKX account', 'set up credentials', 'first time setup', 'configure okx', '登录', '授权', '认证', '连接账户', '首次配置'. Also when any OKX CLI command fails with an auth error: 'Run okx auth login first', 'Session expired', 'not authenticated', 'requires_auth', '401 Unauthorized', 'token expired/not found', 'StorageNotFoundError', '会话过期', '未认证', '需要登录'. Also when the user asks about login status or the login was interrupted. Also when the user wants to install/update/check/remove the okx-auth binary — 'install/update/remove auth', 'download okx-auth', '安装/更新/卸载认证', 'auth binary status', 'Failed to spawn okx-auth'. Also use before using okx-cex-trade/portfolio/earn/bot for the first time. Do NOT use for market data queries (use okx-cex-market).
- [earn hunter](https://6ducklearn.com/skills/earn-hunter/index.md): Automatically monitors OKX Flash Earn, Fixed Earn, and Flexible Earn opportunities, sends push notifications, and guides subscription. Use when user says: Notify me about Flash Earn, monitor earn, notify me about earn, check financial products regularly, execute earn-hunter scan, earn-hunter scan, notify me when flexible annual yield is high, monitor flexible earn.
- [okx cex bot](https://6ducklearn.com/skills/okx-cex-bot/index.md): Manage Grid bots (spot/contract/coin-margined) and DCA Martingale bots (Spot DCA 现货马丁 / Contract DCA 合约马丁) on OKX. Covers create, stop, amend, monitor P&L, TP/SL, margin/investment adjustment, and AI-recommended parameters. Requires API credentials. Not for regular orders (okx-cex-trade), market data (okx-cex-market), or account info (okx-cex-portfolio).
- [okx cex earn](https://6ducklearn.com/skills/okx-cex-earn/index.md): Manages OKX Simple Earn (flexible savings/lending), Flash Earn, On-chain Earn (staking/DeFi), Dual Investment (DCD/双币赢), and AutoEarn (自动赚币) via the okx CLI. Use this skill whenever the user wants to check earn balances, browse flash-earn projects, subscribe or redeem earn products, view or set lending rates, monitor on-chain staking orders, interact with dual investment structured products, or manage auto-earn — even if phrased casually as 活期赚币, 定期赚币, 闪赚, 赚币, 申购, 赎回, 链上赚币, 质押, 理财, 双币赢, 双币理财, 双币申购, 高卖, 低买, dual investment, DCD, flash earn, buy low, sell high structured product, earn with target price, 目标价, 自动赚币, auto earn, auto-earn, 自动借出, 自动质押, auto lend, auto staking, USDG earn, USDG 赚币, 闲置资金自动理财, fixed earn, fixed deposit, term deposit, 定期理财, 定期. Also use when the user asks about idle funds and whether to earn on them.
- [okx cex market](https://6ducklearn.com/skills/okx-cex-market/index.md): Use this skill when the user asks for: price of any asset, ticker, order book, candles, OHLCV, funding rate, open interest, OI change scanner, market screener (top movers, high-volume, newly listed), mark price, index price, recent trades, instrument list, stock tokens, metals prices (gold, XAU, XAG), commodities (oil, OIL), forex rates (EUR/USD, EURUSDT), bond instruments, non-crypto assets, or any technical indicator query (RSI, MACD, EMA, Bollinger Bands, KDJ, SuperTrend, AHR999, BTC rainbow, and 70+ more). All commands are read-only and do NOT require API credentials. Do NOT use for account balance/positions (okx-cex-portfolio), placing/cancelling orders (okx-cex-trade), or bots (okx-cex-bot).
- [okx cex portfolio](https://6ducklearn.com/skills/okx-cex-portfolio/index.md): This skill should be used when the user asks about 'account balance', 'how much USDT do I have', 'my funding account', 'show my positions', 'open positions', 'position P&L', 'unrealized PnL', 'closed positions', 'position history', 'realized PnL', 'account bills', 'transaction history', 'trading fees', 'fee tier', 'account config', 'max order size', 'how much can I buy', 'withdrawable amount', 'transfer funds', 'move USDT to trading account', or 'switch position mode'. Also use for '总资产', 'full balance', 'all assets', 'total holdings', 'net worth', 'how much do I have in total', 'show all my balances', 'all account balances', 'asset overview', 'aggregated balance', 'asset snapshot', '资产快照'. Requires API credentials. Do NOT use for market prices (use okx-cex-market), placing/cancelling orders (use okx-cex-trade), or grid/DCA bots (use okx-cex-bot).
