@onebullex-group/cli 1.3.1 → 1.5.0

package/dist/index.js

@@ -3,6 +3,9 @@ import {
   effectiveFormat,
   render
 } from "./chunk-J3TAAD3Q.js";
+import {
+  resolveBillNo
+} from "./chunk-6DC55RF7.js";
 import {
   DEFAULT_CONFIG_PATH,
   checkConfigPermissions,
@@ -11,20 +14,23 @@ import {
   resolveConfig,
   writeConfigFile
 } from "./chunk-AKGCHJPQ.js";
+import {
+  downloadToFile
+} from "./chunk-SGLPG2FL.js";
 import {
   HttpClient
-} from "./chunk-NKWXNVLA.js";
+} from "./chunk-YE5LER6U.js";
+import "./chunk-LVNSFQXS.js";
+import {
+  redactSecret
+} from "./chunk-OOLZIYXS.js";
+import "./chunk-ZYO5P4DH.js";
 import {
   ConfigError,
   DryRunInterception,
   EXIT,
   OneBullExError
 } from "./chunk-JRUFIHU7.js";
-import {
-  redactSecret
-} from "./chunk-OOLZIYXS.js";
-import "./chunk-ZYO5P4DH.js";
-import "./chunk-LVNSFQXS.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -113,11 +119,11 @@ function prune(o) {
   return out;
 }
 function registerTickerGet(parent, ctx) {
-  parent.command("get <symbol>").description("Get ticker for a symbol (GET /v2/public/q/ticker)").option("--time-range <type>", "time range type").action(async (symbol, opts) => {
+  parent.command("get <symbol>").description("Get ticker for a symbol (GET /v2/public/q/ticker)").requiredOption("--time-range-type <type>", "H24, or calendar-day window UTC_P_0..UTC_P_12 / UTC_N_1..UTC_N_12 (e.g. UTC_P_8)").action(async (symbol, opts) => {
     const c = ctx.http({ requireAuth: false });
     const data = await c.getPublic(
       "/v2/public/q/ticker",
-      prune({ symbol, timeRangeType: opts.timeRange })
+      prune({ symbol, timeRangeType: opts.timeRangeType })
     );
     const { render: render2, effectiveFormat: effectiveFormat2 } = await import("./output-UIZGG7EU.js");
     ctx.stdout(
@@ -138,11 +144,11 @@ function prune2(o) {
   return out;
 }
 function registerTickerList(parent, ctx) {
-  parent.command("list").description("List all tickers (GET /v2/public/q/tickers)").requiredOption("--time-range <type>", "time range type").action(async (opts) => {
+  parent.command("list").description("List all tickers (GET /v2/public/q/tickers)").requiredOption("--time-range-type <type>", "H24, or calendar-day window UTC_P_0..UTC_P_12 / UTC_N_1..UTC_N_12 (e.g. UTC_P_8)").action(async (opts) => {
     const c = ctx.http({ requireAuth: false });
     const data = await c.getPublic(
       "/v2/public/q/tickers",
-      prune2({ timeRangeType: opts.timeRange })
+      prune2({ timeRangeType: opts.timeRangeType })
     );
     const { render: render2, effectiveFormat: effectiveFormat2 } = await import("./output-UIZGG7EU.js");
     ctx.stdout(
@@ -163,11 +169,11 @@ function prune3(o) {
   return out;
 }
 function registerTickerAgg(parent, ctx) {
-  parent.command("agg <symbol>").description("Get aggregated ticker for a symbol (GET /v2/public/q/agg-ticker)").option("--time-range <type>", "time range type").action(async (symbol, opts) => {
+  parent.command("agg <symbol>").description("Get aggregated ticker for a symbol (GET /v2/public/q/agg-ticker)").requiredOption("--time-range-type <type>", "H24, or calendar-day window UTC_P_0..UTC_P_12 / UTC_N_1..UTC_N_12 (e.g. UTC_P_8)").action(async (symbol, opts) => {
     const c = ctx.http({ requireAuth: false });
     const data = await c.getPublic(
       "/v2/public/q/agg-ticker",
-      prune3({ symbol, timeRangeType: opts.timeRange })
+      prune3({ symbol, timeRangeType: opts.timeRangeType })
     );
     const { render: render2, effectiveFormat: effectiveFormat2 } = await import("./output-UIZGG7EU.js");
     ctx.stdout(
@@ -188,11 +194,11 @@ function prune4(o) {
   return out;
 }
 function registerTickerAggList(parent, ctx) {
-  parent.command("agg-list").description("List all aggregated tickers (GET /v2/public/q/agg-tickers)").requiredOption("--time-range <type>", "time range type").action(async (opts) => {
+  parent.command("agg-list").description("List all aggregated tickers (GET /v2/public/q/agg-tickers)").requiredOption("--time-range-type <type>", "H24, or calendar-day window UTC_P_0..UTC_P_12 / UTC_N_1..UTC_N_12 (e.g. UTC_P_8)").action(async (opts) => {
     const c = ctx.http({ requireAuth: false });
     const data = await c.getPublic(
       "/v2/public/q/agg-tickers",
-      prune4({ timeRangeType: opts.timeRange })
+      prune4({ timeRangeType: opts.timeRangeType })
     );
     const { render: render2, effectiveFormat: effectiveFormat2 } = await import("./output-UIZGG7EU.js");
     ctx.stdout(
@@ -213,7 +219,7 @@ function prune5(o) {
   return out;
 }
 function registerDepthGet(parent, ctx) {
-  parent.command("get <symbol>").description("Get order book depth (GET /v2/public/q/depth)").option("--level <level>", "depth level", parseInt).action(async (symbol, opts) => {
+  parent.command("get <symbol>").description("Get order book depth (GET /v2/public/q/depth)").requiredOption("--level <level>", "depth levels, 1-50", parseInt).action(async (symbol, opts) => {
     const c = ctx.http({ requireAuth: false });
     const data = await c.getPublic(
       "/v2/public/q/depth",
@@ -355,8 +361,8 @@ function registerIndexPriceList(parent, ctx) {
 // src/commands/index-price/get.ts
 function registerIndexPriceGet(parent, ctx) {
   parent.command("get <symbol>").description("Get index price for a symbol (GET /v2/public/q/symbol-index-price)").action(async (symbol) => {
-    const c = ctx.http({ requireAuth: true });
-    const data = await c.getPrivate("/v2/public/q/symbol-index-price", { symbol });
+    const c = ctx.http({ requireAuth: false });
+    const data = await c.getPublic("/v2/public/q/symbol-index-price", { symbol });
     const { render: render2, effectiveFormat: effectiveFormat2 } = await import("./output-UIZGG7EU.js");
     ctx.stdout(
       render2(data, {
@@ -545,18 +551,22 @@ function prune12(o) {
   return out;
 }
 function registerBalanceBills(parent, ctx) {
-  parent.command("bills").description("List balance bill records (GET /v2/balance/bills)").option("--coin <coin>", "filter by coin").option("--type <type>", "bill type").option("--start-time <ms>", "start time in milliseconds", parseInt).option("--end-time <ms>", "end time in milliseconds", parseInt).option("--page <page>", "page number", parseInt).option("--size <size>", "page size", parseInt).action(
+  parent.command("bills").description(
+    "List balance bill records, cursor-paginated (GET /v2/balance/bills). Pass the last item id as --id with --direction NEXT for the next page."
+  ).option("--coin <coin>", "filter by coin").option("--symbol <symbol>", "filter by trading pair").option("--type <type>", "bill type, e.g. EXCHANGE / FEE / FUND / CLOSE_POSITION").option("--start-time <ms>", "start time in milliseconds", parseInt).option("--end-time <ms>", "end time in milliseconds", parseInt).option("--id <id>", "cursor: bill id to page from").option("--direction <direction>", "cursor direction: NEXT | PREV (API default NEXT)").option("--limit <limit>", "records per page (API default 10)", parseInt).action(
     async (opts) => {
       const c = ctx.http({ requireAuth: true });
       const data = await c.getPrivate(
         "/v2/balance/bills",
         prune12({
           coin: opts.coin,
+          symbol: opts.symbol,
           type: opts.type,
           startTime: opts.startTime,
           endTime: opts.endTime,
-          page: opts.page,
-          size: opts.size
+          id: opts.id,
+          direction: opts.direction,
+          limit: opts.limit
         })
       );
       const { render: render2, effectiveFormat: effectiveFormat2 } = await import("./output-UIZGG7EU.js");
@@ -570,6 +580,106 @@ function registerBalanceBills(parent, ctx) {
   );
 }
 
+// src/commands/balance/funding.ts
+function registerBalanceFunding(parent, ctx) {
+  parent.command("funding").description("Get funding account (USDT) balance (GET /v2/balance/funding)").action(async () => {
+    const c = ctx.http({ requireAuth: true });
+    const data = await c.getPrivate("/v2/balance/funding", {});
+    const { render: render2, effectiveFormat: effectiveFormat2 } = await import("./output-UIZGG7EU.js");
+    ctx.stdout(
+      render2(data, {
+        format: effectiveFormat2(ctx.outputFormat, ctx.isTTY),
+        isTTY: ctx.isTTY
+      })
+    );
+  });
+}
+
+// src/core/dry-run.ts
+function renderDryRun(p) {
+  const lines = [
+    "--- DRY RUN (no request sent) ---",
+    `${p.method} ${p.url}`
+  ];
+  if (p.body !== void 0) {
+    lines.push("Body:");
+    lines.push(JSON.stringify(p.body, null, 2));
+  }
+  lines.push("");
+  lines.push("To execute, re-run with --confirm.");
+  return lines.join("\n");
+}
+
+// src/core/execute-write.ts
+async function executeWrite(opts) {
+  if (!opts.confirm) {
+    const url = `${opts.config?.baseUrl ?? ""}${opts.path}`;
+    const preview = renderDryRun({ method: opts.method, url, body: opts.body });
+    throw new DryRunInterception(preview);
+  }
+  return opts.send();
+}
+
+// src/commands/_write/_helpers.ts
+function pruneEmpty(o) {
+  const out = {};
+  for (const [k, v] of Object.entries(o)) {
+    if (v != null && v !== "") out[k] = v;
+  }
+  return out;
+}
+async function runWrite(ctx, path, body) {
+  const cfg = ctx.resolveConfig({ requireAuth: true });
+  const c = ctx.http({ requireAuth: true });
+  const data = await executeWrite({
+    confirm: ctx.confirm ?? false,
+    method: "POST",
+    path,
+    body,
+    send: () => c.postPrivate(path, body),
+    config: cfg
+  });
+  ctx.stdout(
+    render(data, {
+      format: effectiveFormat(ctx.outputFormat, ctx.isTTY),
+      isTTY: ctx.isTTY
+    })
+  );
+}
+
+// src/commands/balance/transfer.ts
+function registerBalanceTransfer(parent, ctx) {
+  parent.command("transfer").description("Transfer funds between accounts (POST /v2/balance/transfer)").requiredOption("--from <account>", "source account: FUNDING | CONTRACT").requiredOption("--to <account>", "destination account: FUNDING | CONTRACT").requiredOption("--amount <amount>", "transfer amount, must be greater than 0").option("--bill-no <id>", "idempotency key; auto-generated when omitted").option("--remark <text>", "optional note").action(
+    async (opts) => {
+      if (opts.from === opts.to) {
+        throw new Error("--from and --to must differ (the API rejects identical accounts)");
+      }
+      await runWrite(ctx, "/v2/balance/transfer", {
+        billNo: resolveBillNo(opts.billNo),
+        from: opts.from,
+        to: opts.to,
+        amount: opts.amount,
+        ...opts.remark != null && opts.remark !== "" ? { remark: opts.remark } : {}
+      });
+    }
+  );
+}
+
+// src/commands/bot/redeeming-info.ts
+function registerBotRedeemingInfo(parent, ctx) {
+  parent.command("redeeming-info").description("Get bot redemption queue summary (GET /v2/bot/redeeming-info)").action(async () => {
+    const c = ctx.http({ requireAuth: true });
+    const data = await c.getPrivate("/v2/bot/redeeming-info", {});
+    const { render: render2, effectiveFormat: effectiveFormat2 } = await import("./output-UIZGG7EU.js");
+    ctx.stdout(
+      render2(data, {
+        format: effectiveFormat2(ctx.outputFormat, ctx.isTTY),
+        isTTY: ctx.isTTY
+      })
+    );
+  });
+}
+
 // src/commands/order/list-unfinished.ts
 function prune13(o) {
   const out = {};
@@ -579,7 +689,7 @@ function prune13(o) {
   return out;
 }
 function registerOrderListUnfinished(parent, ctx) {
-  parent.command("list-unfinished <symbol>").description("List unfinished orders for a symbol (GET /v2/order/listUnfinished)").option("--direction <direction>", "order direction").action(async (symbol, opts) => {
+  parent.command("list-unfinished <symbol>").description("List unfinished orders for a symbol (GET /v2/order/listUnfinished)").requiredOption("--direction <direction>", "order side: BUY | SELL").action(async (symbol, opts) => {
     const c = ctx.http({ requireAuth: true });
     const data = await c.getPrivate(
       "/v2/order/listUnfinished",
@@ -666,7 +776,7 @@ function prune15(o) {
   return out;
 }
 function registerOrderListHistory(parent, ctx) {
-  parent.command("list-history").description("List order history (GET /v2/order/list-history)").option("--symbol <symbol>", "filter by symbol").option("--start-time <ms>", "start time in milliseconds", parseInt).option("--end-time <ms>", "end time in milliseconds", parseInt).option("--id <id>", "order ID cursor").option("--direction <direction>", "order direction").option("--limit <limit>", "number of records", parseInt).option("--force-close", "filter force-close orders").action(
+  parent.command("list-history").description("List order history (GET /v2/order/list-history)").option("--symbol <symbol>", "filter by symbol").option("--start-time <ms>", "start time in milliseconds", parseInt).option("--end-time <ms>", "end time in milliseconds", parseInt).option("--id <id>", "order ID cursor").option("--direction <direction>", "cursor direction: NEXT | PREV (API default NEXT)").option("--limit <limit>", "number of records", parseInt).option("--force-close", "filter force-close orders").action(
     async (opts) => {
       const c = ctx.http({ requireAuth: true });
       const data = await c.getPrivate(
@@ -775,7 +885,7 @@ function prune18(o) {
   return out;
 }
 function registerEntrustPlanHistory(parent, ctx) {
-  parent.command("plan-history").description("List plan entrust history (GET /v2/entrust/plan-list-history)").option("--symbol <symbol>", "filter by symbol").option("--start-time <ms>", "start time in milliseconds", parseInt).option("--end-time <ms>", "end time in milliseconds", parseInt).option("--id <id>", "cursor ID").option("--direction <direction>", "order direction").option("--limit <limit>", "number of records", parseInt).action(
+  parent.command("plan-history").description("List plan entrust history (GET /v2/entrust/plan-list-history)").option("--symbol <symbol>", "filter by symbol").option("--start-time <ms>", "start time in milliseconds", parseInt).option("--end-time <ms>", "end time in milliseconds", parseInt).option("--id <id>", "cursor ID").option("--direction <direction>", "cursor direction: NEXT | PREV (API default NEXT)").option("--limit <limit>", "number of records", parseInt).action(
     async (opts) => {
       const c = ctx.http({ requireAuth: true });
       const data = await c.getPrivate(
@@ -802,7 +912,9 @@ function registerEntrustPlanHistory(parent, ctx) {
 
 // src/commands/entrust/plan-get.ts
 function registerEntrustPlanGet(parent, ctx) {
-  parent.command("plan-get <id>").description("Get plan entrust detail (GET /v2/entrust/plan-detail)").action(async (id) => {
+  parent.command("plan-get <id>").description(
+    "Get plan entrust detail (GET /v2/entrust/plan-detail). Positional <id> is sent as entrustId."
+  ).action(async (id) => {
     const c = ctx.http({ requireAuth: true });
     const data = await c.getPrivate("/v2/entrust/plan-detail", { entrustId: id });
     const { render: render2, effectiveFormat: effectiveFormat2 } = await import("./output-UIZGG7EU.js");
@@ -842,7 +954,9 @@ function registerEntrustProfitList(parent, ctx) {
 
 // src/commands/entrust/profit-get.ts
 function registerEntrustProfitGet(parent, ctx) {
-  parent.command("profit-get <id>").description("Get TP/SL entrust detail (GET /v2/entrust/profit-detail)").action(async (id) => {
+  parent.command("profit-get <id>").description(
+    "Get TP/SL entrust detail (GET /v2/entrust/profit-detail). Positional <id> is sent as profitId."
+  ).action(async (id) => {
     const c = ctx.http({ requireAuth: true });
     const data = await c.getPrivate("/v2/entrust/profit-detail", { profitId: id });
     const { render: render2, effectiveFormat: effectiveFormat2 } = await import("./output-UIZGG7EU.js");
@@ -954,7 +1068,9 @@ async function prompt(rl, q, def) {
   return ans.length === 0 && def !== void 0 ? def : ans;
 }
 function registerConfigInit(parent, ctx) {
-  parent.command("init").description("Initialize a new profile (interactive)").option("--name <name>", "profile name (skip prompt)").option("--env <env>", "environment: test | prod").option("--base-url <url>", "override base url").option("--api-key <key>", "API key (only allowed with --yes; prefer interactive)").option("--secret <secret>", "API secret (only allowed with --yes; prefer interactive)").option("--identify <id>", "sub-account identify header (optional)").option("--set-default", "mark this profile as default-profile", true).option("--yes", "non-interactive mode (use provided flags only)").action(async (flags) => {
+  parent.command("init").description("Initialize a new profile (interactive)").option("--name <name>", "profile name (skip prompt)").option("--env <env>", "environment: test | prod").option("--base-url <url>", "override base url").option("--api-key <key>", "API key (only allowed with --yes; prefer interactive)").option("--secret <secret>", "API secret (only allowed with --yes; prefer interactive)").option("--identify <id>", "sub-account identify header (optional)").option("--set-default", "mark this profile as default-profile (default)", true).option("--no-set-default", "add the profile without changing default-profile").option("--yes", "non-interactive mode (use provided flags only)").action(async (subFlags, cmd) => {
+    const flags = cmd.optsWithGlobals();
+    flags.setDefault = subFlags.setDefault;
     const path = ctx.getConfigPath();
     let existing = null;
     try {
@@ -1172,61 +1288,9 @@ function registerConfigRemove(parent, ctx) {
   });
 }
 
-// src/core/dry-run.ts
-function renderDryRun(p) {
-  const lines = [
-    "--- DRY RUN (no request sent) ---",
-    `${p.method} ${p.url}`
-  ];
-  if (p.body !== void 0) {
-    lines.push("Body:");
-    lines.push(JSON.stringify(p.body, null, 2));
-  }
-  lines.push("");
-  lines.push("To execute, re-run with --confirm.");
-  return lines.join("\n");
-}
-
-// src/core/execute-write.ts
-async function executeWrite(opts) {
-  if (!opts.confirm) {
-    const url = `${opts.config?.baseUrl ?? ""}${opts.path}`;
-    const preview = renderDryRun({ method: opts.method, url, body: opts.body });
-    throw new DryRunInterception(preview);
-  }
-  return opts.send();
-}
-
-// src/commands/_write/_helpers.ts
-function pruneEmpty(o) {
-  const out = {};
-  for (const [k, v] of Object.entries(o)) {
-    if (v != null && v !== "") out[k] = v;
-  }
-  return out;
-}
-async function runWrite(ctx, path, body) {
-  const cfg = ctx.resolveConfig({ requireAuth: true });
-  const c = ctx.http({ requireAuth: true });
-  const data = await executeWrite({
-    confirm: ctx.confirm ?? false,
-    method: "POST",
-    path,
-    body,
-    send: () => c.postPrivate(path, body),
-    config: cfg
-  });
-  ctx.stdout(
-    render(data, {
-      format: effectiveFormat(ctx.outputFormat, ctx.isTTY),
-      isTTY: ctx.isTTY
-    })
-  );
-}
-
 // src/commands/order/create.ts
 function registerOrderCreate(parent, ctx) {
-  parent.command("create").description("Place a new order (POST /v2/order/create)").requiredOption("--symbol <symbol>", "trading pair, e.g. btc_usdt").requiredOption("--order-type <type>", "LIMIT | MARKET | STOP_LIMIT | etc.").requiredOption("--order-side <side>", "BUY | SELL").requiredOption("--position-side <side>", "LONG | SHORT | NET").requiredOption("--orig-qty <qty>", "order quantity (string, decimal-safe)").option("--price <price>", "limit price (string)").option("--time-in-force <tif>", "GTC | IOC | FOK | GTX").option("--reduce-only <bool>", "true | false").option("--client-order-id <id>", "client-supplied order id").option("--position-id <id>", "existing position id (for hedge mode)").option("--leverage <lv>", "override leverage").option("--trigger-profit-price <price>", "TP trigger price").option("--trigger-stop-price <price>", "SL trigger price").option("--profit-order-type <type>", "TP child order type").option("--stop-order-type <type>", "SL child order type").option("--profit-order-price <price>", "TP child order price").option("--stop-order-price <price>", "SL child order price").option("--market-order-level <lv>", "market order depth level").action(
+  parent.command("create").description("Place a new order (POST /v2/order/create)").requiredOption("--symbol <symbol>", "trading pair, e.g. btc_usdt").requiredOption("--order-type <type>", "LIMIT | MARKET").requiredOption("--order-side <side>", "BUY | SELL").requiredOption("--position-side <side>", "LONG | SHORT").requiredOption("--orig-qty <qty>", "integer contracts (string)").option("--price <price>", "required when --order-type LIMIT; ignored for MARKET").option("--time-in-force <tif>", "GTC | IOC | FOK | GTX (MARKET defaults IOC, LIMIT defaults GTC; MARKET only allows IOC/FOK)").option("--reduce-only <bool>", "true | false").option("--client-order-id <id>", "client-supplied order id").option("--position-id <id>", "existing position id (for hedge mode)").option("--leverage <lv>", "override leverage").option("--trigger-profit-price <price>", "TP trigger price").option("--trigger-stop-price <price>", "SL trigger price").option("--profit-order-type <type>", "TP child order type").option("--stop-order-type <type>", "SL child order type").option("--profit-order-price <price>", "TP child order price").option("--stop-order-price <price>", "SL child order price").option("--market-order-level <lv>", "market order depth level").action(
     async (opts) => {
       const body = pruneEmpty({
         symbol: opts.symbol,
@@ -1289,7 +1353,7 @@ function registerOrderCancelAll(parent, ctx) {
 
 // src/commands/entrust/create-plan.ts
 function registerEntrustCreatePlan(parent, ctx) {
-  parent.command("create-plan").description("Create a plan entrust (POST /v2/entrust/create-plan)").requiredOption("--symbol <symbol>", "trading pair").requiredOption("--order-side <side>", "BUY | SELL").requiredOption("--position-side <side>", "LONG | SHORT | NET").requiredOption("--entrust-type <type>", "plan entrust type").requiredOption("--time-in-force <tif>", "time-in-force, e.g. GTC").requiredOption("--trigger-price-type <type>", "INDEX | MARK | LATEST").requiredOption("--orig-qty <qty>", "order quantity (string)").option("--stop-price <price>", "stop price").option("--price <price>", "limit price").option("--position-id <id>", "existing position id").option("--market-order-level <lv>", "market order depth level").option("--expire-time <ms>", "expiration time in ms").action(
+  parent.command("create-plan").description("Create a plan entrust (POST /v2/entrust/create-plan)").requiredOption("--symbol <symbol>", "trading pair").requiredOption("--order-side <side>", "BUY | SELL").requiredOption("--position-side <side>", "LONG | SHORT").requiredOption("--entrust-type <type>", "STOP | STOP_MARKET").requiredOption("--time-in-force <tif>", "GTC | IOC | FOK | GTX").requiredOption("--trigger-price-type <type>", "MARK_PRICE | LATEST_PRICE").requiredOption("--orig-qty <qty>", "integer contracts (string)").requiredOption("--stop-price <price>", "trigger price (server-required despite the doc marking it conditional)").option("--price <price>", "limit price").option("--position-id <id>", "existing position id").option("--market-order-level <lv>", "market order depth level").option("--expire-time <ms>", "expiration time in ms").action(
     async (opts) => {
       const body = pruneEmpty({
         symbol: opts.symbol,
@@ -1312,7 +1376,7 @@ function registerEntrustCreatePlan(parent, ctx) {
 
 // src/commands/entrust/create-profit.ts
 function registerEntrustCreateProfit(parent, ctx) {
-  parent.command("create-profit").description("Create a TP/SL entrust (POST /v2/entrust/create-profit)").requiredOption("--symbol <symbol>", "trading pair").requiredOption("--orig-qty <qty>", "order quantity (string)").option("--position-side <side>", "LONG | SHORT | NET").option("--order-side <side>", "BUY | SELL").option("--trigger-price-type <type>", "INDEX | MARK | LATEST").option("--trigger-profit-price <price>", "TP trigger price").option("--trigger-stop-price <price>", "SL trigger price").option("--profit-order-type <type>", "TP child order type").option("--stop-order-type <type>", "SL child order type").option("--profit-order-price <price>", "TP child order price").option("--stop-order-price <price>", "SL child order price").option("--position-id <id>", "existing position id").option("--reduce-only <bool>", "true | false").option("--profit-flag <flag>", "profit flag").option("--expire-time <ms>", "expiration time in ms").action(
+  parent.command("create-profit").description("Create a TP/SL entrust (POST /v2/entrust/create-profit)").requiredOption("--symbol <symbol>", "trading pair").requiredOption("--orig-qty <qty>", "order quantity (string)").option("--position-side <side>", "LONG | SHORT (required when --position-id is omitted)").option("--order-side <side>", "BUY | SELL (required when --position-id is omitted)").option("--trigger-price-type <type>", "MARK_PRICE | LATEST_PRICE (API default LATEST_PRICE)").option("--trigger-profit-price <price>", "TP trigger price").option("--trigger-stop-price <price>", "SL trigger price").option("--profit-order-type <type>", "TP child order type").option("--stop-order-type <type>", "SL child order type").option("--profit-order-price <price>", "TP child order price").option("--stop-order-price <price>", "SL child order price").option("--position-id <id>", "existing position id").option("--reduce-only <bool>", "true | false").option("--profit-flag <flag>", "profit flag").option("--expire-time <ms>", "expiration time in ms").action(
     async (opts) => {
       const body = pruneEmpty({
         symbol: opts.symbol,
@@ -1471,6 +1535,68 @@ function registerPositionChangeType(parent, ctx) {
   );
 }
 
+// src/commands/position/history-async.ts
+var MAX_RANGE_MS = 366 * 24 * 60 * 60 * 1e3;
+function registerPositionHistoryAsync(parent, ctx) {
+  parent.command("history-async").description(
+    "Create an async position-history export task (GET /v2/position/history/async). Max 1-year range; at most 5 tasks per account per month. Download the result with `system download <downloadId>`."
+  ).requiredOption("--start-time <ms>", "start time in milliseconds", parseInt).requiredOption("--end-time <ms>", "end time in milliseconds", parseInt).action(async (opts) => {
+    if (!Number.isFinite(opts.startTime) || !Number.isFinite(opts.endTime)) {
+      throw new Error("--start-time and --end-time must be millisecond timestamps");
+    }
+    if (opts.endTime < opts.startTime) {
+      throw new Error("--end-time must not be earlier than --start-time");
+    }
+    if (opts.endTime - opts.startTime > MAX_RANGE_MS) {
+      throw new Error("time range must not exceed 1 year (API limit)");
+    }
+    const c = ctx.http({ requireAuth: true });
+    const data = await c.getPrivate("/v2/position/history/async", {
+      startTime: opts.startTime,
+      endTime: opts.endTime
+    });
+    const { render: render2, effectiveFormat: effectiveFormat2 } = await import("./output-UIZGG7EU.js");
+    ctx.stdout(
+      render2(data, {
+        format: effectiveFormat2(ctx.outputFormat, ctx.isTTY),
+        isTTY: ctx.isTTY
+      })
+    );
+  });
+}
+
+// src/commands/system/user-info.ts
+function registerSystemUserInfo(parent, ctx) {
+  parent.command("user-info").description("Get the user bound to the current API key (GET /v2/system/user/info)").action(async () => {
+    const c = ctx.http({ requireAuth: true });
+    const data = await c.getPrivate("/v2/system/user/info", {});
+    const { render: render2, effectiveFormat: effectiveFormat2 } = await import("./output-UIZGG7EU.js");
+    ctx.stdout(
+      render2(data, {
+        format: effectiveFormat2(ctx.outputFormat, ctx.isTTY),
+        isTTY: ctx.isTTY
+      })
+    );
+  });
+}
+
+// src/commands/system/download.ts
+function registerSystemDownload(parent, ctx) {
+  parent.command("download <downloadId>").description(
+    "Download an async export file (GET /v2/system/download). Saves to ~/.onebullex/downloads/ unless --out is given. Each success counts toward the 5-per-hour limit for that downloadId."
+  ).option("--out <path>", 'target file, or an existing directory / path ending in "/"').action(async (downloadId, opts) => {
+    const c = ctx.http({ requireAuth: true });
+    const result = await downloadToFile({ client: c, downloadId, out: opts.out, cwd: ctx.cwd });
+    const { render: render2, effectiveFormat: effectiveFormat2 } = await import("./output-UIZGG7EU.js");
+    ctx.stdout(
+      render2(result, {
+        format: effectiveFormat2(ctx.outputFormat, ctx.isTTY),
+        isTTY: ctx.isTTY
+      })
+    );
+  });
+}
+
 // src/index.ts
 function buildProgram(opts) {
   const stdoutFn = opts?.stdout ?? ((s) => process.stdout.write(s + "\n"));
@@ -1512,7 +1638,7 @@ function buildProgram(opts) {
       return new HttpClient(cfg, opts?.fetch);
     }
   };
-  const program = new Command("onebullex").version(true ? "1.3.1" : "0.0.0-dev").description("OneBullEx exchange CLI").option("-p, --profile <name>", "config profile to use").option("-o, --output <format>", "output format: table | json").option("--debug", "enable debug logging").option("--timeout <ms>", "request timeout in milliseconds", parseInt).option("--confirm", "confirm write operations (required for non-dry-run writes)").option("--base-url <url>", "override base URL").option("--api-key <key>", "override api key (env: ONEBULLEX_API_KEY)").option("--secret <s>", "override secret (env: ONEBULLEX_SECRET; CLI flag discouraged for security)").exitOverride();
+  const program = new Command("onebullex").version(true ? "1.5.0" : "0.0.0-dev").description("OneBullEx exchange CLI").option("-p, --profile <name>", "config profile to use").option("-o, --output <format>", "output format: table | json").option("--debug", "enable debug logging").option("--timeout <ms>", "request timeout in milliseconds", parseInt).option("--confirm", "confirm write operations (required for non-dry-run writes)").option("--base-url <url>", "override base URL").option("--api-key <key>", "override api key (env: ONEBULLEX_API_KEY)").option("--secret <s>", "override secret (env: ONEBULLEX_SECRET; CLI flag discouraged for security)").exitOverride();
   program.hook("preAction", (thisCommand, _actionCommand) => {
     const flags = thisCommand.opts();
     if (flags.output === "table" || flags.output === "json") {
@@ -1569,6 +1695,10 @@ function buildProgram(opts) {
   registerBalanceList(balance, ctx);
   registerBalanceGet(balance, ctx);
   registerBalanceBills(balance, ctx);
+  registerBalanceFunding(balance, ctx);
+  registerBalanceTransfer(balance, ctx);
+  const bot = program.command("bot").description("Bot redemption queue");
+  registerBotRedeemingInfo(bot, ctx);
   const order = program.command("order").description("Orders");
   registerOrderListUnfinished(order, ctx);
   registerOrderListUnfinishedMulti(order, ctx);
@@ -1603,12 +1733,16 @@ function buildProgram(opts) {
   registerPositionList(position, ctx);
   registerPositionConfs(position, ctx);
   registerPositionHistory(position, ctx);
+  registerPositionHistoryAsync(position, ctx);
   registerPositionAdjustLeverage(position, ctx);
   registerPositionMargin(position, ctx);
   registerPositionAutoMargin(position, ctx);
   registerPositionCloseAll(position, ctx);
   registerPositionMerge(position, ctx);
   registerPositionChangeType(position, ctx);
+  const system = program.command("system").description("Account identity and async export downloads");
+  registerSystemUserInfo(system, ctx);
+  registerSystemDownload(system, ctx);
   const config = program.command("config").description("Manage CLI configuration");
   registerConfigInit(config, ctx);
   registerConfigSet(config, ctx);
@@ -1656,7 +1790,7 @@ async function main(argv) {
     return EXIT.GENERIC;
   }
 }
-var isEntry = process.argv[1] && (process.argv[1].endsWith("/index.ts") || process.argv[1].endsWith("/index.js") || process.argv[1].endsWith("\\index.ts") || process.argv[1].endsWith("\\index.js"));
+var isEntry = process.argv[1] && (process.argv[1].endsWith("/index.ts") || process.argv[1].endsWith("/index.js") || process.argv[1].endsWith("\\index.ts") || process.argv[1].endsWith("\\index.js") || process.argv[1].endsWith("/onebullex") || process.argv[1].endsWith("\\onebullex"));
 if (isEntry) {
   void main(process.argv).then((code) => process.exit(code));
 }

package/dist/lint-api.d.ts

@@ -25,7 +25,7 @@ declare function diffEndpoints(doc: readonly Endpoint[], cli: readonly Endpoint[
  * - GET / query table: 5 columns `参数 | 位置 | 类型 | 必填 | 说明`
  * - POST body table: 4 columns `字段 | 类型 | 必填 | 说明`
  */
-declare function parseDocParams(md: string, path: string): DocParam[];
+declare function parseDocParams(rawMd: string, path: string): DocParam[];
 /**
  * Parses a TS source string and returns commander positional/option flags as
  * `(name, required)` pairs. Positional `<x>` → required, `[x]` → optional;

package/dist/lint-api.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   REGISTRY
-} from "./chunk-PEVZEMJG.js";
+} from "./chunk-NMW73ILO.js";
 
 // scripts/check-cli-coverage.ts
 import { readFileSync } from "fs";
@@ -37,7 +37,8 @@ function diffEndpoints(doc, cli) {
 function escapeRegex(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function parseDocParams(md, path) {
+function parseDocParams(rawMd, path) {
+  const md = rawMd.replace(/\r\n/g, "\n");
   const headingRe = new RegExp(
     `####\\s+(?:GET|POST)\\s+${escapeRegex(path)}\\b`,
     "m"
@@ -130,20 +131,40 @@ var GLOBAL_FLAGS = /* @__PURE__ */ new Set([
 function normalize(name) {
   return name.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/_/g, "-").toLowerCase();
 }
+var CLI_DEFAULTED_PARAMS = /* @__PURE__ */ new Map([
+  // billNo is an idempotency key; cli/src/core/bill-no.ts generates one when
+  // the caller omits it.
+  ["POST /v2/balance/transfer", /* @__PURE__ */ new Set(["bill-no"])]
+]);
+var CLI_ONLY_PARAMS = /* @__PURE__ */ new Map([
+  // where to save the downloaded file; the API only sees downloadId
+  ["GET /v2/system/download", /* @__PURE__ */ new Set(["out"])]
+]);
+var CLI_POSITIONAL_ALIASES = /* @__PURE__ */ new Map([
+  ["GET /v2/entrust/plan-detail", /* @__PURE__ */ new Map([["id", "entrust-id"]])],
+  ["GET /v2/entrust/profit-detail", /* @__PURE__ */ new Map([["id", "profit-id"]])]
+]);
 function diffParams(endpoint, docParams, cliParams) {
   const errors = [];
+  const key = `${endpoint.method} ${endpoint.path}`;
+  const defaulted = CLI_DEFAULTED_PARAMS.get(key) ?? /* @__PURE__ */ new Set();
+  const cliOnly = CLI_ONLY_PARAMS.get(key) ?? /* @__PURE__ */ new Set();
+  const aliases = CLI_POSITIONAL_ALIASES.get(key) ?? /* @__PURE__ */ new Map();
   const docMap = new Map(
     docParams.map((p) => [normalize(p.name), p])
   );
-  const cliMap = new Map(
-    cliParams.filter((p) => !GLOBAL_FLAGS.has(p.name)).map((p) => [normalize(p.name), p])
-  );
+  const cliMap = /* @__PURE__ */ new Map();
+  for (const p of cliParams) {
+    if (GLOBAL_FLAGS.has(p.name) || cliOnly.has(p.name)) continue;
+    const mapped = aliases.get(p.name) ?? normalize(p.name);
+    cliMap.set(mapped, { name: mapped, required: p.required });
+  }
   for (const [k, dp] of docMap.entries()) {
     if (dp.required) {
       const cp = cliMap.get(k);
       if (!cp) {
         errors.push(`${endpoint.method} ${endpoint.path}: missing required CLI option --${k}`);
-      } else if (!cp.required) {
+      } else if (!cp.required && !defaulted.has(k)) {
         errors.push(
           `${endpoint.method} ${endpoint.path}: --${k} should be requiredOption (doc says \u5FC5\u586B=\u662F)`
         );

package/dist/registry.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   REGISTRY
-} from "./chunk-PEVZEMJG.js";
+} from "./chunk-NMW73ILO.js";
 export {
   REGISTRY
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onebullex-group/cli",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "description": "OneBullEx Open API V2 command-line interface",
   "license": "MIT",
   "type": "module",
@@ -16,6 +16,8 @@
     "./core/errors": "./dist/core/errors.js",
     "./core/signature": "./dist/core/signature.js",
     "./core/types": "./dist/core/types.js",
+    "./core/bill-no": "./dist/core/bill-no.js",
+    "./core/download": "./dist/core/download.js",
     "./core/redact": "./dist/core/redact.js"
   },
   "files": [