---
id: sm3-okx-cex-earn
name: "okx-cex-earn"
url: https://skills.yangsir.net/skill/sm3-okx-cex-earn
author: okx
domain: web3
tags: ["okx-exchange", "web3-finance", "cryptocurrency-earn", "decentralized-finance"]
install_count: 5300
rating: 4.40 (20 reviews)
github: https://github.com/okx/agent-skills
---

# okx-cex-earn

> 通过OKX CEX Earn CLI管理OKX中心化交易所的理财产品，进行申购、赎回等操作。

**Stats**: 5,300 installs · 4.4/5 (20 reviews)

## Before / After 对比

### OKX CEX Earn管理

## Readme

# okx-cex-earn

# OKX CEX Earn CLI

## Prerequisites

- Install `okx` CLI:

```
npm install -g @okx_ai/okx-trade-cli

```

- Configure credentials:

```
okx config add-profile AK=<your_api_key> SK=<your_secret_key> PP=<your_passphrase> name=live
# or interactive wizard:
okx config init

```

- Verify: `okx --profile live earn savings balance`

## Credential & Profile Check

Run `okx config show` before any authenticated command.

- Error or no configuration → **stop**, guide user to run `okx config init`, wait for completion.

- Credentials configured → proceed.

OKX Earn does not support demo mode. Always use `--profile live` silently — don't mention it unless there's an error.

**On 401 errors:** stop immediately, tell the user their credentials may be invalid or expired, guide them to update `~/.okx/config.toml` (do NOT ask them to paste credentials into chat), then verify with `okx config show` and retry.

## Skill Routing

User intent
Route to skill

Market prices, tickers, candles
`okx-cex-market`

Spot / swap / futures / options orders
`okx-cex-trade`

Account balance, positions, transfers
`okx-cex-portfolio`

Grid / DCA trading bots
`okx-cex-bot`

Simple Earn, On-chain Earn, or Dual Investment (双币赢)
**This skill**

## Command Index

### earn savings — Simple Earn (7 commands)

Command
Type
Auth
Description

`earn savings balance [ccy]`
READ
Required
Savings balance (all or specific currency)

`earn savings purchase --ccy --amt`
WRITE
Required
Subscribe funds to Simple Earn

`earn savings redeem --ccy --amt`
WRITE
Required
Redeem funds from Simple Earn

`earn savings set-rate --ccy --rate`
WRITE
Required
Set minimum lending rate

`earn savings lending-history`
READ
Required
Lending records with earnings detail

`earn savings rate-summary [ccy]`
READ
Required
Market lending rate summary

`earn savings rate-history`
READ
Required
Historical lending rates

For full command syntax, rate field semantics, and confirmation templates, read `{baseDir}/references/savings-commands.md`.

### earn dcd — Dual Investment / 双币赢 (10 commands)

Command
Type
Auth
Description

`earn dcd pairs`
READ
Required
Available DCD currency pairs

`earn dcd products`
READ
Required
Active products with filters

`earn dcd quote --productId --sz --notionalCcy`
READ
Required
Request real-time quote (TTL 30s)

`earn dcd buy --quoteId`
WRITE
Required
Execute an existing quote

`earn dcd quote-and-buy --productId --sz --notionalCcy`
WRITE
Required
Quote + execute in one step (AI preferred)

`earn dcd order --ordId`
READ
Required
Quick state check for a single order

`earn dcd orders`
READ
Required
Full order list / history

`earn dcd redeem-quote --ordId`
READ
Required
Early redemption preview (TTL 15s)

`earn dcd redeem-execute --ordId`
WRITE
Required
Re-quote + execute redemption (AI preferred)

`earn dcd redeem --ordId --quoteId`
WRITE
Required
Execute redemption with existing quoteId (low-level)

DCD does **not** support demo/simulated trading mode. Always use `--profile live`.

For full command syntax, product concepts, and error codes, read `{baseDir}/references/dcd-commands.md`.

### earn onchain — On-chain Earn (6 commands)

Command
Type
Auth
Description

`earn onchain offers`
READ
Required
Available staking/DeFi products

`earn onchain purchase --productId --ccy --amt`
WRITE
Required
Subscribe to on-chain product

`earn onchain redeem --ordId --protocolType`
WRITE
Required
Redeem on-chain investment

