@okx_ai/okx-trade-cli 1.3.2-beta.3 → 1.3.2-beta.5

package/dist/index.js

@@ -1926,6 +1926,23 @@ function privateRateLimit(key, rps = 10) {
     refillPerSecond: rps
   };
 }
+var CURSOR_PROPS = {
+  after: { type: "string", description: "Cursor: return older records" },
+  before: { type: "string", description: "Cursor: return newer records" }
+};
+var TIME_RANGE_PROPS = {
+  begin: { type: "string", description: "Start time (ms)" },
+  end: { type: "string", description: "End time (ms)" }
+};
+function readPaginationParams(args, readStr, readNum) {
+  return {
+    after: readStr(args, "after"),
+    before: readStr(args, "before"),
+    begin: readStr(args, "begin"),
+    end: readStr(args, "end"),
+    limit: readNum(args, "limit")
+  };
+}
 function assertNotDemo(config, endpoint) {
   if (config.demo) {
     throw new ConfigError(
@@ -2184,6 +2201,8 @@ function registerIndicatorTools() {
   ];
 }
 var DEFAULT_SOURCE_TAG = "MCP";
+var TOKEN_REGEX = /^[A-Z2-7]{12}$/;
+var TAG_JOIN = "";
 var OKX_SITES = {
   global: {
     label: "Global",
@@ -3141,7 +3160,8 @@ function registerAlgoTradeTools() {
             callBackSpread: readString(args, "callbackSpread"),
             activePx: readString(args, "activePx"),
             reduceOnly: typeof reduceOnly === "boolean" ? String(reduceOnly) : void 0,
-            clOrdId: readString(args, "clOrdId")
+            clOrdId: readString(args, "clOrdId"),
+            tag: context.config.sourceTag
           }),
           privateRateLimit("swap_place_move_stop_order", 20)
         );
@@ -3486,7 +3506,8 @@ function registerFuturesAlgoTools() {
             callBackSpread: readString(args, "callbackSpread"),
             activePx: readString(args, "activePx"),
             reduceOnly: typeof reduceOnly === "boolean" ? String(reduceOnly) : void 0,
-            clOrdId: readString(args, "clOrdId")
+            clOrdId: readString(args, "clOrdId"),
+            tag: context.config.sourceTag
           }),
           privateRateLimit("futures_place_move_stop_order", 20)
         );
