OKX CEX Earn CLI：OKX交易所赚币命令行工具，管理简单赚币、双币赢、链上赚币

okx-cex-earn by okx/agent-skills

534 周安装量

41 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/okx/agent-skills --skill okx-cex-earn

自动化区块链金融科技

🇨🇳中文介绍

OKX CEX Earn CLI

前提条件

安装 okx CLI：

npm install -g @okx_ai/okx-trade-cli
配置凭证：

okx config add-profile AK=<your_api_key> SK=<your_secret_key> PP=<your_passphrase> name=live # 或使用交互式向导： okx config init
验证：okx --profile live earn savings balance

凭证与配置文件检查

在执行任何需要认证的命令前，运行 okx config show。

出现错误或无配置 → 停止，引导用户运行 okx config init，等待完成。
凭证已配置 → 继续执行。

OKX Earn 不支持模拟模式。请始终静默使用 --profile live — 除非出现错误，否则不要提及它。

关于 401 错误： 立即停止，告知用户其凭证可能无效或已过期，引导他们更新（要求他们在聊天中粘贴凭证），然后使用验证并重试。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

用户意图	路由到技能
市场价格、行情、K线	`okx-cex-market`
现货/永续/交割/期权订单	`okx-cex-trade`
账户余额、持仓、划转	`okx-cex-portfolio`
网格/定投交易机器人	`okx-cex-bot`
简单赚币、链上赚币或双币赢	本技能

earn savings — 简单赚币 (6 个命令)

命令	类型	认证	描述
`earn savings balance [ccy]`	读取	必需	赚币余额（全部或指定币种）
`earn savings purchase --ccy --amt`	写入	必需	申购资金到简单赚币
`earn savings redeem --ccy --amt`	写入	必需	从简单赚币赎回资金
`earn savings set-rate --ccy --rate`	写入	必需	设置最低出借利率
`earn savings lending-history`	读取	必需	用户个人出借记录及收益详情
`earn savings rate-history`	读取	公开	简单赚币出借利率

关于完整的命令语法、利率字段语义和确认模板，请阅读 {baseDir}/references/savings-commands.md。

earn dcd — 双币赢 (6 个命令)

命令	类型	认证	描述
`earn dcd pairs`	读取	必需	可用的双币赢货币对
`earn dcd products`	读取	必需	活跃产品（带过滤器）
`earn dcd quote-and-buy --productId --sz --notionalCcy`	写入	必需	原子化申购：报价 + 执行一步完成
`earn dcd order --ordId`	读取	必需	单个订单的快速状态查询
`earn dcd orders`	读取	必需	完整的订单列表/历史
`earn dcd redeem-execute --ordId`	写入	必需	两步提前赎回：预览然后执行

双币赢不支持模拟/模拟交易模式。请始终使用 --profile live。

关于完整的命令语法、产品概念和错误代码，请阅读 {baseDir}/references/dcd-commands.md。

earn onchain — 链上赚币 (6 个命令)

命令	类型	认证	描述
`earn onchain offers`	读取	必需	可用的质押/DeFi 产品
`earn onchain purchase --productId --ccy --amt`	写入	必需	申购链上产品
`earn onchain redeem --ordId --protocolType`	写入	必需	赎回链上投资
`earn onchain cancel --ordId --protocolType`	写入	必需	取消待处理的链上订单
`earn onchain orders`	读取	必需	活跃的链上订单
`earn onchain history`	读取	必需	历史的链上订单

关于完整的命令语法和参数，请阅读 {baseDir}/references/onchain-commands.md。

步骤 0 — 凭证与配置文件检查

在执行任何需要认证的命令前：参见“凭证与配置文件检查”。始终静默使用 --profile live。

步骤 1 — 识别赚币意图

简单赚币 / 链上赚币：

查询余额 / 历史 / 利率 → 读取命令，直接进行。
申购 / 赎回 / 设置利率 / 链上申购 → 写入命令，转到步骤 2。

当用户要求查看“赚币持仓”时（无论是否明确提及双币赢），同时查询所有三项：

okx --profile live earn savings balance --json    # 简单赚币
okx --profile live earn onchain orders --json     # 链上赚币
okx --profile live earn dcd orders --json         # 双币赢

