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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OKX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -4,6 +4,7 @@
 import { createRequire as createRequire2 } from "module";
 
 // ../core/dist/index.js
+import { ProxyAgent } from "undici";
 import { createHmac } from "crypto";
 import fs from "fs";
 import path from "path";
@@ -1063,9 +1064,13 @@ function vlog(message) {
 var OkxRestClient = class {
   config;
   rateLimiter;
+  dispatcher;
   constructor(config) {
     this.config = config;
     this.rateLimiter = new RateLimiter(3e4, config.verbose);
+    if (config.proxyUrl) {
+      this.dispatcher = new ProxyAgent(config.proxyUrl);
+    }
   }
   logRequest(method, url, auth) {
     if (!this.config.verbose) return;
@@ -1225,12 +1230,16 @@ var OkxRestClient = class {
     const t0 = Date.now();
     let response;
     try {
-      response = await fetch(url, {
+      const fetchOptions = {
         method: reqConfig.method,
         headers,
         body: reqConfig.method === "POST" ? bodyJson : void 0,
         signal: AbortSignal.timeout(this.config.timeoutMs)
-      });
+      };
+      if (this.dispatcher) {
+        fetchOptions.dispatcher = this.dispatcher;
+      }
+      response = await fetch(url, fetchOptions);
     } catch (error) {
       if (this.config.verbose) {
         const elapsed2 = Date.now() - t0;
@@ -1982,7 +1991,7 @@ function registerAlgoTradeTools() {
           },
           sz: {
             type: "string",
-            description: "Contracts to close"
+            description: "Number of contracts to close (NOT USDT amount). Use market_get_instruments to get ctVal for conversion."
           },
           tpTriggerPx: {
             type: "string",
@@ -2077,7 +2086,7 @@ function registerAlgoTradeTools() {
           },
           sz: {
             type: "string",
-            description: "Contracts"
+            description: "Number of contracts (NOT USDT amount). Use market_get_instruments to get ctVal for conversion."
           },
           callbackRatio: {
             type: "string",
@@ -3174,7 +3183,7 @@ function registerFuturesTools() {
           },
           sz: {
             type: "string",
-            description: "Contracts"
+            description: "Number of contracts (NOT USDT amount). Use market_get_instruments to get ctVal for conversion."
           },
           px: {
             type: "string",
@@ -4284,7 +4293,7 @@ function registerOptionTools() {
           },
           sz: {
             type: "string",
-            description: "Number of contracts"
+            description: "Number of contracts (NOT USDT amount). Use market_get_instruments to get ctVal for conversion."
           },
           px: {
             type: "string",
@@ -4391,7 +4400,7 @@ function registerOptionTools() {
           instId: { type: "string", description: "e.g. BTC-USD-241227-50000-C" },
           ordId: { type: "string" },
           clOrdId: { type: "string" },
-          newSz: { type: "string", description: "New quantity (contracts)" },
+          newSz: { type: "string", description: "New number of contracts (NOT USDT amount)" },
           newPx: { type: "string", description: "New price" }
         },
         required: ["instId"]
@@ -5353,7 +5362,7 @@ function registerSwapTradeTools() {
           },
           sz: {
             type: "string",
-            description: "Contracts (e.g. '1'; BTC-USDT-SWAP: 1ct=0.01 BTC)"
+            description: "Number of contracts (NOT USDT amount). Use market_get_instruments to get ctVal for conversion."
           },
           px: {
             type: "string",
@@ -5618,7 +5627,7 @@ function registerSwapTradeTools() {
         properties: {
           instId: { type: "string", description: "e.g. BTC-USDT-SWAP" },
           algoId: { type: "string", description: "Algo order ID" },
-          newSz: { type: "string", description: "New quantity (contracts)" },
+          newSz: { type: "string", description: "New number of contracts (NOT USDT amount)" },
           newTpTriggerPx: { type: "string", description: "New TP trigger price" },
           newTpOrdPx: { type: "string", description: "New TP order price; -1=market" },
           newSlTriggerPx: { type: "string", description: "New SL trigger price" },
@@ -6095,6 +6104,13 @@ function loadConfig(cli) {
       "Set OKX_TIMEOUT_MS as a positive integer in milliseconds."
     );
   }
+  const rawProxyUrl = toml.proxy_url?.trim();
+  if (rawProxyUrl && !rawProxyUrl.startsWith("http://") && !rawProxyUrl.startsWith("https://")) {
+    throw new ConfigError(
+      `Invalid proxy URL "${rawProxyUrl}".`,
+      "proxy_url must start with http:// or https://. SOCKS proxies are not supported."
+    );
+  }
   return {
     ...creds,
     baseUrl,
@@ -6105,6 +6121,7 @@ function loadConfig(cli) {
     site,
     userAgent: cli.userAgent,
     sourceTag: cli.sourceTag ?? DEFAULT_SOURCE_TAG,
+    proxyUrl: rawProxyUrl || void 0,
     verbose: cli.verbose ?? false
   };
 }
@@ -6338,7 +6355,7 @@ function readCliVersion() {
   return "0.0.0";
 }
 var CLI_VERSION = readCliVersion();
-var GIT_HASH = true ? "7777cc2" : "dev";
+var GIT_HASH = true ? "4427916" : "dev";
 var Report = class {
   lines = [];
   add(key, value) {
@@ -9380,7 +9397,7 @@ function cmdOnchainEarnOrderHistory(run, v) {
 // src/index.ts
 var _require2 = createRequire2(import.meta.url);
 var CLI_VERSION2 = _require2("../package.json").version;
-var GIT_HASH2 = true ? "7777cc2" : "dev";
+var GIT_HASH2 = true ? "4427916" : "dev";
 function handleConfigCommand(action, rest, json, lang, force) {
   if (action === "init") return cmdConfigInit(lang === "zh" ? "zh" : "en");
   if (action === "show") return cmdConfigShow(json);