@@ -6341,37 +6362,45 @@ function registerEventContractTools() {
     {
       name: "event_get_orders",
       module: "event",
-      description: "Query event contract orders. state=live for open orders; omit for history. outcome pre-translated (YES/NO/UP/DOWN).",
+      description: "Query event contract orders (open, 7d history, or 3-month archive). outcome pre-translated (YES/NO/UP/DOWN). Do NOT use for trade executions \u2014 use event_get_fills for fill records and settlement outcomes.",
       isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
-          instId: {
+          status: {
             type: "string",
-            description: "Event contract instrument ID"
+            enum: ["open", "history", "archive"],
+            description: "open=active, history=7d (default), archive=3mo"
           },
-          state: {
+          instId: {
             type: "string",
-            description: "live=pending orders; omit for history"
+            description: "Event contract instrument ID"
           },
-          limit: {
-            type: "number",
-            description: "Max results (default 20)"
-          }
+          ordType: { type: "string", description: "Order type filter" },
+          state: { type: "string", description: "canceled|filled (only for history/archive)" },
+          ...CURSOR_PROPS,
+          ...TIME_RANGE_PROPS,
+          limit: { type: "number", description: "Max results (default 100)" }
         }
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
-        const state = readString(args, "state");
-        const isPending = state === "live";
-        const endpoint = isPending ? "/api/v5/trade/orders-pending" : "/api/v5/trade/orders-history";
+        const status = readString(args, "status") ?? "history";
+        const endpointMap = {
+          open: "/api/v5/trade/orders-pending",
+          archive: "/api/v5/trade/orders-history-archive"
+        };
+        const endpoint = endpointMap[status] ?? "/api/v5/trade/orders-history";
+        const params = compactObject({
+          instType: "EVENTS",
+          instId: readString(args, "instId"),
+          ordType: readString(args, "ordType"),
+          state: readString(args, "state"),
+          ...readPaginationParams(args, readString, readNumber)
+        });
         const response = await context.client.privateGet(
           endpoint,
-          compactObject({
-            instType: "EVENTS",
-            instId: readString(args, "instId"),
-            limit: readNumber(args, "limit")
-          }),
+          params,
           privateRateLimit("event_get_orders", 20)
         );
         const base = normalizeResponse(response);
@@ -6385,41 +6414,51 @@ function registerEventContractTools() {
             stateLabel: mapOrderState(String(item["state"] ?? ""))
           };
         }) : base["data"];
-        return { ...base, data };
+        return { ...base, data, requestParams: params };
       }
     },
     {
       name: "event_get_fills",
       module: "event",
-      description: "Get event contract fill history. outcome pre-translated (YES/NO/UP/DOWN). Each record includes a 'type' field: 'fill' (subType 410, opening trade) or 'settlement' (subType 414 win / subType 415 loss, contract expiry payout). Settlement records include 'settlementResult' (win/loss) and 'pnl' fields \u2014 no separate market lookup needed to determine outcome.",
+      description: "Get event contract fill history (trade executions and settlement payouts). archive=true for up to 3mo, false (default) for last 3d. outcome pre-translated (YES/NO/UP/DOWN). Each record includes a 'type' field: 'fill' (opening trade) or 'settlement' (expiry payout with settlementResult win/loss and pnl). Do NOT use for order status \u2014 use event_get_orders instead.",
       isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
+          archive: {
+            type: "boolean",
+            description: "true=up to 3mo, false=3d (default)"
+          },
           instId: {
             type: "string",
             description: "Event contract instrument ID"
           },
-          limit: {
-            type: "number",
-            description: "Max results (default 20)"
-          }
+          ordId: { type: "string", description: "Order ID filter" },
+          ...CURSOR_PROPS,
+          ...TIME_RANGE_PROPS,
+          limit: { 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 path42 = archive ? "/api/v5/trade/fills-history" : "/api/v5/trade/fills";
+        const paging = readPaginationParams(args, readString, readNumber);
+        const params = compactObject({
+          instType: "EVENTS",
+          instId: readString(args, "instId"),
+          ordId: readString(args, "ordId"),
+          ...paging,
+          limit: paging.limit ?? (archive ? 20 : void 0)
+        });
         const response = await context.client.privateGet(
-          "/api/v5/trade/fills",
-          compactObject({
-            instType: "EVENTS",
-            instId: readString(args, "instId"),
-            limit: readNumber(args, "limit")
-          }),
+          path42,
+          params,
           privateRateLimit("event_get_fills", 20)
         );
         const base = normalizeResponse(response);
         const data = Array.isArray(base["data"]) ? base["data"].map(enrichFill) : base["data"];
-        return { ...base, data };
+        return { ...base, data, requestParams: params };
       }
     },
     // -----------------------------------------------------------------------