`earn onchain cancel --ordId --protocolType`
WRITE
Required
Cancel pending on-chain order

`earn onchain orders`
READ
Required
Active on-chain orders

`earn onchain history`
READ
Required
Historical on-chain orders

For full command syntax and parameters, read `{baseDir}/references/onchain-commands.md`.

## Operation Flow

### Step 0 — Credential & Profile Check

Before any authenticated command: see [Credential & Profile Check](#credential--profile-check). Always use `--profile live` silently.

### Step 1 — Identify earn intent

**Simple Earn / On-chain Earn:**

- Query balance / history / rates → READ command, proceed directly.

- Subscribe / redeem / set-rate / on-chain purchase → WRITE command, go to Step 2.

When user asks to view "earn positions" or "赚币持仓" (regardless of whether they mention DCD explicitly), query all three simultaneously:

```
okx --profile live earn savings balance --json    # Simple Earn
okx --profile live earn onchain orders --json     # On-chain Earn
okx --profile live earn dcd orders --json         # Dual Investment (双币赢)

```

Only present sections that have actual holdings. For DCD: translate state codes using the table in `{baseDir}/references/dcd-commands.md`.

**Dual Investment (DCD / 双币赢):**

- Browse products / pairs → READ; when user specifies a currency, read `{baseDir}/references/workflows.md` (DCD browse flow) for the mandatory parallel pre-fetch before rendering the product table

- Subscribe (quote-and-buy) → WRITE → see `{baseDir}/references/workflows.md` (DCD subscribe flow)

- Early redeem → WRITE → see `{baseDir}/references/workflows.md` (DCD early redeem flow)

For multi-step workflows (idle fund analysis, subscribe + verify, redeem + transfer, on-chain subscribe), read `{baseDir}/references/workflows.md`.

### Step 2 — Confirm write operation

For all WRITE commands, present a summary and wait for explicit confirmation.

"just do it" / "直接搞" is NOT valid confirmation — the user must see the summary first.

For Simple Earn confirmation dialog format, read `{baseDir}/references/savings-commands.md`. For On-chain confirmation, read `{baseDir}/references/onchain-commands.md`.

### Step 3 — Execute and verify

After any purchase, verify based on product type:

- **DCD** `quote-and-buy` succeeded → run `earn dcd orders --json`, show only the matching order.

- **On-chain** purchase (response contains `ordId`) → run `earn onchain orders --json`, show only the matching order.

- **Simple Earn** purchase (no `ordId` in response) → run `earn savings balance --ccy <ccy> --json`.

**Simple Earn purchase:** Run in parallel — `earn savings balance --ccy <ccy>` and `earn savings rate-history --ccy <ccy> --limit 1 --json`. For output format, read `{baseDir}/references/savings-commands.md`.

**Simple Earn redeem:** Run `earn savings balance --ccy <ccy>` to confirm updated balance. Inform user funds returned to funding account.

**On-chain redeem:** Query `earn onchain orders` to confirm state. Show `estSettlementTime` as estimated arrival time.

**On-chain cancel:** Query `earn onchain orders` after submission:

- Order gone from list → inform user: cancellation complete, funds returned to funding account.

- `state: 3` (cancelling) → inform user: cancellation in progress, funds will return to funding account shortly.

## Global Notes

- **Security:** Never ask users to paste API keys or secrets into chat.

- **Output:** Always pass `--json` to list/query commands and render results as a Markdown table — never paste raw terminal output.

- **Network errors:** If commands fail with a connection error, prompt user to check VPN: `curl -I https://www.okx.com`

- **Language:** Always respond in the user's language.

For number/time formatting and response structure conventions, read `{baseDir}/references/templates.md`.
Weekly Installs223Repository[okx/agent-skills](https://github.com/okx/agent-skills)GitHub Stars35First Seen3 days agoSecurity Audits[Gen Agent Trust HubPass](/okx/agent-skills/okx-cex-earn/security/agent-trust-hub)[SocketWarn](/okx/agent-skills/okx-cex-earn/security/socket)[SnykFail](/okx/agent-skills/okx-cex-earn/security/snyk)Installed onopencode222codex221cursor220gemini-cli220github-copilot220amp220

---
*Source: https://skills.yangsir.net/skill/sm3-okx-cex-earn*
*Markdown mirror: https://skills.yangsir.net/api/skill/sm3-okx-cex-earn/markdown*