okx-cex-earn

OKX CEX 賺幣 CLI

前置檢查

執行任何指令前，請先遵循 ../_shared/preflight.md。
以本檔案 frontmatter 中的 metadata.version 作為步驟 2 的參考。

先決條件

1. 安裝 okx CLI：

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

2. 設定憑證：

   okx config init   # 選擇站點 -> 依照瀏覽器 OAuth 流程操作
   

3. 驗證：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 /「工作階段已過期」/「請先執行 okx auth login」）時： 立即停止，載入 okx-cex-auth 技能並依照重新驗證步驟操作，然後重試。

---

技能路由

使用者意圖	路由至技能
市場價格、Ticker、K 線	okx-cex-market
現貨 / 合約 / 期貨 / 選擇權訂單	okx-cex-trade
帳戶餘額、持倉、轉帳	okx-cex-portfolio
網格 / DCA 交易機器人	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。請參閱 {baseDir}/references/autoearn-commands.md 了解確認範本與 earnType 推斷。

閃賺：

• 瀏覽項目 → 讀取，直接執行。
• 使用 --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：

• 訂單從列表中消失 → 告知使用者：取消完成，資金已退回資金帳戶。
• state: 3（取消中）→ 告知使用者：取消進行中，資金將很快退回資金帳戶。

---

全域注意事項

• 安全性： 絕不要求使用者在聊天中貼上 API 金鑰或密碼。
• 輸出： 一律對列表/查詢指令加上 --json，並將結果呈現為 Markdown 表格——絕不貼上原始終端機輸出。
• 網路錯誤： 若指令因連線錯誤失敗，提示使用者檢查 VPN：curl -I https://www.okx.com
• 語言： 一律以使用者的語言回應。

數字/時間格式與回應結構慣例，請參閱 {baseDir}/references/templates.md。