仅呈现实际有持仓的部分。对于双币赢：使用 {baseDir}/references/dcd-commands.md 中的表格翻译状态码。

浏览产品 / 货币对 → 读取；当用户指定币种时，在呈现产品表之前，阅读 {baseDir}/references/workflows.md（双币赢浏览流程）了解强制性的并行预取操作
申购（quote-and-buy）→ 写入 → 参见 {baseDir}/references/workflows.md（双币赢申购流程）
提前赎回 → 写入 → 参见 {baseDir}/references/workflows.md（双币赢提前赎回流程）

对于多步骤工作流（闲置资金分析、申购+验证、赎回+划转、链上申购），请阅读 {baseDir}/references/workflows.md。

步骤 2 — 确认写入操作

对于所有写入命令，呈现摘要并等待明确确认。

"just do it" / "直接搞" 不是有效的确认 — 用户必须先看到摘要。

关于简单赚币确认对话框格式，请阅读 {baseDir}/references/savings-commands.md。关于链上确认，请阅读 {baseDir}/references/onchain-commands.md。

步骤 3 — 执行与验证

任何申购操作后，根据产品类型进行验证：

双币赢 quote-and-buy 成功 → 运行 earn dcd orders --json，仅显示匹配的订单。
链上申购（响应包含 ordId）→ 运行 earn onchain orders --json，仅显示匹配的订单。
简单赚币 申购（响应中无 ordId）→ 运行 earn savings balance --ccy <ccy> --json。

简单赚币申购： 并行运行 — earn savings balance --ccy <ccy> 和 earn savings rate-history --ccy <ccy> --limit 1 --json。关于输出格式，请阅读 {baseDir}/references/savings-commands.md。

简单赚币赎回： 运行 earn savings balance --ccy <ccy> 以确认更新后的余额。告知用户资金已返还至资金账户。

链上赎回： 查询 earn onchain orders 以确认状态。将 estSettlementTime 显示为预计到账时间。

链上取消： 提交后查询 earn onchain orders：

订单从列表中消失 → 告知用户：取消完成，资金已返还至资金账户。
state: 3（取消中）→ 告知用户：取消进行中，资金将很快返还至资金账户。

安全性： 切勿要求用户在聊天中粘贴 API 密钥或密钥。
输出： 始终对列表/查询命令传递 --json，并将结果呈现为 Markdown 表格 — 切勿粘贴原始终端输出。
网络错误： 如果命令因连接错误失败，提示用户检查 VPN：curl -I https://www.okx.com
语言： 始终使用用户的语言进行回复。

关于数字/时间格式化和响应结构约定，请阅读 {baseDir}/references/templates.md。

🇺🇸English

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 (6 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

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

earn dcd — Dual Investment / 双币赢 (6 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-and-buy --productId --sz --notionalCcy`	WRITE	Required	Atomic subscribe: quote + execute in one step
`earn dcd order --ordId`	READ	Required

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

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

457

Repository

okx/agent-skills

GitHub Stars

First Seen

9 days ago

Security Audits

Gen Agent Trust HubPass SocketPass SnykFail

Installed on

opencode452

codex451

gemini-cli449

kimi-cli449

github-copilot449

amp449

OKX CEX Earn CLI：OKX交易所赚币命令行工具，管理简单赚币、双币赢、链上赚币

🇨🇳中文介绍

OKX CEX Earn CLI

前提条件

凭证与配置文件检查

相关 Skills

技能路由

命令索引

earn savings — 简单赚币 (6 个命令)

earn dcd — 双币赢 (6 个命令)

earn onchain — 链上赚币 (6 个命令)

操作流程

步骤 0 — 凭证与配置文件检查

步骤 1 — 识别赚币意图

步骤 2 — 确认写入操作

步骤 3 — 执行与验证

全局注意事项

🇺🇸English

OKX CEX Earn CLI

Prerequisites

Credential & Profile Check

Skill Routing

Command Index

earn savings — Simple Earn (6 commands)

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

earn onchain — On-chain Earn (6 commands)

Operation Flow

Step 0 — Credential & Profile Check

Step 1 — Identify earn intent

Step 2 — Confirm write operation

Step 3 — Execute and verify

Global Notes

最新 Skills