okx-cex-earn

Name: okx-cex-earn
Author: okx

OKX CEX 赚币 CLI

前置检查

运行任何命令前，请遵循 ../_shared/preflight.md。
使用本文件 frontmatter 中的 metadata.version 作为步骤 2 的参考。

前提条件

安装 okx CLI：
```
npm install -g @okx_ai/okx-trade-cli
```

配置凭证：

okx config init   # 选择站点 -> 按照浏览器 OAuth 流程操作

验证：okx earn savings balance

安全：切勿在聊天中接受凭证。引导用户使用 okx config init 进行设置。

凭证与配置文件检查

在任何需要认证的命令之前，同时运行以下两个命令——okx auth status --json 中的 apiKey 字段是认证二进制的内部状态，无论 ~/.okx/config.toml 是否包含 API 密钥配置文件，该字段始终为 false。okx config show --json 是判断 API 密钥是否存在的唯一权威来源。认证方法在前置检查步骤 2 中检测，并在会话期间记住。

okx config show --json      # 显示 API 密钥配置文件（TOML 配置）
okx auth status --json      # 显示 OAuth 会话状态（认证二进制状态）

按以下顺序应用——匹配第一个即生效：

config show --json 中存在任何包含非空 api_key 字段的配置文件 → API 密钥模式。继续。
无 API 密钥配置文件且 auth status --json 返回 "status":"logged_in" → OAuth 模式。继续。
无 API 密钥配置文件且 "status":"pending" — 登录正在进行中，等待完成。
无 API 密钥配置文件且 "status":"not_logged_in" — 停止，加载 okx-cex-auth 技能并按照登录步骤操作，等待完成。

OKX 赚币不支持模拟模式。始终静默使用实盘模式——除非出现错误，否则不要提及。

API 密钥用户：使用 --profile <live-profile>（不包含 demo=true 的配置文件）。
OAuth 用户：无需标志（实盘为默认）。

认证错误（401 / "Session expired" / "Run okx auth login first"）时： 立即停止，加载 okx-cex-auth 技能并按照重新认证步骤操作，然后重试。

技能路由

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

命令索引

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

命令	类型	认证	描述
`earn savings balance [ccy]`	读取	需要	储蓄余额（全部或指定币种）。同时获取定期订单以获取完整信息。
`earn savings purchase --ccy --amt [--rate]`	写入	需要	申购简单赚币（活期）
`earn savings redeem --ccy --amt`	写入	需要	赎回简单赚币（活期）
`earn savings set-rate --ccy --rate`	写入	需要	设置最低借贷利率
`earn savings lending-history`	读取	需要	用户个人借贷记录及收益详情
`earn savings rate-history`	读取	需要	简单赚币借贷利率和定期产品报价（需要认证）
`earn savings fixed-products [--ccy]`	读取	需要	浏览可用定期产品，包含年化收益率、期限、剩余额度及售罄状态
`earn savings fixed-orders [--ccy] [--state]`	读取	需要	查询定期订单。状态：pending/earning/expired/settled/cancelled
`earn savings fixed-purchase --ccy --amt --term [--confirm]`	写入	需要	申购简单赚币定期。不带 `--confirm`：仅预览
`earn savings fixed-redeem --reqId <reqId>`	写入	需要	赎回定期订单（全额）。仅 `pending` 状态的订单可提前赎回

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

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

命令	类型	认证	描述
`earn dcd pairs`	读取	需要	可用的 DCD 币对
`earn dcd products`	读取	需要	活跃产品及筛选条件
`earn dcd quote-and-buy --productId --sz --notionalCcy`	写入	需要	原子申购：报价与执行一步完成
`earn dcd order --ordId`	读取	需要	单个订单快速状态查询
`earn dcd orders`	读取	需要	完整订单列表/历史
`earn dcd redeem-execute --ordId`	写入	需要	两步提前赎回：预览后执行

DCD 不支持模拟交易模式。始终使用实盘模式（API 密钥：--profile <live-profile>；OAuth：无需标志）。

