@okx_ai/okx-trade-cli 1.2.3 → 1.2.4-beta.1

package/dist/index.js

@@ -1284,7 +1284,8 @@ var BOT_SUB_MODULE_IDS = [
 var BOT_DEFAULT_SUB_MODULES = ["bot.grid"];
 var EARN_SUB_MODULE_IDS = [
   "earn.savings",
-  "earn.onchain"
+  "earn.onchain",
+  "earn.dcd"
 ];
 var MODULES = [
   "market",
@@ -2391,7 +2392,7 @@ function registerGridTools() {
           algoOrdType: {
             type: "string",
             enum: ["grid", "contract_grid", "moon_grid"],
-            description: "grid=Spot, contract_grid=Contract, moon_grid=Moon"
+            description: "Grid bot type. grid=Spot, contract_grid=Contract, moon_grid=Moon. Must match the bot's actual type when filtering by algoId."
           },
           status: {
             type: "string",
@@ -2403,7 +2404,8 @@ function registerGridTools() {
             description: "e.g. BTC-USDT"
           },
           algoId: {
-            type: "string"
+            type: "string",
+            description: "Grid bot algo order ID (returned by grid_create_order or grid_get_orders). This is NOT a normal trade order ID."
           },
           after: {
             type: "string",
@@ -2451,10 +2453,11 @@ function registerGridTools() {
           algoOrdType: {
             type: "string",
             enum: ["grid", "contract_grid", "moon_grid"],
-            description: "grid=Spot, contract_grid=Contract, moon_grid=Moon"
+            description: "Must match the bot's actual type (use the algoOrdType value returned by grid_get_orders). grid=Spot, contract_grid=Contract, moon_grid=Moon."
           },
           algoId: {
-            type: "string"
+            type: "string",
+            description: "Grid bot algo order ID (returned by grid_create_order or grid_get_orders). This is NOT a normal trade order ID."
           }
         },
         required: ["algoOrdType", "algoId"]
@@ -2483,10 +2486,11 @@ function registerGridTools() {
           algoOrdType: {
             type: "string",
             enum: ["grid", "contract_grid", "moon_grid"],
-            description: "grid=Spot, contract_grid=Contract, moon_grid=Moon"
+            description: "Must match the bot's actual type (use the algoOrdType value returned by grid_get_orders). grid=Spot, contract_grid=Contract, moon_grid=Moon."
           },
           algoId: {
-            type: "string"
+            type: "string",
+            description: "Grid bot algo order ID (returned by grid_create_order or grid_get_orders). This is NOT a normal trade order ID."
           },
           type: {
             type: "string",
@@ -2494,7 +2498,8 @@ function registerGridTools() {
             description: "filled=executed trades (default); live=pending orders"
           },
           groupId: {
-            type: "string"
+            type: "string",
+            description: "Group ID \u2014 a buy-sell pair shares the same groupId. Use to filter a specific grid level."
           },
           after: {
             type: "string",
@@ -2629,12 +2634,13 @@ function registerGridTools() {
         type: "object",
         properties: {
           algoId: {
-            type: "string"
+            type: "string",
+            description: "Grid bot algo order ID (returned by grid_create_order or grid_get_orders). This is NOT a normal trade order ID."
           },
           algoOrdType: {
             type: "string",
             enum: ["grid", "contract_grid", "moon_grid"],
-            description: "grid=Spot, contract_grid=Contract, moon_grid=Moon"
+            description: "Must match the bot's actual type (use the algoOrdType value returned by grid_get_orders). grid=Spot, contract_grid=Contract, moon_grid=Moon."
           },
           instId: {
             type: "string",
@@ -2766,7 +2772,10 @@ function registerDcaTools() {
       inputSchema: {
         type: "object",
         properties: {
-          algoId: { type: "string", description: "Algo order ID of the DCA bot to stop" }
+          algoId: {
+            type: "string",
+            description: "DCA bot algo order ID (returned by dca_create_order or dca_get_orders). This is NOT a normal trade order ID."
+          }
         },
         required: ["algoId"]
       },
@@ -2794,7 +2803,10 @@ function registerDcaTools() {
             enum: ["active", "history"],
             description: "active=running (default); history=stopped"
           },
-          algoId: { type: "string" },
+          algoId: {
+            type: "string",
+            description: "DCA bot algo order ID (returned by dca_create_order or dca_get_orders). This is NOT a normal trade order ID."
+          },
           instId: { type: "string", description: "Filter by instrument, e.g. BTC-USDT-SWAP (optional)" },
           after: { type: "string", description: "Pagination: before this algo ID" },
           before: { type: "string", description: "Pagination: after this algo ID" },
@@ -2829,7 +2841,10 @@ function registerDcaTools() {
       inputSchema: {
         type: "object",
         properties: {
-          algoId: { type: "string" }
+          algoId: {
+            type: "string",
+            description: "DCA bot algo order ID (returned by dca_create_order or dca_get_orders). This is NOT a normal trade order ID."
+          }
         },
         required: ["algoId"]
       },
@@ -2852,7 +2867,10 @@ function registerDcaTools() {
       inputSchema: {
         type: "object",
         properties: {
-          algoId: { type: "string", description: "Algo order ID of the DCA bot" },
+          algoId: {
+            type: "string",
+            description: "DCA bot algo order ID (returned by dca_create_order or dca_get_orders). This is NOT a normal trade order ID."
+          },
           cycleId: { type: "string", description: "Omit to list all cycles; provide to get orders within a cycle" },
           after: { type: "string", description: "Pagination cursor \u2014 applies to cycle-list mode only (when cycleId is omitted)" },
           before: { type: "string", description: "Pagination cursor \u2014 applies to cycle-list mode only (when cycleId is omitted)" },
@@ -3139,639 +3157,921 @@ function registerEarnTools() {
     }
   ];
 }
-var FUTURES_INST_TYPES = ["FUTURES", "SWAP"];
-function normalize5(response) {
-  return {
-    endpoint: response.endpoint,
-    requestTime: response.requestTime,
-    data: response.data
-  };
-}
-function registerFuturesTools() {
+function registerOnchainEarnTools() {
   return [
+    // -------------------------------------------------------------------------
+    // Get Offers
+    // -------------------------------------------------------------------------
     {
-      name: "futures_place_order",
-      module: "futures",
-      description: "Place a FUTURES delivery contract order (e.g. instId: BTC-USDT-240329). Optionally attach TP/SL via tpTriggerPx/slTriggerPx. [CAUTION] Executes real trades. Private endpoint. Rate limit: 60 req/s.",
-      isWrite: true,
+      name: "onchain_earn_get_offers",
+      module: "earn.onchain",
+      description: "Get available on-chain earn (staking/DeFi) offers. Returns investment products with APY, terms, and limits. Private endpoint. Rate limit: 3 req/s.",
+      isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
-          instId: {
-            type: "string",
-            description: "e.g. BTC-USDT-240329"
-          },
-          tdMode: {
-            type: "string",
-            enum: ["cross", "isolated"],
-            description: "cross|isolated margin"
-          },
-          side: {
-            type: "string",
-            enum: ["buy", "sell"],
-            description: "one-way: buy=open long, sell=open short (use reduceOnly=true to close); hedge: combined with posSide"
-          },
-          posSide: {
-            type: "string",
-            enum: ["long", "short", "net"],
-            description: "net=one-way mode (default); long/short=hedge mode only"
-          },
-          ordType: {
-            type: "string",
-            enum: ["market", "limit", "post_only", "fok", "ioc"],
-            description: "market(no px)|limit(px req)|post_only(maker)|fok(all-or-cancel)|ioc(partial fill)"
-          },
-          sz: {
-            type: "string",
-            description: "Number of contracts (NOT USDT amount). Use market_get_instruments to get ctVal for conversion."
-          },
-          px: {
-            type: "string",
-            description: "Required for limit/post_only/fok/ioc"
-          },
-          reduceOnly: {
-            type: "boolean",
-            description: "Close/reduce only, no new position (one-way mode)"
-          },
-          clOrdId: {
-            type: "string",
-            description: "Client order ID (max 32 chars)"
-          },
-          tpTriggerPx: {
-            type: "string",
-            description: "TP trigger price; places TP at tpOrdPx"
-          },
-          tpOrdPx: {
+          productId: {
             type: "string",
-            description: "TP order price; -1=market"
+            description: "Specific product ID to query. Omit for all offers."
           },
-          slTriggerPx: {
+          protocolType: {
             type: "string",
-            description: "SL trigger price; places SL at slOrdPx"
+            description: "Protocol type filter: staking, defi. Omit for all types."
           },
-          slOrdPx: {
+          ccy: {
             type: "string",
-            description: "SL order price; -1=market"
+            description: "Currency filter, e.g. ETH. Omit for all currencies."
           }
-        },
-        required: ["instId", "tdMode", "side", "ordType", "sz"]
+        }
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
-        const reduceOnly = args.reduceOnly;
-        const tpTriggerPx = readString(args, "tpTriggerPx");
-        const tpOrdPx = readString(args, "tpOrdPx");
-        const slTriggerPx = readString(args, "slTriggerPx");
-        const slOrdPx = readString(args, "slOrdPx");
-        const algoEntry = compactObject({ tpTriggerPx, tpOrdPx, slTriggerPx, slOrdPx });
-        const attachAlgoOrds = Object.keys(algoEntry).length > 0 ? [algoEntry] : void 0;
-        const response = await context.client.privatePost(
-          "/api/v5/trade/order",
+        const response = await context.client.privateGet(
+          "/api/v5/finance/staking-defi/offers",
           compactObject({
-            instId: requireString(args, "instId"),
-            tdMode: requireString(args, "tdMode"),
-            side: requireString(args, "side"),
-            posSide: readString(args, "posSide"),
-            ordType: requireString(args, "ordType"),
-            sz: requireString(args, "sz"),
-            px: readString(args, "px"),
-            reduceOnly: typeof reduceOnly === "boolean" ? String(reduceOnly) : void 0,
-            clOrdId: readString(args, "clOrdId"),
-            tag: context.config.sourceTag,
-            attachAlgoOrds
+            productId: readString(args, "productId"),
+            protocolType: readString(args, "protocolType"),
+            ccy: readString(args, "ccy")
           }),
-          privateRateLimit("futures_place_order", 60)
+          privateRateLimit("onchain_earn_get_offers", 3)
         );
-        return normalize5(response);
+        return normalizeResponse(response);
       }
     },
+    // -------------------------------------------------------------------------
+    // Purchase
+    // -------------------------------------------------------------------------
     {
-      name: "futures_cancel_order",
-      module: "futures",
-      description: "Cancel an unfilled FUTURES delivery order. Private endpoint. Rate limit: 60 req/s.",
+      name: "onchain_earn_purchase",
+      module: "earn.onchain",
+      description: "Purchase on-chain earn (staking/DeFi) product. [CAUTION] Moves real funds into staking/DeFi product. Not supported in demo/simulated trading mode. Private endpoint. Rate limit: 2 req/s.",
       isWrite: true,
       inputSchema: {
         type: "object",
         properties: {
-          instId: {
+          productId: {
             type: "string",
-            description: "e.g. BTC-USDT-240329"
+            description: "Product ID to purchase"
           },
-          ordId: {
-            type: "string"
+          investData: {
+            type: "array",
+            description: "Investment data array: [{ccy, amt}]. Each item specifies currency and amount.",
+            items: {
+              type: "object",
+              properties: {
+                ccy: { type: "string", description: "Currency, e.g. ETH" },
+                amt: { type: "string", description: "Amount to invest" }
+              },
+              required: ["ccy", "amt"]
+            }
           },
-          clOrdId: {
+          term: {
             type: "string",
-            description: "Client order ID"
+            description: "Investment term in days. Required for fixed-term products."
+          },
+          tag: {
+            type: "string",
+            description: "Order tag for tracking (optional)."
           }
         },
-        required: ["instId"]
+        required: ["productId", "investData"]
       },
       handler: async (rawArgs, context) => {
+        assertNotDemo(context.config, "onchain_earn_purchase");
         const args = asRecord(rawArgs);
         const response = await context.client.privatePost(
-          "/api/v5/trade/cancel-order",
+          "/api/v5/finance/staking-defi/purchase",
           compactObject({
-            instId: requireString(args, "instId"),
-            ordId: readString(args, "ordId"),
-            clOrdId: readString(args, "clOrdId")
+            productId: requireString(args, "productId"),
+            investData: args.investData,
+            term: readString(args, "term"),
+            tag: readString(args, "tag")
           }),
-          privateRateLimit("futures_cancel_order", 60)
+          privateRateLimit("onchain_earn_purchase", 2)
         );
-        return normalize5(response);
+        return normalizeResponse(response);
       }
     },
+    // -------------------------------------------------------------------------
+    // Redeem
+    // -------------------------------------------------------------------------
     {
-      name: "futures_get_order",
-      module: "futures",
-      description: "Get details of a single FUTURES delivery order by ordId or clOrdId. Private endpoint. Rate limit: 60 req/s.",
-      isWrite: false,
+      name: "onchain_earn_redeem",
+      module: "earn.onchain",
+      description: "Redeem on-chain earn (staking/DeFi) investment. [CAUTION] Withdraws funds from staking/DeFi product. Some products may have lock periods. Not supported in demo mode. Private endpoint. Rate limit: 2 req/s.",
+      isWrite: true,
       inputSchema: {
         type: "object",
         properties: {
-          instId: {
-            type: "string",
-            description: "e.g. BTC-USDT-240329"
-          },
           ordId: {
             type: "string",
-            description: "Provide ordId or clOrdId"
+            description: "Order ID to redeem"
           },
-          clOrdId: {
+          protocolType: {
             type: "string",
-            description: "Provide ordId or clOrdId"
+            description: "Protocol type: staking, defi"
+          },
+          allowEarlyRedeem: {
+            type: "boolean",
+            description: "Allow early redemption for fixed-term products (may incur penalties). Default false."
           }
         },
-        required: ["instId"]
+        required: ["ordId", "protocolType"]
       },
       handler: async (rawArgs, context) => {
+        assertNotDemo(context.config, "onchain_earn_redeem");
         const args = asRecord(rawArgs);
-        const response = await context.client.privateGet(
-          "/api/v5/trade/order",
+        const response = await context.client.privatePost(
+          "/api/v5/finance/staking-defi/redeem",
           compactObject({
-            instId: requireString(args, "instId"),
-            ordId: readString(args, "ordId"),
-            clOrdId: readString(args, "clOrdId")
+            ordId: requireString(args, "ordId"),
+            protocolType: requireString(args, "protocolType"),
+            allowEarlyRedeem: readBoolean(args, "allowEarlyRedeem")
           }),
-          privateRateLimit("futures_get_order", 60)
+          privateRateLimit("onchain_earn_redeem", 2)
         );
-        return normalize5(response);
+        return normalizeResponse(response);
       }
     },
+    // -------------------------------------------------------------------------
+    // Cancel
+    // -------------------------------------------------------------------------
     {
-      name: "futures_get_orders",
-      module: "futures",
-      description: "Query FUTURES open orders, history (last 7 days), or archive (up to 3 months). Private. Rate limit: 20 req/s.",
-      isWrite: false,
+      name: "onchain_earn_cancel",
+      module: "earn.onchain",
+      description: "Cancel pending on-chain earn purchase. [CAUTION] Cancels a pending investment order. Not supported in demo mode. Private endpoint. Rate limit: 2 req/s.",
+      isWrite: true,
       inputSchema: {
         type: "object",
         properties: {
-          status: {
+          ordId: {
             type: "string",
-            enum: ["open", "history", "archive"],
-            description: "open=active, history=7d, archive=3mo"
+            description: "Order ID to cancel"
           },
-          instType: {
+          protocolType: {
             type: "string",
-            enum: [...FUTURES_INST_TYPES],
-            description: "FUTURES (default) or SWAP"
+            description: "Protocol type: staking, defi"
+          }
+        },
+        required: ["ordId", "protocolType"]
+      },
+      handler: async (rawArgs, context) => {
+        assertNotDemo(context.config, "onchain_earn_cancel");
+        const args = asRecord(rawArgs);
+        const response = await context.client.privatePost(
+          "/api/v5/finance/staking-defi/cancel",
+          {
+            ordId: requireString(args, "ordId"),
+            protocolType: requireString(args, "protocolType")
           },
-          instId: {
-            type: "string",
-            description: "e.g. BTC-USDT-240329"
-          },
-          ordType: {
-            type: "string",
-            description: "Order type filter"
-          },
-          state: {
-            type: "string",
-            description: "canceled|filled"
-          },
-          after: {
-            type: "string",
-            description: "Pagination: before this order ID"
-          },
-          before: {
-            type: "string",
-            description: "Pagination: after this order ID"
-          },
-          begin: {
-            type: "string",
-            description: "Start time (ms)"
-          },
-          end: {
-            type: "string",
-            description: "End time (ms)"
-          },
-          limit: {
-            type: "number",
-            description: "Max results (default 100)"
-          }
-        }
-      },
-      handler: async (rawArgs, context) => {
-        const args = asRecord(rawArgs);
-        const status = readString(args, "status") ?? "open";
-        const instType = readString(args, "instType") ?? "FUTURES";
-        assertEnum(instType, "instType", FUTURES_INST_TYPES);
-        const path4 = status === "archive" ? "/api/v5/trade/orders-history-archive" : status === "history" ? "/api/v5/trade/orders-history" : "/api/v5/trade/orders-pending";
-        const response = await context.client.privateGet(
-          path4,
-          compactObject({
-            instType,
-            instId: readString(args, "instId"),
-            ordType: readString(args, "ordType"),
-            state: readString(args, "state"),
-            after: readString(args, "after"),
-            before: readString(args, "before"),
-            begin: readString(args, "begin"),
-            end: readString(args, "end"),
-            limit: readNumber(args, "limit")
-          }),
-          privateRateLimit("futures_get_orders", 20)
+          privateRateLimit("onchain_earn_cancel", 2)
         );
-        return normalize5(response);
+        return normalizeResponse(response);
       }
     },
+    // -------------------------------------------------------------------------
+    // Get Active Orders
+    // -------------------------------------------------------------------------
     {
-      name: "futures_get_positions",
-      module: "futures",
-      description: "Get current FUTURES delivery contract positions. Private endpoint. Rate limit: 10 req/s.",
+      name: "onchain_earn_get_active_orders",
+      module: "earn.onchain",
+      description: "Get active on-chain earn orders. Returns current staking/DeFi investments. Private endpoint. Rate limit: 3 req/s.",
       isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
-          instType: {
+          productId: {
             type: "string",
-            enum: [...FUTURES_INST_TYPES],
-            description: "FUTURES (default) or SWAP"
+            description: "Filter by product ID. Omit for all."
           },
-          instId: {
+          protocolType: {
             type: "string",
-            description: "e.g. BTC-USDT-240329"
+            description: "Filter by protocol type: staking, defi. Omit for all."
           },
-          posId: {
-            type: "string"
+          ccy: {
+            type: "string",
+            description: "Filter by currency, e.g. ETH. Omit for all."
+          },
+          state: {
+            type: "string",
+            description: "Filter by state: 8 (pending), 13 (cancelling), 9 (onchain), 1 (earning), 2 (redeeming). Omit for all."
           }
         }
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
-        const instType = readString(args, "instType") ?? "FUTURES";
-        assertEnum(instType, "instType", FUTURES_INST_TYPES);
         const response = await context.client.privateGet(
-          "/api/v5/account/positions",
+          "/api/v5/finance/staking-defi/orders-active",
           compactObject({
-            instType,
-            instId: readString(args, "instId"),
-            posId: readString(args, "posId")
+            productId: readString(args, "productId"),
+            protocolType: readString(args, "protocolType"),
+            ccy: readString(args, "ccy"),
+            state: readString(args, "state")
           }),
-          privateRateLimit("futures_get_positions", 10)
+          privateRateLimit("onchain_earn_get_active_orders", 3)
         );
-        return normalize5(response);
+        return normalizeResponse(response);
       }
     },
+    // -------------------------------------------------------------------------
+    // Get Order History
+    // -------------------------------------------------------------------------
     {
-      name: "futures_get_fills",
-      module: "futures",
-      description: "Get FUTURES fill details. archive=false: last 3 days. archive=true: up to 3 months. Private. Rate limit: 20 req/s.",
+      name: "onchain_earn_get_order_history",
+      module: "earn.onchain",
+      description: "Get on-chain earn order history. Returns past staking/DeFi investments including redeemed orders. Private endpoint. Rate limit: 3 req/s.",
       isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
-          archive: {
-            type: "boolean",
-            description: "true=up to 3 months; false=last 3 days (default)"
-          },
-          instType: {
+          productId: {
             type: "string",
-            enum: [...FUTURES_INST_TYPES],
-            description: "FUTURES (default) or SWAP"
+            description: "Filter by product ID. Omit for all."
           },
-          instId: {
+          protocolType: {
             type: "string",
-            description: "Instrument ID filter"
+            description: "Filter by protocol type: staking, defi. Omit for all."
           },
-          ordId: {
+          ccy: {
             type: "string",
-            description: "Order ID filter"
+            description: "Filter by currency, e.g. ETH. Omit for all."
           },
           after: {
             type: "string",
-            description: "Pagination: before this bill ID"
+            description: "Pagination: return results before this order ID"
           },
           before: {
             type: "string",
-            description: "Pagination: after this bill ID"
-          },
-          begin: {
-            type: "string",
-            description: "Start time (ms)"
-          },
-          end: {
-            type: "string",
-            description: "End time (ms)"
+            description: "Pagination: return results after this order ID"
           },
           limit: {
-            type: "number",
-            description: "Max results (default 100 or 20 for archive)"
+            type: "string",
+            description: "Max results to return (default 100, max 100)"
           }
         }
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
-        const archive = readBoolean(args, "archive") ?? false;
-        const instType = readString(args, "instType") ?? "FUTURES";
-        assertEnum(instType, "instType", FUTURES_INST_TYPES);
-        const path4 = archive ? "/api/v5/trade/fills-history" : "/api/v5/trade/fills";
         const response = await context.client.privateGet(
-          path4,
+          "/api/v5/finance/staking-defi/orders-history",
           compactObject({
-            instType,
-            instId: readString(args, "instId"),
-            ordId: readString(args, "ordId"),
+            productId: readString(args, "productId"),
+            protocolType: readString(args, "protocolType"),
+            ccy: readString(args, "ccy"),
             after: readString(args, "after"),
             before: readString(args, "before"),
-            begin: readString(args, "begin"),
-            end: readString(args, "end"),
-            limit: readNumber(args, "limit") ?? (archive ? 20 : void 0)
+            limit: readString(args, "limit")
           }),
-          privateRateLimit("futures_get_fills", 20)
+          privateRateLimit("onchain_earn_get_order_history", 3)
         );
-        return normalize5(response);
+        return normalizeResponse(response);
       }
     }
   ];
 }
-function registerOnchainEarnTools() {
+var DCD_CODE_BEHAVIORS = {
+  "50001": { retry: true, suggestion: "DCD service is down. Retry in a few minutes." },
+  "50002": { retry: false, suggestion: "Invalid JSON in request body. This is likely a bug \u2014 check request parameters." },
+  "50014": { retry: false, suggestion: "Missing required parameter. Check that all required fields are provided." },
+  "50016": { retry: false, suggestion: "notionalCcy does not match productId option type. Use baseCcy for CALL, quoteCcy for PUT." },
+  "50026": { retry: true, suggestion: "DCD system error. Retry in a few minutes." },
+  "50030": { retry: false, suggestion: "Account not authorized for DCD (earn-auth check failed). Complete required verification in the OKX app first." },
+  "50038": { retry: false, suggestion: "DCD Open API feature is disabled for this account. Contact OKX support to enable it." },
+  "50051": { retry: false, suggestion: "This currency pair is restricted for your country or account type. Do not retry." },
+  "51000": { retry: false, suggestion: "Invalid parameter value or format. Check ordId, quoteId, or clOrdId." },
+  "51728": { retry: false, suggestion: "Available quota exceeded. Reduce the amount and retry." },
+  "51736": { retry: false, suggestion: "Insufficient balance. Top up your account before retrying." },
+  "52905": { retry: false, suggestion: "Quote has expired or was not found. Request a new quote." },
+  "52909": { retry: false, suggestion: "Duplicate client order ID. Use a different clOrdId." },
+  "52917": { retry: false, suggestion: "Amount is below the minimum trade size. Increase the amount." },
+  "52918": { retry: false, suggestion: "Amount exceeds the maximum trade size. Reduce the amount." },
+  "52921": { retry: false, suggestion: "Quote has already been used by another trade." },
+  "52927": { retry: true, suggestion: "No quote returned by liquidity provider. Retry the quote request." },
+  "52928": { retry: false, suggestion: "Amount is not divisible by the required step size. Adjust the amount." },
+  "58004": { retry: false, suggestion: "Account is frozen or blocked. Contact OKX support. Do not retry." },
+  "58102": { retry: true, suggestion: "DCD rate limit exceeded. Back off and retry after a short delay." }
+};
+async function withDcdErrors(fn) {
+  try {
+    return await fn();
+  } catch (error) {
+    if (error instanceof OkxApiError && error.code) {
+      const behavior = DCD_CODE_BEHAVIORS[error.code];
+      if (behavior) {
+        if (behavior.retry) {
+          throw new RateLimitError(error.message, behavior.suggestion, error.endpoint, error.traceId);
+        }
+        throw new OkxApiError(error.message, {
+          code: error.code,
+          suggestion: behavior.suggestion,
+          endpoint: error.endpoint,
+          traceId: error.traceId
+        });
+      }
+    }
+    throw error;
+  }
+}
+function registerDcdTools() {
   return [
-    // -------------------------------------------------------------------------
-    // Get Offers
-    // -------------------------------------------------------------------------
     {
-      name: "onchain_earn_get_offers",
-      module: "earn.onchain",
-      description: "Get available on-chain earn (staking/DeFi) offers. Returns investment products with APY, terms, and limits. Private endpoint. Rate limit: 3 req/s.",
+      name: "dcd_get_currency_pairs",
+      module: "earn.dcd",
+      description: "Get available DCD (Dual Currency Deposit) currency pairs. Private endpoint. Rate limit: 5 req/s.",
+      isWrite: false,
+      inputSchema: { type: "object", properties: {} },
+      handler: async (_rawArgs, context) => {
+        return withDcdErrors(async () => {
+          const response = await context.client.privateGet(
+            "/api/v5/finance/sfp/dcd/currency-pair",
+            void 0,
+            privateRateLimit("dcd_get_currency_pairs", 5)
+          );
+          return normalizeResponse(response);
+        });
+      }
+    },
+    {
+      name: "dcd_get_products",
+      module: "earn.dcd",
+      description: "Get active DCD products with yield, trade size, quota, and VIP yield tier information. baseCcy, quoteCcy, and optType are all required. Private endpoint. Rate limit: 5 req/s.",
       isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
-          productId: {
+          baseCcy: { type: "string", description: "Base currency, e.g. BTC" },
+          quoteCcy: { type: "string", description: "Quote currency, e.g. USDT" },
+          optType: { type: "string", description: "Option type: C (Call/\u9AD8\u5356) or P (Put/\u4F4E\u4E70)" }
+        },
+        required: ["baseCcy", "quoteCcy", "optType"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        return withDcdErrors(async () => {
+          const response = await context.client.privateGet(
+            "/api/v5/finance/sfp/dcd/products",
+            {
+              baseCcy: requireString(args, "baseCcy"),
+              quoteCcy: requireString(args, "quoteCcy"),
+              optType: requireString(args, "optType")
+            },
+            privateRateLimit("dcd_get_products", 5)
+          );
+          return normalizeResponse(response);
+        });
+      }
+    },
+    {
+      name: "dcd_request_quote",
+      module: "earn.dcd",
+      description: "Request a real-time quote for a DCD product. Check validUntil for expiry time \u2014 execute before expiry. Yield reflects the user's actual VIP tier rate. Private endpoint. Rate limit: 5 req/s.",
+      isWrite: false,
+      // POST for payload, no state change
+      inputSchema: {
+        type: "object",
+        properties: {
+          productId: { type: "string", description: "Product ID, e.g. BTC-USDT-260327-77000-C" },
+          notionalSz: { type: "string", description: "Investment amount" },
+          notionalCcy: { type: "string", description: "Investment currency: baseCcy for CALL (C), quoteCcy for PUT (P)" }
+        },
+        required: ["productId", "notionalSz", "notionalCcy"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        return withDcdErrors(async () => {
+          const response = await context.client.privatePost(
+            "/api/v5/finance/sfp/dcd/quote",
+            {
+              productId: requireString(args, "productId"),
+              notionalSz: requireString(args, "notionalSz"),
+              notionalCcy: requireString(args, "notionalCcy")
+            },
+            privateRateLimit("dcd_request_quote", 5)
+          );
+          return normalizeResponse(response);
+        });
+      }
+    },
+    {
+      name: "dcd_execute_quote",
+      module: "earn.dcd",
+      description: "Execute a DCD quote to place a trade. [CAUTION] Moves real funds into DCD product. Quote expires \u2014 call immediately after dcd_request_quote. Not supported in demo/simulated trading mode. Private endpoint. Rate limit: 5 req/s.",
+      isWrite: true,
+      inputSchema: {
+        type: "object",
+        properties: {
+          quoteId: { type: "string", description: "Quote ID from dcd_request_quote" },
+          clOrdId: { type: "string", description: "Client order ID for idempotency (optional)" }
+        },
+        required: ["quoteId"]
+      },
+      handler: async (rawArgs, context) => {
+        assertNotDemo(context.config, "dcd_execute_quote");
+        const args = asRecord(rawArgs);
+        return withDcdErrors(async () => {
+          const response = await context.client.privatePost(
+            "/api/v5/finance/sfp/dcd/trade",
+            compactObject({
+              quoteId: requireString(args, "quoteId"),
+              clOrdId: readString(args, "clOrdId")
+            }),
+            privateRateLimit("dcd_execute_quote", 5)
+          );
+          return normalizeResponse(response);
+        });
+      }
+    },
+    {
+      name: "dcd_request_redeem_quote",
+      module: "earn.dcd",
+      description: "Request an early redemption quote for a live DCD order. Check validUntil for expiry. Private endpoint. Rate limit: 5 req/s.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          ordId: { type: "string", description: "Order ID to redeem early" }
+        },
+        required: ["ordId"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        return withDcdErrors(async () => {
+          const response = await context.client.privatePost(
+            "/api/v5/finance/sfp/dcd/redeem-quote",
+            { ordId: requireString(args, "ordId") },
+            privateRateLimit("dcd_request_redeem_quote", 5)
+          );
+          return normalizeResponse(response);
+        });
+      }
+    },
+    {
+      name: "dcd_execute_redeem",
+      module: "earn.dcd",
+      description: "Execute an early redemption using a valid redeem quote. [CAUTION] Initiates early redemption of a DCD position. Not supported in demo/simulated trading mode. Private endpoint. Rate limit: 5 req/s.",
+      isWrite: true,
+      inputSchema: {
+        type: "object",
+        properties: {
+          ordId: { type: "string", description: "Order ID" },
+          quoteId: { type: "string", description: "Redeem quote ID from dcd_request_redeem_quote" }
+        },
+        required: ["ordId", "quoteId"]
+      },
+      handler: async (rawArgs, context) => {
+        assertNotDemo(context.config, "dcd_execute_redeem");
+        const args = asRecord(rawArgs);
+        return withDcdErrors(async () => {
+          const response = await context.client.privatePost(
+            "/api/v5/finance/sfp/dcd/redeem",
+            {
+              ordId: requireString(args, "ordId"),
+              quoteId: requireString(args, "quoteId")
+            },
+            privateRateLimit("dcd_execute_redeem", 5)
+          );
+          return normalizeResponse(response);
+        });
+      }
+    },
+    {
+      name: "dcd_get_order_state",
+      module: "earn.dcd",
+      description: "Query DCD order state by order ID. Private endpoint. Rate limit: 5 req/s.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          ordId: { type: "string", description: "Order ID" }
+        },
+        required: ["ordId"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        return withDcdErrors(async () => {
+          const response = await context.client.privateGet(
+            "/api/v5/finance/sfp/dcd/order-status",
+            { ordId: requireString(args, "ordId") },
+            privateRateLimit("dcd_get_order_state", 5)
+          );
+          return normalizeResponse(response);
+        });
+      }
+    },
+    {
+      name: "dcd_get_orders",
+      module: "earn.dcd",
+      description: "Get DCD order history with optional filters. Returns up to 100 records per request. Private endpoint. Rate limit: 5 req/s.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          ordId: { type: "string", description: "Filter by specific order ID (ignores other filters when provided)" },
+          productId: { type: "string", description: "Filter by product ID, e.g. BTC-USDT-260327-77000-C" },
+          uly: { type: "string", description: "Filter by underlying index, e.g. BTC-USD" },
+          state: {
             type: "string",
-            description: "Specific product ID to query. Omit for all offers."
+            description: "Filter by state: initial | live | pending_settle | settled | pending_redeem | redeemed | rejected"
           },
-          protocolType: {
+          beginId: { type: "string", description: "Return records newer than this order ID (pagination)" },
+          endId: { type: "string", description: "Return records older than this order ID (pagination)" },
+          begin: { type: "string", description: "Begin timestamp filter, Unix ms" },
+          end: { type: "string", description: "End timestamp filter, Unix ms" },
+          limit: { type: "number", description: "Results per request, max 100 (default 100)" }
+        }
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        return withDcdErrors(async () => {
+          const response = await context.client.privateGet(
+            "/api/v5/finance/sfp/dcd/order-history",
+            compactObject({
+              ordId: readString(args, "ordId"),
+              productId: readString(args, "productId"),
+              uly: readString(args, "uly"),
+              state: readString(args, "state"),
+              beginId: readString(args, "beginId"),
+              endId: readString(args, "endId"),
+              begin: readString(args, "begin"),
+              end: readString(args, "end"),
+              limit: readNumber(args, "limit")
+            }),
+            privateRateLimit("dcd_get_orders", 5)
+          );
+          return normalizeResponse(response);
+        });
+      }
+    }
+  ];
+}
+function registerAllEarnTools() {
+  return [
+    ...registerEarnTools(),
+    ...registerOnchainEarnTools(),
+    ...registerDcdTools()
+  ];
+}
+var FUTURES_INST_TYPES = ["FUTURES", "SWAP"];
+function normalize5(response) {
+  return {
+    endpoint: response.endpoint,
+    requestTime: response.requestTime,
+    data: response.data
+  };
+}
+function registerFuturesTools() {
+  return [
+    {
+      name: "futures_place_order",
+      module: "futures",
+      description: "Place a FUTURES delivery contract order (e.g. instId: BTC-USDT-240329). Optionally attach TP/SL via tpTriggerPx/slTriggerPx. [CAUTION] Executes real trades. Private endpoint. Rate limit: 60 req/s.",
+      isWrite: true,
+      inputSchema: {
+        type: "object",
+        properties: {
+          instId: {
             type: "string",
-            description: "Protocol type filter: staking, defi. Omit for all types."
+            description: "e.g. BTC-USDT-240329"
           },
-          ccy: {
+          tdMode: {
             type: "string",
-            description: "Currency filter, e.g. ETH. Omit for all currencies."
+            enum: ["cross", "isolated"],
+            description: "cross|isolated margin"
+          },
+          side: {
+            type: "string",
+            enum: ["buy", "sell"],
+            description: "one-way: buy=open long, sell=open short (use reduceOnly=true to close); hedge: combined with posSide"
+          },
+          posSide: {
+            type: "string",
+            enum: ["long", "short", "net"],
+            description: "net=one-way mode (default); long/short=hedge mode only"
+          },
+          ordType: {
+            type: "string",
+            enum: ["market", "limit", "post_only", "fok", "ioc"],
+            description: "market(no px)|limit(px req)|post_only(maker)|fok(all-or-cancel)|ioc(partial fill)"
+          },
+          sz: {
+            type: "string",
+            description: "Number of contracts (NOT USDT amount). Use market_get_instruments to get ctVal for conversion."
+          },
+          px: {
+            type: "string",
+            description: "Required for limit/post_only/fok/ioc"
+          },
+          reduceOnly: {
+            type: "boolean",
+            description: "Close/reduce only, no new position (one-way mode)"
+          },
+          clOrdId: {
+            type: "string",
+            description: "Client order ID (max 32 chars)"
+          },
+          tpTriggerPx: {
+            type: "string",
+            description: "TP trigger price; places TP at tpOrdPx"
+          },
+          tpOrdPx: {
+            type: "string",
+            description: "TP order price; -1=market"
+          },
+          slTriggerPx: {
+            type: "string",
+            description: "SL trigger price; places SL at slOrdPx"
+          },
+          slOrdPx: {
+            type: "string",
+            description: "SL order price; -1=market"
           }
-        }
+        },
+        required: ["instId", "tdMode", "side", "ordType", "sz"]
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
-        const response = await context.client.privateGet(
-          "/api/v5/finance/staking-defi/offers",
+        const reduceOnly = args.reduceOnly;
+        const tpTriggerPx = readString(args, "tpTriggerPx");
+        const tpOrdPx = readString(args, "tpOrdPx");
+        const slTriggerPx = readString(args, "slTriggerPx");
+        const slOrdPx = readString(args, "slOrdPx");
+        const algoEntry = compactObject({ tpTriggerPx, tpOrdPx, slTriggerPx, slOrdPx });
+        const attachAlgoOrds = Object.keys(algoEntry).length > 0 ? [algoEntry] : void 0;
+        const response = await context.client.privatePost(
+          "/api/v5/trade/order",
           compactObject({
-            productId: readString(args, "productId"),
-            protocolType: readString(args, "protocolType"),
-            ccy: readString(args, "ccy")
+            instId: requireString(args, "instId"),
+            tdMode: requireString(args, "tdMode"),
+            side: requireString(args, "side"),
+            posSide: readString(args, "posSide"),
+            ordType: requireString(args, "ordType"),
+            sz: requireString(args, "sz"),
+            px: readString(args, "px"),
+            reduceOnly: typeof reduceOnly === "boolean" ? String(reduceOnly) : void 0,
+            clOrdId: readString(args, "clOrdId"),
+            tag: context.config.sourceTag,
+            attachAlgoOrds
           }),
-          privateRateLimit("onchain_earn_get_offers", 3)
+          privateRateLimit("futures_place_order", 60)
         );
-        return normalizeResponse(response);
+        return normalize5(response);
       }
     },
-    // -------------------------------------------------------------------------
-    // Purchase
-    // -------------------------------------------------------------------------
     {
-      name: "onchain_earn_purchase",
-      module: "earn.onchain",
-      description: "Purchase on-chain earn (staking/DeFi) product. [CAUTION] Moves real funds into staking/DeFi product. Not supported in demo/simulated trading mode. Private endpoint. Rate limit: 2 req/s.",
+      name: "futures_cancel_order",
+      module: "futures",
+      description: "Cancel an unfilled FUTURES delivery order. Private endpoint. Rate limit: 60 req/s.",
       isWrite: true,
       inputSchema: {
         type: "object",
         properties: {
-          productId: {
+          instId: {
             type: "string",
-            description: "Product ID to purchase"
-          },
-          investData: {
-            type: "array",
-            description: "Investment data array: [{ccy, amt}]. Each item specifies currency and amount.",
-            items: {
-              type: "object",
-              properties: {
-                ccy: { type: "string", description: "Currency, e.g. ETH" },
-                amt: { type: "string", description: "Amount to invest" }
-              },
-              required: ["ccy", "amt"]
-            }
+            description: "e.g. BTC-USDT-240329"
           },
-          term: {
-            type: "string",
-            description: "Investment term in days. Required for fixed-term products."
+          ordId: {
+            type: "string"
           },
-          tag: {
+          clOrdId: {
             type: "string",
-            description: "Order tag for tracking (optional)."
+            description: "Client order ID"
           }
         },
-        required: ["productId", "investData"]
+        required: ["instId"]
       },
       handler: async (rawArgs, context) => {
-        assertNotDemo(context.config, "onchain_earn_purchase");
         const args = asRecord(rawArgs);
         const response = await context.client.privatePost(
-          "/api/v5/finance/staking-defi/purchase",
+          "/api/v5/trade/cancel-order",
           compactObject({
-            productId: requireString(args, "productId"),
-            investData: args.investData,
-            term: readString(args, "term"),
-            tag: readString(args, "tag")
+            instId: requireString(args, "instId"),
+            ordId: readString(args, "ordId"),
+            clOrdId: readString(args, "clOrdId")
           }),
-          privateRateLimit("onchain_earn_purchase", 2)
+          privateRateLimit("futures_cancel_order", 60)
         );
-        return normalizeResponse(response);
+        return normalize5(response);
       }
     },
-    // -------------------------------------------------------------------------
-    // Redeem
-    // -------------------------------------------------------------------------
     {
-      name: "onchain_earn_redeem",
-      module: "earn.onchain",
-      description: "Redeem on-chain earn (staking/DeFi) investment. [CAUTION] Withdraws funds from staking/DeFi product. Some products may have lock periods. Not supported in demo mode. Private endpoint. Rate limit: 2 req/s.",
-      isWrite: true,
+      name: "futures_get_order",
+      module: "futures",
+      description: "Get details of a single FUTURES delivery order by ordId or clOrdId. Private endpoint. Rate limit: 60 req/s.",
+      isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
-          ordId: {
+          instId: {
             type: "string",
-            description: "Order ID to redeem"
+            description: "e.g. BTC-USDT-240329"
           },
-          protocolType: {
+          ordId: {
             type: "string",
-            description: "Protocol type: staking, defi"
+            description: "Provide ordId or clOrdId"
           },
-          allowEarlyRedeem: {
-            type: "boolean",
-            description: "Allow early redemption for fixed-term products (may incur penalties). Default false."
+          clOrdId: {
+            type: "string",
+            description: "Provide ordId or clOrdId"
           }
         },
-        required: ["ordId", "protocolType"]
+        required: ["instId"]
       },
       handler: async (rawArgs, context) => {
-        assertNotDemo(context.config, "onchain_earn_redeem");
         const args = asRecord(rawArgs);
-        const response = await context.client.privatePost(
-          "/api/v5/finance/staking-defi/redeem",
+        const response = await context.client.privateGet(
+          "/api/v5/trade/order",
           compactObject({
-            ordId: requireString(args, "ordId"),
-            protocolType: requireString(args, "protocolType"),
-            allowEarlyRedeem: readBoolean(args, "allowEarlyRedeem")
+            instId: requireString(args, "instId"),
+            ordId: readString(args, "ordId"),
+            clOrdId: readString(args, "clOrdId")
           }),
-          privateRateLimit("onchain_earn_redeem", 2)
+          privateRateLimit("futures_get_order", 60)
         );
-        return normalizeResponse(response);
+        return normalize5(response);
       }
     },
-    // -------------------------------------------------------------------------
-    // Cancel
-    // -------------------------------------------------------------------------
     {
-      name: "onchain_earn_cancel",
-      module: "earn.onchain",
-      description: "Cancel pending on-chain earn purchase. [CAUTION] Cancels a pending investment order. Not supported in demo mode. Private endpoint. Rate limit: 2 req/s.",
-      isWrite: true,
+      name: "futures_get_orders",
+      module: "futures",
+      description: "Query FUTURES open orders, history (last 7 days), or archive (up to 3 months). Private. Rate limit: 20 req/s.",
+      isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
-          ordId: {
+          status: {
             type: "string",
-            description: "Order ID to cancel"
+            enum: ["open", "history", "archive"],
+            description: "open=active, history=7d, archive=3mo"
           },
-          protocolType: {
+          instType: {
             type: "string",
-            description: "Protocol type: staking, defi"
+            enum: [...FUTURES_INST_TYPES],
+            description: "FUTURES (default) or SWAP"
+          },
+          instId: {
+            type: "string",
+            description: "e.g. BTC-USDT-240329"
+          },
+          ordType: {
+            type: "string",
+            description: "Order type filter"
+          },
+          state: {
+            type: "string",
+            description: "canceled|filled"
+          },
+          after: {
+            type: "string",
+            description: "Pagination: before this order ID"
+          },
+          before: {
+            type: "string",
+            description: "Pagination: after this order ID"
+          },
+          begin: {
+            type: "string",
+            description: "Start time (ms)"
+          },
+          end: {
+            type: "string",
+            description: "End time (ms)"
+          },
+          limit: {
+            type: "number",
+            description: "Max results (default 100)"
           }
-        },
-        required: ["ordId", "protocolType"]
+        }
       },
       handler: async (rawArgs, context) => {
-        assertNotDemo(context.config, "onchain_earn_cancel");
         const args = asRecord(rawArgs);
-        const response = await context.client.privatePost(
-          "/api/v5/finance/staking-defi/cancel",
-          {
-            ordId: requireString(args, "ordId"),
-            protocolType: requireString(args, "protocolType")
-          },
-          privateRateLimit("onchain_earn_cancel", 2)
+        const status = readString(args, "status") ?? "open";
+        const instType = readString(args, "instType") ?? "FUTURES";
+        assertEnum(instType, "instType", FUTURES_INST_TYPES);
+        const path4 = status === "archive" ? "/api/v5/trade/orders-history-archive" : status === "history" ? "/api/v5/trade/orders-history" : "/api/v5/trade/orders-pending";
+        const response = await context.client.privateGet(
+          path4,
+          compactObject({
+            instType,
+            instId: readString(args, "instId"),
+            ordType: readString(args, "ordType"),
+            state: readString(args, "state"),
+            after: readString(args, "after"),
+            before: readString(args, "before"),
+            begin: readString(args, "begin"),
+            end: readString(args, "end"),
+            limit: readNumber(args, "limit")
+          }),
+          privateRateLimit("futures_get_orders", 20)
         );
-        return normalizeResponse(response);
+        return normalize5(response);
       }
     },
-    // -------------------------------------------------------------------------
-    // Get Active Orders
-    // -------------------------------------------------------------------------
     {
-      name: "onchain_earn_get_active_orders",
-      module: "earn.onchain",
-      description: "Get active on-chain earn orders. Returns current staking/DeFi investments. Private endpoint. Rate limit: 3 req/s.",
+      name: "futures_get_positions",
+      module: "futures",
+      description: "Get current FUTURES delivery contract positions. Private endpoint. Rate limit: 10 req/s.",
       isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
-          productId: {
-            type: "string",
-            description: "Filter by product ID. Omit for all."
-          },
-          protocolType: {
+          instType: {
             type: "string",
-            description: "Filter by protocol type: staking, defi. Omit for all."
+            enum: [...FUTURES_INST_TYPES],
+            description: "FUTURES (default) or SWAP"
           },
-          ccy: {
+          instId: {
             type: "string",
-            description: "Filter by currency, e.g. ETH. Omit for all."
+            description: "e.g. BTC-USDT-240329"
           },
-          state: {
-            type: "string",
-            description: "Filter by state: 8 (pending), 13 (cancelling), 9 (onchain), 1 (earning), 2 (redeeming). Omit for all."
+          posId: {
+            type: "string"
           }
         }
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
+        const instType = readString(args, "instType") ?? "FUTURES";
+        assertEnum(instType, "instType", FUTURES_INST_TYPES);
         const response = await context.client.privateGet(
-          "/api/v5/finance/staking-defi/orders-active",
+          "/api/v5/account/positions",
           compactObject({
-            productId: readString(args, "productId"),
-            protocolType: readString(args, "protocolType"),
-            ccy: readString(args, "ccy"),
-            state: readString(args, "state")
+            instType,
+            instId: readString(args, "instId"),
+            posId: readString(args, "posId")
           }),
-          privateRateLimit("onchain_earn_get_active_orders", 3)
+          privateRateLimit("futures_get_positions", 10)
         );
-        return normalizeResponse(response);
+        return normalize5(response);
       }
     },
-    // -------------------------------------------------------------------------
-    // Get Order History
-    // -------------------------------------------------------------------------
     {
-      name: "onchain_earn_get_order_history",
-      module: "earn.onchain",
-      description: "Get on-chain earn order history. Returns past staking/DeFi investments including redeemed orders. Private endpoint. Rate limit: 3 req/s.",
+      name: "futures_get_fills",
+      module: "futures",
+      description: "Get FUTURES fill details. archive=false: last 3 days. archive=true: up to 3 months. Private. Rate limit: 20 req/s.",
       isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
-          productId: {
+          archive: {
+            type: "boolean",
+            description: "true=up to 3 months; false=last 3 days (default)"
+          },
+          instType: {
             type: "string",
-            description: "Filter by product ID. Omit for all."
+            enum: [...FUTURES_INST_TYPES],
+            description: "FUTURES (default) or SWAP"
           },
-          protocolType: {
+          instId: {
             type: "string",
-            description: "Filter by protocol type: staking, defi. Omit for all."
+            description: "Instrument ID filter"
           },
-          ccy: {
+          ordId: {
             type: "string",
-            description: "Filter by currency, e.g. ETH. Omit for all."
+            description: "Order ID filter"
+          },
+          after: {
+            type: "string",
+            description: "Pagination: before this bill ID"
+          },
+          before: {
+            type: "string",
+            description: "Pagination: after this bill ID"
           },
-          after: {
+          begin: {
             type: "string",
-            description: "Pagination: return results before this order ID"
+            description: "Start time (ms)"
           },
-          before: {
+          end: {
             type: "string",
-            description: "Pagination: return results after this order ID"
+            description: "End time (ms)"
           },
           limit: {
-            type: "string",
-            description: "Max results to return (default 100, max 100)"
+            type: "number",
+            description: "Max results (default 100 or 20 for archive)"
           }
         }
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
+        const archive = readBoolean(args, "archive") ?? false;
+        const instType = readString(args, "instType") ?? "FUTURES";
+        assertEnum(instType, "instType", FUTURES_INST_TYPES);
+        const path4 = archive ? "/api/v5/trade/fills-history" : "/api/v5/trade/fills";
         const response = await context.client.privateGet(
-          "/api/v5/finance/staking-defi/orders-history",
+          path4,
           compactObject({
-            productId: readString(args, "productId"),
-            protocolType: readString(args, "protocolType"),
-            ccy: readString(args, "ccy"),
+            instType,
+            instId: readString(args, "instId"),
+            ordId: readString(args, "ordId"),
             after: readString(args, "after"),
             before: readString(args, "before"),
-            limit: readString(args, "limit")
+            begin: readString(args, "begin"),
+            end: readString(args, "end"),
+            limit: readNumber(args, "limit") ?? (archive ? 20 : void 0)
           }),
-          privateRateLimit("onchain_earn_get_order_history", 3)
+          privateRateLimit("futures_get_fills", 20)
         );
-        return normalizeResponse(response);
+        return normalize5(response);
       }
     }
   ];
@@ -4253,6 +4553,40 @@ function registerMarketTools() {
         );
         return normalize6(response);
       }
+    },
+    {
+      name: "market_get_stock_tokens",
+      module: "market",
+      description: "Get all stock token instruments (instCategory=3). Stock tokens track real-world stock prices on OKX (e.g. AAPL-USDT-SWAP, TSLA-USDT-SWAP). Fetches all instruments of the given type and filters client-side by instCategory=3. Public endpoint. Rate limit: 20 req/s.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          instType: {
+            type: "string",
+            enum: ["SPOT", "SWAP"],
+            description: "Instrument type. Default: SWAP"
+          },
+          instId: {
+            type: "string",
+            description: "Optional: filter by specific instrument ID, e.g. AAPL-USDT-SWAP"
+          }
+        },
+        required: []
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const instType = readString(args, "instType") ?? "SWAP";
+        const instId = readString(args, "instId");
+        const response = await context.client.publicGet(
+          "/api/v5/public/instruments",
+          compactObject({ instType, instId }),
+          publicRateLimit("market_get_stock_tokens", 20)
+        );
+        const data = response.data;
+        const filtered = Array.isArray(data) ? data.filter((item) => item.instCategory === "3") : data;
+        return normalize6({ ...response, data: filtered });
+      }
     }
   ];
 }
@@ -4772,17 +5106,20 @@ function registerSpotTradeTools() {
             description: "e.g. BTC-USDT"
           },
           ordId: {
-            type: "string"
+            type: "string",
+            description: "Order ID"
           },
           clOrdId: {
             type: "string",
             description: "Client order ID"
           },
           newSz: {
-            type: "string"
+            type: "string",
+            description: "New order size in base currency (e.g. BTC amount)"
           },
           newPx: {
-            type: "string"
+            type: "string",
+            description: "New order price"
           },
           newClOrdId: {
             type: "string",
@@ -4957,7 +5294,7 @@ function registerSpotTradeTools() {
         properties: {
           instId: { type: "string", description: "e.g. BTC-USDT" },
           algoId: { type: "string", description: "Algo order ID" },
-          newSz: { type: "string" },
+          newSz: { type: "string", description: "New order size in base currency (e.g. BTC amount)" },
           newTpTriggerPx: { type: "string", description: "New TP trigger price" },
           newTpOrdPx: { type: "string", description: "New TP order price; -1=market" },
           newSlTriggerPx: { type: "string", description: "New SL trigger price" },
@@ -5980,8 +6317,7 @@ function allToolSpecs() {
     ...registerAlgoTradeTools(),
     ...registerAccountTools(),
     ...registerBotTools(),
-    ...registerEarnTools(),
-    ...registerOnchainEarnTools(),
+    ...registerAllEarnTools(),
     ...registerAuditTools()
   ];
 }
@@ -6355,7 +6691,7 @@ function readCliVersion() {
   return "0.0.0";
 }
 var CLI_VERSION = readCliVersion();
-var GIT_HASH = true ? "4427916" : "dev";
+var GIT_HASH = true ? "1df90cc" : "dev";
 var Report = class {
   lines = [];
   add(key, value) {
@@ -6582,18 +6918,19 @@ async function checkNetwork(config, client, report) {
   }
   return passed;
 }
-function getAuthHints(msg) {
+function getAuthHints(msg, baseUrl) {
+  const accountUrl = baseUrl.replace(/\/+$/, "") + "/account/my-api";
   if (msg.includes("50111") || msg.includes("Invalid OK-ACCESS-KEY")) {
-    return ["API key is invalid or expired", "Regenerate at https://www.okx.com/account/my-api"];
+    return ["API key is invalid or expired", `Regenerate at ${accountUrl}`];
   }
   if (msg.includes("50112") || msg.includes("Invalid Sign")) {
-    return ["Secret key or passphrase may be wrong", "Regenerate API key at https://www.okx.com/account/my-api"];
+    return ["Secret key or passphrase may be wrong", `Regenerate API key at ${accountUrl}`];
   }
   if (msg.includes("50113")) {
     return ["Passphrase is incorrect"];
   }
   if (msg.includes("50100")) {
-    return ["API key lacks required permissions", "Update permissions at https://www.okx.com/account/my-api"];
+    return ["API key lacks required permissions", `Update permissions at ${accountUrl}`];
   }
   return ["Check API credentials and permissions"];
 }
@@ -6616,7 +6953,7 @@ async function checkAuth(client, config, report) {
   } catch (e) {
     const ms = Date.now() - t1;
     const msg = e instanceof Error ? e.message : String(e);
-    const hints = getAuthHints(msg);
+    const hints = getAuthHints(msg, config.baseUrl);
     fail("Account balance", msg, hints);
     passed = false;
     report.add("auth_api", `FAIL /account/balance ${msg} (${ms}ms)`);
@@ -6738,6 +7075,10 @@ var HELP_TREE = {
       "open-interest": {
         usage: "okx market open-interest --instType <SWAP|FUTURES|OPTION> [--instId <id>]",
         description: "Get open interest for instruments"
+      },
+      "stock-tokens": {
+        usage: "okx market stock-tokens [--instType <SPOT|SWAP>] [--instId <id>]",
+        description: "List all stock token instruments (instCategory=3, e.g. AAPL-USDT-SWAP)"
       }
     }
   },
@@ -7005,7 +7346,7 @@ var HELP_TREE = {
     }
   },
   earn: {
-    description: "Earn products \u2014 Simple Earn (savings/lending) and On-chain Earn (staking/DeFi)",
+    description: "Earn products \u2014 Simple Earn, On-chain Earn, and DCD (Dual Currency Deposit)",
     subgroups: {
       savings: {
         description: "Simple Earn \u2014 flexible savings and lending",
@@ -7068,6 +7409,51 @@ var HELP_TREE = {
             description: "Get on-chain earn order history"
           }
         }
+      },
+      dcd: {
+        description: "DCD (Dual Currency Deposit) \u2014 structured products with fixed yield",
+        commands: {
+          pairs: {
+            usage: "okx earn dcd pairs",
+            description: "List available DCD currency pairs"
+          },
+          products: {
+            usage: "okx earn dcd products --baseCcy <ccy> --quoteCcy <ccy> --optType <C|P>\n                         [--minYield <n>] [--strikeNear <price>]\n                         [--termDays <n>] [--minTermDays <n>] [--maxTermDays <n>]\n                         [--expDate <YYYY-MM-DD|YYYY-MM-DDTHH:mm>]",
+            description: "List active DCD products (baseCcy, quoteCcy, optType required). Client-side filters: minYield (e.g. 0.05=5%), strikeNear (\xB110%), term range, expDate"
+          },
+          quote: {
+            usage: "okx earn dcd quote --productId <id> --sz <n> --notionalCcy <ccy>",
+            description: "Request a real-time DCD quote (TTL: 30 seconds)"
+          },
+          buy: {
+            usage: "okx earn dcd buy --quoteId <id> [--clOrdId <id>]",
+            description: "[CAUTION] Execute a DCD quote to place a trade. Auto-queries order state after placement"
+          },
+          "quote-and-buy": {
+            usage: "okx earn dcd quote-and-buy --productId <id> --sz <n> --notionalCcy <ccy> [--clOrdId <id>]",
+            description: "[CAUTION] Request quote and execute immediately in one step (no confirmation \u2014 for AI agent use)"
+          },
+          "redeem-quote": {
+            usage: "okx earn dcd redeem-quote --ordId <id>",
+            description: "Request an early redemption quote for a live DCD order (TTL: 15 seconds)"
+          },
+          redeem: {
+            usage: "okx earn dcd redeem --ordId <id> --quoteId <id>",
+            description: "[CAUTION] Execute early redemption of a DCD position"
+          },
+          "redeem-execute": {
+            usage: "okx earn dcd redeem-execute --ordId <id>",
+            description: "[CAUTION] Re-quote and execute early redemption in one step (recommended for AI agent use)"
+          },
+          order: {
+            usage: "okx earn dcd order --ordId <id>",
+            description: "Query current state of a DCD order"
+          },
+          orders: {
+            usage: "okx earn dcd orders [--ordId <id>] [--productId <id>] [--uly <uly>] [--state <state>] [--limit <n>]",
+            description: "Get DCD order history. State: initial|live|pending_settle|settled|pending_redeem|redeemed|rejected"
+          }
+        }
       }
     }
   },
@@ -7103,7 +7489,7 @@ var HELP_TREE = {
         description: "Contract DCA (Martingale) bot \u2014 leveraged recurring buys on futures/swaps",
         commands: {
           orders: {
-            usage: "okx bot dca orders [--history]",
+            usage: "okx bot dca orders [--algoId <id>] [--instId <id>] [--history]",
             description: "List active or historical Contract DCA bot orders"
           },
           details: {
@@ -7390,6 +7776,21 @@ var CLI_OPTIONS = {
   tag: { type: "string" },
   allowEarlyRedeem: { type: "boolean", default: false },
   state: { type: "string" },
+  // dcd
+  quoteId: { type: "string" },
+  notionalCcy: { type: "string" },
+  optType: { type: "string" },
+  baseCcy: { type: "string" },
+  beginId: { type: "string" },
+  endId: { type: "string" },
+  begin: { type: "string" },
+  end: { type: "string" },
+  minYield: { type: "string" },
+  strikeNear: { type: "string" },
+  termDays: { type: "string" },
+  minTermDays: { type: "string" },
+  maxTermDays: { type: "string" },
+  expDate: { type: "string" },
   // diagnostics
   verbose: { type: "boolean", default: false }
 };
@@ -7649,6 +8050,22 @@ async function cmdMarketCandles(run, instId, opts) {
     }))
   );
 }
+async function cmdMarketStockTokens(run, opts) {
+  const result = await run("market_get_stock_tokens", { instType: opts.instType, instId: opts.instId });
+  const items = getData(result);
+  if (opts.json) return printJson(items);
+  printTable(
+    (items ?? []).slice(0, 50).map((t) => ({
+      instId: t["instId"],
+      instCategory: t["instCategory"],
+      ctVal: t["ctVal"],
+      lotSz: t["lotSz"],
+      minSz: t["minSz"],
+      tickSz: t["tickSz"],
+      state: t["state"]
+    }))
+  );
+}
 
 // src/commands/account.ts
 import * as fs4 from "fs";
@@ -9278,7 +9695,9 @@ async function cmdDcaStop(run, opts) {
 }
 async function cmdDcaOrders(run, opts) {
   const result = await run("dca_get_orders", {
-    status: opts.history ? "history" : "active"
+    status: opts.history ? "history" : "active",
+    algoId: opts.algoId,
+    instId: opts.instId
   });
   const orders = getData7(result) ?? [];
   if (opts.json) return printJson(orders);
@@ -9394,10 +9813,362 @@ function cmdOnchainEarnOrderHistory(run, v) {
   });
 }
 
+// src/commands/dcd.ts
+function extractArray(result) {
+  if (result && typeof result === "object") {
+    const data = result["data"];
+    if (Array.isArray(data)) return data;
+  }
+  return [];
+}
+function extractProducts(result) {
+  if (result && typeof result === "object") {
+    const data = result["data"];
+    if (data && typeof data === "object" && !Array.isArray(data)) {
+      const products = data["products"];
+      if (Array.isArray(products)) return products;
+    }
+  }
+  return [];
+}
+async function cmdDcdPairs(run, json) {
+  const result = await run("dcd_get_currency_pairs", {});
+  const data = extractArray(result);
+  if (json) {
+    printJson(data);
+    return;
+  }
+  if (!data.length) {
+    process.stdout.write("No currency pairs available\n");
+    return;
+  }
+  printTable(data.map((r) => ({
+    baseCcy: r["baseCcy"],
+    quoteCcy: r["quoteCcy"],
+    optType: r["optType"]
+  })));
+}
+function filterByYield(data, minYield) {
+  return data.filter((r) => {
+    const y = parseFloat(r["annualizedYield"]);
+    return !isNaN(y) && y >= minYield;
+  });
+}
+function filterByStrike(data, ref) {
+  return data.filter((r) => {
+    const strike = parseFloat(r["strike"]);
+    return !isNaN(strike) && Math.abs(strike - ref) / ref <= 0.1;
+  });
+}
+function filterByTerm(data, termDays, minTermDays, maxTermDays) {
+  const MS_PER_DAY = 864e5;
+  return data.filter((r) => {
+    const exp = Number(r["expTime"]);
+    const start = Number(r["interestAccrualTime"]);
+    if (!exp || !start) return false;
+    const days = Math.round((exp - start) / MS_PER_DAY);
+    if (termDays !== void 0 && days !== termDays) return false;
+    if (minTermDays !== void 0 && days < minTermDays) return false;
+    if (maxTermDays !== void 0 && days > maxTermDays) return false;
+    return true;
+  });
+}
+function filterByExpDate(data, expDate) {
+  const hasTime = expDate.includes("T") || expDate.includes(" ");
+  const precision = hasTime ? 13 : 10;
+  const target = new Date(expDate).toISOString().slice(0, precision);
+  return data.filter((r) => {
+    const exp = Number(r["expTime"]);
+    if (!exp) return false;
+    return new Date(exp).toISOString().slice(0, precision) === target;
+  });
+}
+function applyProductFilters(data, opts) {
+  if (opts.minYield !== void 0) data = filterByYield(data, opts.minYield);
+  if (opts.strikeNear !== void 0) data = filterByStrike(data, opts.strikeNear);
+  if (opts.termDays !== void 0 || opts.minTermDays !== void 0 || opts.maxTermDays !== void 0) {
+    data = filterByTerm(data, opts.termDays, opts.minTermDays, opts.maxTermDays);
+  }
+  if (opts.expDate !== void 0) data = filterByExpDate(data, opts.expDate);
+  return data;
+}
+async function cmdDcdProducts(run, opts) {
+  const result = await run("dcd_get_products", {
+    baseCcy: opts.baseCcy,
+    quoteCcy: opts.quoteCcy,
+    optType: opts.optType
+  });
+  const data = applyProductFilters(extractProducts(result), opts);
+  if (opts.json) {
+    printJson(data);
+    return;
+  }
+  if (!data.length) {
+    process.stdout.write("No products matched\n");
+    return;
+  }
+  printTable(data.map((r) => ({
+    productId: r["productId"],
+    baseCcy: r["baseCcy"],
+    quoteCcy: r["quoteCcy"],
+    optType: r["optType"],
+    strike: r["strike"],
+    // products endpoint returns decimal (e.g. 0.3423 = 34.23%) — multiply by 100
+    annualizedYield: r["annualizedYield"] ? `${(parseFloat(r["annualizedYield"]) * 100).toFixed(2)}%` : "\u2014",
+    minSize: r["minSize"],
+    expTime: r["expTime"] ? new Date(Number(r["expTime"])).toLocaleDateString() : ""
+  })));
+}
+async function cmdDcdQuote(run, opts) {
+  const result = await run("dcd_request_quote", {
+    productId: opts.productId,
+    notionalSz: opts.notionalSz,
+    notionalCcy: opts.notionalCcy
+  });
+  const data = extractArray(result);
+  if (opts.json) {
+    printJson(data);
+    return;
+  }
+  const r = data[0];
+  if (!r) {
+    process.stdout.write("No quote returned\n");
+    return;
+  }
+  printKv({
+    quoteId: r["quoteId"],
+    productId: r["productId"],
+    notionalSz: r["notionalSz"],
+    notionalCcy: r["notionalCcy"],
+    // quote endpoint returns percentage directly (e.g. 18.34 = 18.34%) — no ×100 needed
+    annualizedYield: r["annualizedYield"] ? `${r["annualizedYield"]}%` : "\u2014",
+    absYield: r["absYield"],
+    idxPx: r["idxPx"],
+    validUntil: r["validUntil"] ? new Date(Number(r["validUntil"])).toLocaleString() : "\u2014"
+  });
+  process.stdout.write("\nQuote expires soon. Use 'earn dcd buy --quoteId <id>' to execute.\n");
+}
+async function cmdDcdBuy(run, opts) {
+  const result = await run("dcd_execute_quote", {
+    quoteId: opts.quoteId,
+    clOrdId: opts.clOrdId
+  });
+  const data = extractArray(result);
+  const r = data[0];
+  if (!r) {
+    process.stdout.write("No response data\n");
+    return;
+  }
+  const ordId = r["ordId"];
+  let stateRow;
+  if (ordId) {
+    try {
+      const stateResult = await run("dcd_get_order_state", { ordId });
+      stateRow = extractArray(stateResult)[0];
+    } catch {
+    }
+  }
+  if (opts.json) {
+    printJson({ order: r, state: stateRow ?? null });
+    return;
+  }
+  process.stdout.write("Order placed:\n");
+  printKv({ ordId: r["ordId"], quoteId: r["quoteId"], state: r["state"] });
+  if (stateRow) {
+    process.stdout.write("\nOrder state:\n");
+    printKv({
+      ordId: stateRow["ordId"],
+      state: stateRow["state"]
+    });
+  }
+}
+async function cmdDcdRedeemQuote(run, opts) {
+  const result = await run("dcd_request_redeem_quote", { ordId: opts.ordId });
+  const data = extractArray(result);
+  if (opts.json) {
+    printJson(data);
+    return;
+  }
+  const r = data[0];
+  if (!r) {
+    process.stdout.write("No redeem quote returned\n");
+    return;
+  }
+  const redeemSzRaw = r["redeemSz"];
+  const redeemSzDisplay = redeemSzRaw ? `${parseFloat(redeemSzRaw).toFixed(8)} ${r["redeemCcy"]}` : "\u2014";
+  const termRateRaw = r["termRate"];
+  const termRateDisplay = termRateRaw ? `${termRateRaw}%` : "\u2014";
+  const validUntil = r["validUntil"] ? new Date(Number(r["validUntil"])).toLocaleString() : "\u2014";
+  printKv({
+    ordId: r["ordId"],
+    quoteId: r["quoteId"],
+    redeemSz: redeemSzDisplay,
+    termRate: termRateDisplay,
+    validUntil
+  });
+  process.stdout.write("\nQuote expires soon. Use 'earn dcd redeem-execute --ordId <id>' to execute.\n");
+}
+async function cmdDcdRedeem(run, opts) {
+  const result = await run("dcd_execute_redeem", { ordId: opts.ordId, quoteId: opts.quoteId });
+  const data = extractArray(result);
+  if (opts.json) {
+    printJson(data);
+    return;
+  }
+  const r = data[0];
+  if (!r) {
+    process.stdout.write("No response data\n");
+    return;
+  }
+  printKv({ ordId: r["ordId"], state: r["state"] });
+}
+async function cmdDcdRedeemExecute(run, opts) {
+  const quoteResult = await run("dcd_request_redeem_quote", { ordId: opts.ordId });
+  const quoteData = extractArray(quoteResult);
+  const q = quoteData[0];
+  if (!q) {
+    process.stdout.write("Failed to get redeem quote\n");
+    return;
+  }
+  const redeemResult = await run("dcd_execute_redeem", {
+    ordId: opts.ordId,
+    quoteId: q["quoteId"]
+  });
+  const redeemData = extractArray(redeemResult);
+  const r = redeemData[0];
+  if (!r) {
+    process.stdout.write("No response data\n");
+    return;
+  }
+  if (opts.json) {
+    printJson({ quote: q, redeem: r });
+    return;
+  }
+  printKv({
+    ordId: r["ordId"],
+    state: r["state"],
+    redeemSz: q["redeemSz"] ? `${parseFloat(q["redeemSz"]).toFixed(8)} ${q["redeemCcy"]}` : "\u2014",
+    termRate: q["termRate"] ? `${q["termRate"]}%` : "\u2014",
+    validUntil: q["validUntil"] ? new Date(Number(q["validUntil"])).toLocaleString() : "\u2014"
+  });
+}
+async function cmdDcdOrderState(run, opts) {
+  const result = await run("dcd_get_order_state", { ordId: opts.ordId });
+  const data = extractArray(result);
+  if (opts.json) {
+    printJson(data);
+    return;
+  }
+  const r = data[0];
+  if (!r) {
+    process.stdout.write("Order not found\n");
+    return;
+  }
+  printKv({
+    ordId: r["ordId"],
+    state: r["state"],
+    productId: r["productId"],
+    strike: r["strike"],
+    notionalSz: r["notionalSz"],
+    settleTime: r["settleTime"] ? new Date(Number(r["settleTime"])).toLocaleDateString() : ""
+  });
+}
+async function cmdDcdOrders(run, opts) {
+  const result = await run("dcd_get_orders", {
+    ordId: opts.ordId,
+    productId: opts.productId,
+    uly: opts.uly,
+    state: opts.state,
+    beginId: opts.beginId,
+    endId: opts.endId,
+    begin: opts.begin,
+    end: opts.end,
+    limit: opts.limit
+  });
+  const data = extractArray(result);
+  if (opts.json) {
+    printJson(data);
+    return;
+  }
+  if (!data.length) {
+    process.stdout.write("No orders found\n");
+    return;
+  }
+  printTable(data.map((r) => ({
+    ordId: r["ordId"],
+    productId: r["productId"],
+    state: r["state"],
+    baseCcy: r["baseCcy"],
+    quoteCcy: r["quoteCcy"],
+    strike: r["strike"],
+    notionalSz: r["notionalSz"],
+    annualizedYield: r["annualizedYield"],
+    yieldSz: r["yieldSz"],
+    settleTime: r["settleTime"] ? new Date(Number(r["settleTime"])).toLocaleDateString() : "",
+    // scheduled settlement time
+    settledTime: r["settledTime"] ? new Date(Number(r["settledTime"])).toLocaleDateString() : ""
+    // actual settled time (non-empty only after settlement)
+  })));
+}
+async function cmdDcdQuoteAndBuy(run, opts) {
+  const quoteResult = await run("dcd_request_quote", {
+    productId: opts.productId,
+    notionalSz: opts.notionalSz,
+    notionalCcy: opts.notionalCcy
+  });
+  const quoteData = extractArray(quoteResult);
+  const q = quoteData[0];
+  if (!q) {
+    process.stdout.write("No quote returned\n");
+    return;
+  }
+  const buyResult = await run("dcd_execute_quote", {
+    quoteId: q["quoteId"],
+    clOrdId: opts.clOrdId
+  });
+  const buyData = extractArray(buyResult);
+  const r = buyData[0];
+  if (!r) {
+    process.stdout.write("No order response\n");
+    return;
+  }
+  const ordId = r["ordId"];
+  let stateRow;
+  if (ordId) {
+    try {
+      const stateResult = await run("dcd_get_order_state", { ordId });
+      stateRow = extractArray(stateResult)[0];
+    } catch {
+    }
+  }
+  if (opts.json) {
+    printJson({ quote: q, order: r, state: stateRow ?? null });
+    return;
+  }
+  process.stdout.write("Quote:\n");
+  printKv({
+    quoteId: q["quoteId"],
+    // quote endpoint returns percentage directly (e.g. 18.34 = 18.34%) — no ×100 needed
+    annualizedYield: q["annualizedYield"] ? `${q["annualizedYield"]}%` : "\u2014",
+    absYield: q["absYield"],
+    notionalSz: q["notionalSz"],
+    notionalCcy: q["notionalCcy"]
+  });
+  process.stdout.write("\nOrder placed:\n");
+  printKv({ ordId: r["ordId"], quoteId: r["quoteId"], state: r["state"] ?? r["status"] });
+  if (stateRow) {
+    process.stdout.write("\nOrder state:\n");
+    printKv({
+      ordId: stateRow["ordId"],
+      state: stateRow["state"]
+    });
+  }
+}
+
 // src/index.ts
 var _require2 = createRequire2(import.meta.url);
 var CLI_VERSION2 = _require2("../package.json").version;
-var GIT_HASH2 = true ? "4427916" : "dev";
+var GIT_HASH2 = true ? "1df90cc" : "dev";
 function handleConfigCommand(action, rest, json, lang, force) {
   if (action === "init") return cmdConfigInit(lang === "zh" ? "zh" : "en");
   if (action === "show") return cmdConfigShow(json);
@@ -9442,6 +10213,8 @@ function handleMarketPublicCommand(run, action, rest, v, json) {
   if (action === "price-limit") return cmdMarketPriceLimit(run, rest[0], json);
   if (action === "open-interest")
     return cmdMarketOpenInterest(run, { instType: v.instType, instId: v.instId, json });
+  if (action === "stock-tokens")
+    return cmdMarketStockTokens(run, { instType: v.instType, instId: v.instId, json });
 }
 function handleMarketDataCommand(run, action, rest, v, json) {
   const limit = v.limit !== void 0 ? Number(v.limit) : void 0;
@@ -9828,7 +10601,7 @@ function handleBotGridCommand(run, v, rest, json) {
 }
 function handleBotDcaCommand(run, subAction, v, json) {
   if (subAction === "orders")
-    return cmdDcaOrders(run, { history: v.history ?? false, json });
+    return cmdDcaOrders(run, { algoId: v.algoId, instId: v.instId, history: v.history ?? false, json });
   if (subAction === "details")
     return cmdDcaDetails(run, { algoId: v.algoId, json });
   if (subAction === "sub-orders")
@@ -9864,8 +10637,9 @@ function handleEarnCommand(run, submodule, rest, v, json) {
   const innerRest = rest.slice(1);
   if (submodule === "savings") return handleEarnSavingsCommand(run, action, innerRest, v, json);
   if (submodule === "onchain") return handleEarnOnchainCommand(run, action, v, json);
+  if (submodule === "dcd") return handleEarnDcdCommand(run, action, v, json);
   process.stderr.write(`Unknown earn sub-module: ${submodule}
-Valid: savings, onchain
+Valid: savings, onchain, dcd
 `);
   process.exitCode = 1;
 }
@@ -9893,6 +10667,70 @@ function handleEarnOnchainCommand(run, action, v, json) {
 `);
   process.exitCode = 1;
 }
+function parseDcdOpts(v) {
+  return {
+    limit: v.limit !== void 0 ? Number(v.limit) : void 0,
+    minYield: v.minYield !== void 0 ? parseFloat(v.minYield) : void 0,
+    strikeNear: v.strikeNear !== void 0 ? parseFloat(v.strikeNear) : void 0,
+    termDays: v.termDays !== void 0 ? parseInt(v.termDays, 10) : void 0,
+    minTermDays: v.minTermDays !== void 0 ? parseInt(v.minTermDays, 10) : void 0,
+    maxTermDays: v.maxTermDays !== void 0 ? parseInt(v.maxTermDays, 10) : void 0
+  };
+}
+function handleEarnDcdCommand(run, action, v, json) {
+  const { limit, minYield, strikeNear, termDays, minTermDays, maxTermDays } = parseDcdOpts(v);
+  if (action === "pairs") return cmdDcdPairs(run, json);
+  if (action === "products")
+    return cmdDcdProducts(run, {
+      baseCcy: v.baseCcy,
+      quoteCcy: v.quoteCcy,
+      optType: v.optType,
+      minYield,
+      strikeNear,
+      termDays,
+      minTermDays,
+      maxTermDays,
+      expDate: v.expDate,
+      json
+    });
+  if (action === "quote")
+    return cmdDcdQuote(run, { productId: v.productId, notionalSz: v.sz, notionalCcy: v.notionalCcy, json });
+  if (action === "buy")
+    return cmdDcdBuy(run, { quoteId: v.quoteId, clOrdId: v.clOrdId, json });
+  if (action === "quote-and-buy")
+    return cmdDcdQuoteAndBuy(run, {
+      productId: v.productId,
+      notionalSz: v.sz,
+      notionalCcy: v.notionalCcy,
+      clOrdId: v.clOrdId,
+      json
+    });
+  if (action === "redeem-quote")
+    return cmdDcdRedeemQuote(run, { ordId: v.ordId, json });
+  if (action === "redeem")
+    return cmdDcdRedeem(run, { ordId: v.ordId, quoteId: v.quoteId, json });
+  if (action === "redeem-execute")
+    return cmdDcdRedeemExecute(run, { ordId: v.ordId, json });
+  if (action === "order")
+    return cmdDcdOrderState(run, { ordId: v.ordId, json });
+  if (action === "orders")
+    return cmdDcdOrders(run, {
+      ordId: v.ordId,
+      productId: v.productId,
+      uly: v.uly,
+      state: v.state,
+      beginId: v.beginId,
+      endId: v.endId,
+      begin: v.begin,
+      end: v.end,
+      limit,
+      json
+    });
+  process.stderr.write(`Unknown earn dcd command: ${action}
+Valid: pairs, products, quote, buy, quote-and-buy, redeem-quote, redeem, redeem-execute, order, orders
+`);
+  process.exitCode = 1;
+}
 function outputResult(result, json) {
   if (json) {
     process.stdout.write(JSON.stringify(result, null, 2) + "\n");