Stats
Actions
Tags
'%20stop-opacity%3D'0.16'%2F%3E%3Cstop%20offset%3D'1'%20stop-color%3D'rgb(200%2C90%2C60)'%20stop-opacity%3D'0.03'%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D'320'%20height%3D'200'%20fill%3D'url(%23g)'%2F%3E%3Ccircle%20cx%3D'250'%20cy%3D'56'%20r%3D'92'%20fill%3D'rgb(200%2C90%2C60)'%20fill-opacity%3D'0.06'%2F%3E%3Ccircle%20cx%3D'64'%20cy%3D'172'%20r%3D'58'%20fill%3D'rgb(200%2C90%2C60)'%20fill-opacity%3D'0.05'%2F%3E%3C%2Fsvg%3E)
From okx-agent-skills-4
Manages OKX Simple Earn, Flash Earn, On-chain Earn, Dual Investment, and AutoEarn via the okx CLI. Handles balance checks, subscriptions, redemptions, and lending rate settings.
How this skill is triggered — by the user, by Claude, or both
Slash command
/okx-agent-skills-4:okx-cex-earnThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Before running any command, follow [`../_shared/preflight.md`](../_shared/preflight.md).
Before running any command, follow ../_shared/preflight.md.
Use metadata.version from this file's frontmatter as the reference for Step 2.
okx CLI:
npm install -g @okx_ai/okx-trade-cli
okx config init # select site -> follow browser OAuth flow
okx earn savings balanceSecurity: NEVER accept credentials in chat. Guide users to
okx config initfor setup.
Run both commands before any authenticated command — the apiKey field from okx auth status --json is the auth-binary's internal state and is always false regardless of whether ~/.okx/config.toml has an API-key profile. okx config show --json is the only authoritative source for API-key presence. The auth method is detected during preflight Step 2 and remembered for the session.
okx config show --json # reveals API-key profiles (TOML config)
okx auth status --json # reveals OAuth session state (auth-binary state)
Apply in this order — first match wins:
config show --json has any profile with a non-empty api_key field → API Key mode. Proceed.auth status --json returns "status":"logged_in" → OAuth mode. Proceed."status":"pending" — login is in progress, wait for it to complete."status":"not_logged_in" — stop, load okx-cex-auth skill and follow login steps, wait for completion.OKX Earn does not support demo mode. Always use live mode silently — don't mention it unless there's an error.
--profile <live-profile> (the profile without demo=true).On authentication errors (401 / "Session expired" / "Run okx auth login first"): stop immediately, load okx-cex-auth skill and follow re-authentication steps, then retry.
| 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, Flash Earn, On-chain Earn, Dual Investment (双币赢), or AutoEarn (自动赚币) | This skill |
| Command | Type | Auth | Description |
|---|---|---|---|
earn savings balance [ccy] | READ | Required | Savings balance (all or specific currency). Also fetch fixed-term orders for a complete picture. |
earn savings purchase --ccy --amt [--rate] | 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 | User's personal lending records with earnings detail |
earn savings rate-history | READ | Required | Simple Earn lending rates and fixed-term offers (require auth) |
earn savings fixed-products [--ccy] | READ | Required | Browse available fixed-term (定期) products with APR, term, remaining quota, and sold-out status |
earn savings fixed-orders [--ccy] [--state] | READ | Required | Query fixed-term (定期) orders. States: pending/earning/expired/settled/cancelled |
earn savings fixed-purchase --ccy --amt --term [--confirm] | WRITE | Required | Subscribe to Simple Earn Fixed (定期). Without --confirm: preview only |
earn savings fixed-redeem --reqId <reqId> | WRITE | Required | Redeem a fixed-term order (full amount). Only pending state orders can be redeemed early |
For full command syntax, rate field semantics, and confirmation templates, read {baseDir}/references/savings-commands.md.
| 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-and-buy --productId --sz --notionalCcy | WRITE | Required | Atomic subscribe: quote + execute in one step |
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-execute --ordId | WRITE | Required | Two-step early redemption: preview then execute |
DCD does not support demo/simulated trading mode. Always use live mode (API Key:
--profile <live-profile>; OAuth: no flag needed).
For full command syntax, product concepts, and error codes, read {baseDir}/references/dcd-commands.md.
| 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.
| Command | Type | Auth | Description |
|---|---|---|---|
earn auto-earn status [CCY] | READ | Required | Query currencies supporting auto-earn and their status |
earn auto-earn on <CCY> | WRITE | Required | Enable auto-earn for a currency |
earn auto-earn off <CCY> | WRITE | Required | Disable auto-earn for a currency |
24h restriction: Cannot disable within 24 hours of enabling (API hard limit). Always warn user before enabling.
For full command syntax, earnType inference rules, and MCP tool reference, read {baseDir}/references/autoearn-commands.md.
| Command | Type | Auth | Description |
|---|---|---|---|
earn flash-earn projects [--status <0|100|0,100>] | READ | Required | Browse Flash Earn projects by status. 0=upcoming, 100=in-progress, default is both |
Before any authenticated command: see Credential & Profile Check. Always use live mode silently.
Simple Earn Flexible (活期):
Simple Earn Fixed (定期):
earn savings fixed-products [--ccy]. This is the dedicated tool for querying the fixed-term product pool — use it whenever the user asks about available fixed earn products, remaining quota, or APR.earn savings fixed-orders [--ccy] [--state].{baseDir}/references/savings-commands.md for pre-execution checklists and confirmation templates.{baseDir}/references/workflows.md.On-chain Earn:
AutoEarn (自动赚币):
{baseDir}/references/autoearn-commands.md for confirmation templates and earnType inference.Flash Earn (闪赚):
--status 0 for upcoming projects, --status 100 for in-progress projects, or omit the flag to view both.When user asks to view "earn positions" or "赚币持仓" (regardless of whether they mention DCD explicitly), query all position-bearing sub-modules simultaneously (Flash Earn is query-only, no positions):
okx earn savings balance --json # Simple Earn Flexible (活期)
okx earn savings fixed-orders --json # Simple Earn Fixed (定期)
okx earn onchain orders --json # On-chain Earn
okx 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 / 双币赢):
{baseDir}/references/workflows.md (DCD browse flow) for the mandatory parallel pre-fetch before rendering the product table{baseDir}/references/workflows.md (DCD subscribe flow){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.
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.
After any purchase, verify based on product type:
quote-and-buy succeeded → run earn dcd orders --json, show only the matching order.ordId) → run earn onchain orders --json, show only the matching order.ordId in response) → run earn savings balance --ccy <ccy> --json.earn savings fixed-orders --ccy <ccy> --state pending --json, show the new order.Simple Earn Flexible 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 Flexible redeem: Run earn savings balance --ccy <ccy> to confirm updated balance. Inform user funds returned to funding account.
Simple Earn Fixed purchase: Run earn savings fixed-orders --ccy <ccy> --state pending --json to confirm the order was created. Show order details including APR, term, and expected expiry date.
Simple Earn Fixed redeem: Run earn savings fixed-orders --json to confirm the order state changed to cancelled. Inform user full principal returned to funding account — no interest earned for early cancellation.
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:
state: 3 (cancelling) → inform user: cancellation in progress, funds will return to funding account shortly.--json to list/query commands and render results as a Markdown table — never paste raw terminal output.curl -I https://www.okx.comFor number/time formatting and response structure conventions, read {baseDir}/references/templates.md.
npx claudepluginhub okx/agent-skillsMonitors OKX Flash Earn, Fixed Earn, and Flexible Earn opportunities, sends push notifications, and guides subscription. Useful for automated earn opportunity tracking.
Discovers and manages OKX-aggregated DeFi positions: search products, deposit/withdraw/claim rewards, view portfolio across chains.
Manages a Binance Web3 wallet: sign-in/out, balance checks, token transfers, DEX swaps, limit orders, prediction market trading, x402 payments, and DeFi operations.