@@ -6503,7 +6542,7 @@ function registerEventContractTools() {
     {
       name: "event_amend_order",
       module: "event",
-      description: "Amend a pending event contract order (change price or size). [CAUTION] Modifies a real order. Before amending, call event_get_orders(state=live) to obtain the ordId and confirm the order is still pending. Only limit/post_only orders can be amended.",
+      description: "Amend a pending event contract order (change price or size). [CAUTION] Modifies a real order. Before amending, call event_get_orders(status=open) to obtain the ordId and confirm the order is still pending. Only limit/post_only orders can be amended.",
       isWrite: true,
       inputSchema: {
         type: "object",
@@ -6534,7 +6573,7 @@ function registerEventContractTools() {
     {
       name: "event_cancel_order",
       module: "event",
-      description: "Cancel a pending event contract order. [CAUTION] Cancels a real order. Before cancelling, call event_get_orders(state=live) to obtain the ordId and confirm the order is still pending. instId must be the full event contract instrument ID (e.g. BTC-ABOVE-DAILY-260224-1600-69700), NOT a spot trading pair.",
+      description: "Cancel a pending event contract order. [CAUTION] Cancels a real order. Before cancelling, call event_get_orders(status=open) to obtain the ordId and confirm the order is still pending. instId must be the full event contract instrument ID (e.g. BTC-ABOVE-DAILY-260224-1600-69700), NOT a spot trading pair.",
       isWrite: true,
       inputSchema: {
         type: "object",
@@ -6582,27 +6621,27 @@ var PATH_SIGNAL_HISTORY = "/api/v5/journal/smartmoney/signal-history";
 var SIGNAL_POOL_FILTER_PROPS = {
   sortType: {
     type: "string",
-    description: "pnl or pnlRatio"
+    description: "Pool ranking: pnl|pnlRatio (default pnl)"
   },
   period: {
     type: "string",
-    description: "3|7|30|90 days"
+    description: "Win-rate window days: 3|7|30|90 (default 90). Not snapshot range."
   },
   pnl: {
     type: "string",
-    description: "PNL_ANY|PNL_TOP50|PNL_TOP20|PNL_TOP5"
+    description: "Top N% by PnL: PNL_ANY|PNL_TOP50|PNL_TOP20|PNL_TOP5 (default PNL_ANY)"
   },
   winRatio: {
     type: "string",
-    description: "WR_ANY|WR_GE_50|WR_GE_80"
+    description: "Min win-rate: WR_ANY|WR_GE_50|WR_GE_80 (default WR_ANY)"
   },
   maxRetreat: {
     type: "string",
-    description: "MR_ANY|MR_LE_20|MR_LE_50"
+    description: "Max drawdown: MR_ANY|MR_LE_20|MR_LE_50 (default MR_ANY)"
   },
   asset: {
     type: "string",
-    description: "AUM_ANY|AUM_TOP50|AUM_TOP20|AUM_TOP5"
+    description: "Top N% by AUM: AUM_ANY|AUM_TOP50|AUM_TOP20|AUM_TOP5 (default AUM_ANY)"
   }
 };
 var LEADERBOARD_POOL_FILTER_PROPS = {
@@ -6654,39 +6693,39 @@ function registerSmartmoneyTools() {
     {
       name: "smartmoney_get_overview",
       module: "smartmoney",
-      description: "Multi-currency smart money overview ranked by most-watched currencies. Pass ts=Date.now() for latest data, or dataVersion (yyyyMMddHHmm) from a prior call. For single-currency signal with entry prices and trend, use smartmoney_get_signal.",
+      description: "Multi-currency smart money overview, ranked by tradersWithPosition DESC (most-watched first). Requires either ts (recommended, Date.now()) or dataVersion (yyyyMMddHHmm UTC) \u2014 at least one must be set; ts wins when both are sent. For single-currency signal with entry prices and trend, use smartmoney_get_signal.",
       isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
-          dataVersion: {
+          ts: {
             type: "string",
-            description: "yyyyMMddHHmm UTC (or use ts)"
+            description: "Recommended. Timestamp ms \u2014 use Date.now() for latest."
           },
-          ts: {
+          dataVersion: {
             type: "string",
-            description: "Timestamp ms (or use dataVersion)"
+            description: "Alternative. yyyyMMddHHmm UTC for prior snapshot. If both sent, ts wins."
           },
           instType: {
             type: "string",
-            description: "SPOT|MARGIN|FUTURES|SWAP|OPTION"
+            description: "SPOT|MARGIN|FUTURES|SWAP|OPTION (default SWAP)"
           },
           ...SIGNAL_POOL_FILTER_PROPS,
           lmtNum: {
             type: "string",
-            description: "Trader pool size 1-500"
+            description: "Trader pool size 1-500 (default 100)"
           },
           instCcyList: {
             type: "string",
-            description: "Comma-separated e.g. BTC,ETH,SOL"
+            description: "Comma-separated currency codes e.g. BTC,ETH,SOL (prefix-matched against instId)"
           },
           instCcy: {
             type: "string",
-            description: "Single currency e.g. BTC"
+            description: "Single currency e.g. BTC; alias for instCcyList (instCcyList wins if both set)"
           },
           topInstruments: {
             type: "string",
-            description: "Top N instruments 1-100"
+            description: "Top N instruments 1-100 (default 20)"
           }
         }
       },
@@ -6718,35 +6757,35 @@ function registerSmartmoneyTools() {
     {
       name: "smartmoney_get_signal",
       module: "smartmoney",
-      description: "Single-currency consensus signal: long/short ratio, entry prices, trend, capital flow. Requires instId or instCcy. Pass ts=Date.now() for latest data, or dataVersion from a prior call. For multi-currency overview, use smartmoney_get_overview. For timeline, use smartmoney_get_signal_history.",
+      description: "Single-currency consensus signal: long/short ratio, entry prices, trend, capital flow. Requires either instId (e.g. BTC-USDT-SWAP, recommended) or instCcy (SPOT/SWAP only) \u2014 instId wins when both are sent. Requires either ts (recommended, Date.now()) or dataVersion (yyyyMMddHHmm UTC) \u2014 at least one must be set; ts wins when both are sent. For multi-currency overview, use smartmoney_get_overview. For timeline, use smartmoney_get_signal_history.",
       isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
           instId: {
             type: "string",
-            description: "e.g. BTC-USDT-SWAP (or use instCcy)"
+            description: "Recommended. e.g. BTC-USDT-SWAP"
           },
           instCcy: {
             type: "string",
-            description: "e.g. BTC, SPOT/SWAP only (or use instId)"
+            description: "e.g. BTC (SPOT/SWAP only); instId takes precedence if both set"
           },
-          dataVersion: {
+          ts: {
             type: "string",
-            description: "yyyyMMddHHmm UTC (or use ts)"
+            description: "Recommended. Timestamp ms \u2014 use Date.now() for latest."
           },
-          ts: {
+          dataVersion: {
             type: "string",
-            description: "Timestamp ms (or use dataVersion)"
+            description: "Alternative. yyyyMMddHHmm UTC for prior snapshot. If both sent, ts wins."
           },
           ...SIGNAL_POOL_FILTER_PROPS,
           lmtNum: {
             type: "string",
-            description: "Trader pool size 1-500"
+            description: "Trader pool size 1-500 (default 100)"
           },
           authorIds: {
             type: "string",
-            description: "Comma-separated user IDs e.g. 1001,1002"
+            description: "Comma-separated user IDs e.g. 1001,1002 \u2014 restricts the trader pool to these IDs only (precise filter)"
           }
         }
       },
@@ -6782,7 +6821,7 @@ function registerSmartmoneyTools() {
     {
       name: "smartmoney_get_signal_history",
       module: "smartmoney",
-      description: "Signal history timeline sorted by ts DESC for trend analysis. Requires instId. Pass ts=Date.now() for latest data, or dataVersion from a prior call. For current snapshot, use smartmoney_get_signal.",
+      description: "Signal history timeline sorted by ts DESC for trend analysis. Requires instId. Requires either ts (recommended, Date.now()) or dataVersion (yyyyMMddHHmm UTC) \u2014 at least one must be set; ts wins when both are sent. For current snapshot, use smartmoney_get_signal.",
       isWrite: false,
       inputSchema: {
         type: "object",
@@ -6791,13 +6830,13 @@ function registerSmartmoneyTools() {
             type: "string",
             description: "e.g. BTC-USDT-SWAP"
           },
-          dataVersion: {
+          ts: {
             type: "string",
-            description: "yyyyMMddHHmm UTC (or use ts)"
+            description: "Recommended. Timestamp ms \u2014 use Date.now() for latest."
           },
-          ts: {
+          dataVersion: {
             type: "string",
-            description: "Timestamp ms (or use dataVersion)"
+            description: "Alternative. yyyyMMddHHmm UTC for prior snapshot. If both sent, ts wins."
           },
           granularity: {
             type: "string",
@@ -10406,6 +10445,30 @@ function resolveBaseUrl(site, tomlBaseUrl) {
   }
   return rawBaseUrl.replace(/\/+$/, "");
 }
+function resolveSourceTag(cli, defaultTag, opts = {}) {
+  const readEnv = opts.readEnv !== false;
+  const cliSkill = cli.skill?.trim();
+  if (cliSkill) {
+    if (isValidToken(cliSkill)) return composeTag(defaultTag, cliSkill);
+    console.warn("--skill value format invalid (expected 12-char Base32), ignoring");
+  }
+  if (readEnv) {
+    const envToken = process.env.OKX_SKILL_TOKEN?.trim();
+    if (envToken) {
+      if (isValidToken(envToken)) return composeTag(defaultTag, envToken);
+      console.warn("OKX_SKILL_TOKEN format invalid, ignoring");
+    }
+  }
+  const sourceTag = cli.sourceTag?.trim();
+  if (sourceTag) return sourceTag;
+  return defaultTag;
+}
+function composeTag(defaultTag, token) {
+  return `${defaultTag}${TAG_JOIN}${token}`;
+}
+function isValidToken(s) {
+  return TOKEN_REGEX.test(s);
+}
 function resolveDemo(cli, toml) {
   if (cli.demo && cli.live) {
     throw new ConfigError(
@@ -10417,7 +10480,7 @@ function resolveDemo(cli, toml) {
   if (cli.demo === true) return true;
   return process.env.OKX_DEMO === "1" || process.env.OKX_DEMO === "true" || (toml.demo ?? false);
 }
-function loadConfig(cli) {
+function loadConfig(cli, opts = {}) {
   const toml = readTomlProfile(cli.profile);
   const creds = loadCredentials(toml);
   const demo = resolveDemo(cli, toml);
@@ -10437,6 +10500,7 @@ function loadConfig(cli) {
       "proxy_url must start with http:// or https://. SOCKS proxies are not supported."
     );
   }
+  const defaultTag = opts.entryPrefix ?? DEFAULT_SOURCE_TAG;
   return {
     ...creds,
     baseUrl,
@@ -10446,7 +10510,9 @@ function loadConfig(cli) {
     demo,
     site,
     userAgent: cli.userAgent,
-    sourceTag: cli.sourceTag ?? DEFAULT_SOURCE_TAG,
+    // sourceTag resolution: --skill > OKX_SKILL_TOKEN > --source-tag > defaultTag
+    // MCP entry passes { readEnv: false } to honour the "MCP path not attributed" contract.
+    sourceTag: resolveSourceTag(cli, defaultTag, { readEnv: opts.readEnv }),
     proxyUrl: rawProxyUrl || void 0,
     verbose: cli.verbose ?? false
   };
@@ -11646,7 +11712,7 @@ async function cmdDiagnoseMcp(options = {}) {
 
 // src/commands/diagnose.ts
 var CLI_VERSION = readCliVersion();
-var GIT_HASH = true ? "330e727a" : "dev";
+var GIT_HASH = true ? "7acf49fb" : "dev";
 function maskKey2(key) {
   if (!key) return "(not set)";
   if (key.length <= 8) return "****";
@@ -12938,12 +13004,12 @@ var CLI_REGISTRY = {
       },
       orders: {
         toolName: "event_get_orders",
-        usage: "okx event orders [--instId <id>] [--state live] [--limit <n>] [--json]",
+        usage: "okx event orders [--status <open|history|archive>] [--instId <id>] [--ordType <type>] [--state <canceled|filled>] [--after <id>] [--before <id>] [--begin <ms>] [--end <ms>] [--limit <n>] [--json]",
         description: "Query event contract orders"
       },
       fills: {
         toolName: "event_get_fills",
-        usage: "okx event fills [--instId <id>] [--limit <n>] [--json]",
+        usage: "okx event fills [--archive] [--instId <id>] [--ordId <id>] [--after <id>] [--before <id>] [--begin <ms>] [--end <ms>] [--limit <n>] [--json]",
         description: "Get event contract fill history"
       }
     }
@@ -12954,18 +13020,18 @@ var CLI_REGISTRY = {
     commands: {
       overview: {
         toolName: "smartmoney_get_overview",
-        usage: "okx smartmoney overview [--dataVersion <ver>] [--ts <ms>] [--instType <SWAP|SPOT>] [--sortType <pnl|pnlRatio>] [--period <3|7|30|90>] [--pnl <tier>] [--winRatio <tier>] [--maxRetreat <tier>] [--asset <tier>] [--lmtNum <n>] [--instCcyList <ccys>] [--instCcy <ccy>] [--topInstruments <n>] [--json]",
-        description: "Multi-currency smart money overview with aggregated signals"
+        usage: "okx smartmoney overview [--ts <ms> | --dataVersion <ver>] [--instType <SWAP|SPOT>] [--sortType <pnl|pnlRatio>] [--period <3|7|30|90>] [--pnl <tier>] [--winRatio <tier>] [--maxRetreat <tier>] [--asset <tier>] [--lmtNum <n>] [--instCcyList <ccys>] [--instCcy <ccy>] [--topInstruments <n>] [--json]",
+        description: "Multi-currency smart money overview ranked by tradersWithPosition DESC (requires --ts or --dataVersion; --ts takes precedence)"
       },
       signal: {
         toolName: "smartmoney_get_signal",
-        usage: "okx smartmoney signal [--instId <id>] [--instCcy <ccy>] [--dataVersion <ver>] [--ts <ms>] [--sortType <pnl|pnlRatio>] [--period <3|7|30|90>] [--pnl <tier>] [--winRatio <tier>] [--maxRetreat <tier>] [--asset <tier>] [--lmtNum <n>] [--authorIds <ids>] [--json]",
-        description: "Single-currency aggregated consensus signal"
+        usage: "okx smartmoney signal [--instId <id>] [--instCcy <ccy>] [--ts <ms> | --dataVersion <ver>] [--sortType <pnl|pnlRatio>] [--period <3|7|30|90>] [--pnl <tier>] [--winRatio <tier>] [--maxRetreat <tier>] [--asset <tier>] [--lmtNum <n>] [--authorIds <ids>] [--json]",
+        description: "Single-currency aggregated consensus signal (requires --instId or --instCcy, and --ts or --dataVersion; --instId / --ts take precedence)"
       },
       "signal-history": {
         toolName: "smartmoney_get_signal_history",
-        usage: "okx smartmoney signal-history --instId <id> [--dataVersion <ver>] [--ts <ms>] [--granularity <1h|1d>] [--limit <n>] [--sortType <pnl|pnlRatio>] [--period <3|7|30|90>] [--pnl <tier>] [--winRatio <tier>] [--maxRetreat <tier>] [--asset <tier>] [--json]",
-        description: "Signal history timeline for trend analysis"
+        usage: "okx smartmoney signal-history --instId <id> [--ts <ms> | --dataVersion <ver>] [--granularity <1h|1d>] [--limit <n>] [--sortType <pnl|pnlRatio>] [--period <3|7|30|90>] [--pnl <tier>] [--winRatio <tier>] [--maxRetreat <tier>] [--asset <tier>] [--json]",
+        description: "Signal history timeline sorted by ts DESC (requires --instId and --ts/--dataVersion)"
       },
       traders: {
         toolName: "smartmoney_get_traders",
@@ -13490,17 +13556,21 @@ async function cmdNewsSentimentRank(run, opts) {
 
 // src/config/loader.ts
 function loadProfileConfig(opts) {
-  return loadConfig({
-    profile: opts.profile,
-    modules: opts.modules,
-    readOnly: opts.readOnly ?? false,
-    demo: opts.demo,
-    live: opts.live,
-    site: opts.site,
-    userAgent: opts.userAgent,
-    sourceTag: opts.sourceTag,
-    verbose: opts.verbose
-  });
+  return loadConfig(
+    {
+      profile: opts.profile,
+      modules: opts.modules,
+      readOnly: opts.readOnly ?? false,
+      demo: opts.demo,
+      live: opts.live,
+      site: opts.site,
+      userAgent: opts.userAgent,
+      sourceTag: opts.sourceTag,
+      skill: opts.skill,
+      verbose: opts.verbose
+    },
+    { entryPrefix: opts.entryPrefix, readEnv: opts.readEnv }
+  );
 }
 
 // src/help.ts
@@ -13509,12 +13579,13 @@ var HELP_TREE = generateHelpTree();
 function printGlobalHelp() {
   const lines = [
     "",
-    `Usage: okx [--profile <name>] [--demo | --live] [--json] <module> <action> [args...]`,
+    `Usage: okx [--profile <name>] [--demo | --live] [--skill <token>] [--json] <module> <action> [args...]`,
     "",
     "Global Options:",
     `  --profile <name>   Use a named profile from ${configFilePath()}`,
     "  --demo             Use simulated trading (demo) mode",
     "  --live             Force live trading mode (overrides profile demo=true; mutually exclusive with --demo)",
+    "  --skill <token>    OKX skill token for order tagging (from SKILL.md)",
     "  --json             Output raw JSON",
     "  --env              With --json, wrap output as {env, profile, data}",
     "  --verbose          Show detailed network request/response info (stderr)",
@@ -13647,6 +13718,7 @@ import { parseArgs } from "util";
 var CLI_OPTIONS = {
   profile: { type: "string" },
   demo: { type: "boolean", default: false },
+  skill: { type: "string" },
   json: { type: "boolean", default: false },
   env: { type: "boolean", default: false },
   help: { type: "boolean", default: false },
@@ -17627,8 +17699,14 @@ async function cmdEventMarkets(run, opts) {
 }
 async function cmdEventOrders(run, opts) {
   const result = await run("event_get_orders", {
+    status: opts.status,
     instId: opts.instId,
+    ordType: opts.ordType,
     state: opts.state,
+    after: opts.after,
+    before: opts.before,
+    begin: opts.begin,
+    end: opts.end,
     limit: opts.limit
   });
   const data = getData9(result);
@@ -17647,7 +17725,13 @@ async function cmdEventOrders(run, opts) {
 }
 async function cmdEventFills(run, opts) {
   const result = await run("event_get_fills", {
+    archive: opts.archive,
     instId: opts.instId,
+    ordId: opts.ordId,
+    after: opts.after,
+    before: opts.before,
+    begin: opts.begin,
+    end: opts.end,
     limit: opts.limit
   });
   const data = getData9(result);
@@ -17836,7 +17920,7 @@ async function cmdEventCancel(run, opts) {
 // src/index.ts
 var _require3 = createRequire3(import.meta.url);
 var CLI_VERSION2 = _require3("../package.json").version;
-var GIT_HASH2 = true ? "330e727a" : "dev";
+var GIT_HASH2 = true ? "7acf49fb" : "dev";
 function handlePilotCommand(action, json, force, binaryPath) {
   if (action === "status") return cmdPilotStatus(json, binaryPath);
   if (action === "install") return cmdPilotInstall(json, binaryPath);
@@ -18959,8 +19043,29 @@ function handleEventCommand(run, action, rest, v, json) {
     }),
     amend: () => cmdEventAmend(run, { instId: v.instId ?? rest[0], ordId: v.ordId ?? rest[1], px: v.px, sz: v.sz, json }),
     cancel: () => cmdEventCancel(run, { instId: v.instId ?? rest[0], ordId: v.ordId ?? rest[1], json }),
-    orders: () => cmdEventOrders(run, { instId: v.instId, state: v.state, limit, json }),
-    fills: () => cmdEventFills(run, { instId: v.instId, limit, json })
+    orders: () => cmdEventOrders(run, {
+      status: v.status,
+      instId: v.instId,
+      ordType: v.ordType,
+      state: v.state,
+      after: v.after,
+      before: v.before,
+      begin: v.begin,
+      end: v.end,
+      limit,
+      json
+    }),
+    fills: () => cmdEventFills(run, {
+      archive: v.archive ?? false,
+      instId: v.instId,
+      ordId: v.ordId,
+      after: v.after,
+      before: v.before,
+      begin: v.begin,
+      end: v.end,
+      limit,
+      json
+    })
   };
   const handler = handlers[action];
   if (handler) return handler();
@@ -19005,7 +19110,7 @@ function wrapRunnerWithLogger(baseRunner, logger, verbose = false) {
 async function runDiagnose(v) {
   let config;
   try {
-    config = loadProfileConfig({ profile: v.profile, demo: v.demo, live: v.live, verbose: v.verbose, userAgent: `okx-trade-cli/${CLI_VERSION2}`, sourceTag: "CLI" });
+    config = loadProfileConfig({ profile: v.profile, demo: v.demo, live: v.live, verbose: v.verbose, userAgent: `okx-trade-cli/${CLI_VERSION2}`, sourceTag: "CLI", skill: v.skill, entryPrefix: "CLI" });
   } catch {
   }
   return cmdDiagnose(config, v.profile ?? "default", { mcp: v.mcp, cli: v.cli, all: v.all, output: v.output });
@@ -19060,7 +19165,7 @@ async function main() {
   const json = v.json ?? false;
   const mgmt = routeManagementCommand(module, action, rest, json, v);
   if (mgmt !== void 0) return mgmt === true ? void 0 : mgmt;
-  const config = loadProfileConfig({ profile: v.profile, demo: v.demo, live: v.live, verbose: v.verbose, userAgent: `okx-trade-cli/${CLI_VERSION2}`, sourceTag: "CLI" });
+  const config = loadProfileConfig({ profile: v.profile, demo: v.demo, live: v.live, verbose: v.verbose, userAgent: `okx-trade-cli/${CLI_VERSION2}`, sourceTag: "CLI", skill: v.skill, entryPrefix: "CLI" });
   setEnvContext({ demo: config.demo, profile: v.profile ?? "default" });
   setJsonEnvEnabled(v.env ?? false);
   const client = new OkxRestClient(config);