@okx_ai/okx-trade-cli 1.2.4-beta.0 → 1.2.4-beta.2

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",
@@ -3428,10 +3429,286 @@ 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 [
+    {
+      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: {
+          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: "Filter by state: initial | live | pending_settle | settled | pending_redeem | redeemed | rejected"
+          },
+          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()
+    ...registerOnchainEarnTools(),
+    ...registerDcdTools()
   ];
 }
 var FUTURES_INST_TYPES = ["FUTURES", "SWAP"];
@@ -4276,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 });
+      }
     }
   ];
 }
@@ -6380,7 +6691,7 @@ function readCliVersion() {
   return "0.0.0";
 }
 var CLI_VERSION = readCliVersion();
-var GIT_HASH = true ? "ecce5a7" : "dev";
+var GIT_HASH = true ? "1df90cc" : "dev";
 var Report = class {
   lines = [];
   add(key, value) {
@@ -6607,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"];
 }
@@ -6641,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)`);
@@ -6763,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)"
       }
     }
   },
@@ -7030,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",
@@ -7093,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"
+          }
+        }
       }
     }
   },
@@ -7415,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 }
 };
@@ -7674,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";
@@ -9421,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 ? "ecce5a7" : "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);
@@ -9469,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;
@@ -9891,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;
 }
@@ -9920,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");