完整命令语法、产品概念及错误码，请阅读 {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。

earn auto-earn — 自动赚币（3 个命令）

命令	类型	认证	描述
`earn auto-earn status [CCY]`	读取	需要	查询支持自动赚币的币种及其状态
`earn auto-earn on <CCY>`	写入	需要	启用某币种的自动赚币
`earn auto-earn off <CCY>`	写入	需要	禁用某币种的自动赚币

24 小时限制： 启用后 24 小时内无法禁用（API 硬限制）。启用前务必警告用户。

完整命令语法、earnType 推断规则及 MCP 工具参考，请阅读 {baseDir}/references/autoearn-commands.md。

earn flash-earn — 闪赚（1 个命令）

命令	类型	认证	描述
`earn flash-earn projects [--status <0\|100\|0,100>]`	读取	需要	按状态浏览闪赚项目。`0`=即将上线，`100`=进行中，默认两者都显示

操作流程

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

在任何需要认证的命令之前：参见凭证与配置文件检查。始终静默使用实盘模式。

步骤 1 — 识别赚币意图

简单赚币活期：

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

简单赚币定期：

浏览可用产品/检查额度 → earn savings fixed-products [--ccy]。这是查询定期产品池的专用工具——当用户询问可用定期产品、剩余额度或年化收益率时使用。
查询用户现有订单 → earn savings fixed-orders [--ccy] [--state]。
申购（两步：预览后确认）/ 赎回（仅 pending 状态） → 写入命令，进入步骤 2。执行前检查清单和确认模板请阅读 {baseDir}/references/savings-commands.md。
多步骤工作流（申购带预览、提前赎回），请阅读 {baseDir}/references/workflows.md。

链上赚币：

查询产品/订单/历史 → 读取命令，直接执行。
申购/赎回/取消 → 写入命令，进入步骤 2。

自动赚币：

查询自动赚币状态 → 读取，直接执行。
启用/禁用自动赚币 → 写入，进入步骤 2。确认模板和 earnType 推断请阅读 {baseDir}/references/autoearn-commands.md。

闪赚：

浏览项目 → 读取，直接执行。
使用 --status 0 查看即将上线项目，--status 100 查看进行中项目，或省略标志查看两者。

当用户要求查看“赚币持仓”时（无论是否明确提及 DCD），同时查询所有包含持仓的子模块（闪赚仅查询，无持仓）：

okx earn savings balance --json        # 简单赚币活期
okx earn savings fixed-orders --json   # 简单赚币定期
okx earn onchain orders --json         # 链上赚币
okx earn dcd orders --json             # 双币赢

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

双币赢：

浏览产品/币对 → 读取；当用户指定币种时，阅读 {baseDir}/references/workflows.md（DCD 浏览流程）了解在渲染产品表格前必须进行的并行预取
申购（quote-and-buy） → 写入 → 参见 {baseDir}/references/workflows.md（DCD 申购流程）
提前赎回 → 写入 → 参见 {baseDir}/references/workflows.md（DCD 提前赎回流程）

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

步骤 2 — 确认写入操作

对于所有写入命令，展示摘要并等待用户明确确认。

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

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

步骤 3 — 执行并验证

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

DCD quote-and-buy 成功 → 运行 earn dcd orders --json，仅显示匹配的订单。
链上申购（响应中包含 ordId） → 运行 earn onchain orders --json，仅显示匹配的订单。
简单赚币活期申购（响应中无 ordId） → 运行 earn savings balance --ccy <ccy> --json。
简单赚币定期申购 → 运行 earn savings fixed-orders --ccy <ccy> --state pending --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 savings fixed-orders --ccy <ccy> --state pending --json 确认订单已创建。显示订单详情，包括年化收益率、期限和预计到期日。

简单赚币定期赎回： 运行 earn savings fixed-orders --json 确认订单状态变为 cancelled。告知用户全部本金已返回资金账户——提前取消不产生利息。

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

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