🚀 快速安装

复制以下命令并运行，立即安装此 Skill：

npx skills add https://skills.sh/okx/agent-skills/okx-cex-earn

💡 提示：需要 Node.js 和 NPM

OKX CEX 赚币 CLI

先决条件

  1. 安装 okx CLI： 
    npm install -g @okx_ai/okx-trade-cli
  2. 配置凭证： 
    okx config add-profile AK=<你的_api密钥> SK=<你的_私钥> PP=<你的_口令> name=live
# 或使用交互式向导：
okx config init
  3. 验证：okx --profile live earn savings balance

凭证与配置文件检查

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

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

OKX 赚币不支持模拟模式。始终静默使用 --profile live——除非出现错误，否则不要提及此参数。

遇到 401 错误时：立即停止，告知用户其凭证可能无效或已过期，指导他们更新 ~/.okx/config.toml（切勿要求他们将凭证粘贴到聊天中），然后使用 okx config show 验证并重试。

技能路由

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

命令索引

earn savings — 简单赚币（7个命令）

命令 类型 认证 描述
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-summary [ccy] 读取 需要 市场出借利率摘要
earn savings rate-history 读取 需要 历史出借利率

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

earn dcd — 双币赢（10个命令）

命令 类型 认证 描述
earn dcd pairs 读取 需要 可用的双币投资币对
earn dcd products 读取 需要 带有筛选条件的活跃产品
earn dcd quote --productId --sz --notionalCcy 读取 需要 请求实时报价（有效期30秒）
earn dcd buy --quoteId 写入 需要 执行现有报价
earn dcd quote-and-buy --productId --sz --notionalCcy 写入 需要 一步完成报价+执行（AI首选）
earn dcd order --ordId 读取 需要 快速查看单个订单状态
earn dcd orders 读取 需要 完整订单列表/历史
earn dcd redeem-quote --ordId 读取 需要 提前赎回预览（有效期15秒）
earn dcd redeem-execute --ordId 写入 需要 重新报价+执行赎回（AI首选）
earn dcd redeem --ordId --quoteId 写入 需要 使用现有quoteId执行赎回（底层）

双币赢不支持模拟交易模式。始终使用 --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步 — 确认写入操作

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

“直接搞” 不是有效确认 — 用户必须先看到摘要。

关于简单赚币确认对话框格式，请阅读 {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 <币种> --json。

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

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

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

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

  • 订单从列表中消失 → 告知用户：取消完成，资金已返回资金账户。
  • state: 3（取消中） → 告知用户：取消正在进行中，资金即将返回资金账户。

全局注意事项

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

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