@okx_ai/okx-trade-cli 1.2.9 → 1.3.0-beta.1

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

@@ -1503,14 +1503,137 @@ var INDICATOR_BARS = [
   "1Wutc"
 ];
 var INDICATOR_CODE_OVERRIDES = {
+  // Aliases
+  "boll": "BB",
+  // server supports BB not BOLL
+  // Names where default rule produces underscores but backend uses no separator
   "rainbow": "BTCRAINBOW",
-  "range-filter": "RANGEFILTER",
+  // default: RAINBOW
   "stoch-rsi": "STOCHRSI",
-  "pi-cycle-top": "PI_CYCLE_TOP",
-  "pi-cycle-bottom": "PI_CYCLE_BOTTOM",
-  // boll is an alias for bb; server supports BB not BOLL
-  "boll": "BB"
+  // default: STOCH_RSI
+  "bull-engulf": "BULLENGULF",
+  // default: BULL_ENGULF
+  "bear-engulf": "BEARENGULF",
+  // default: BEAR_ENGULF
+  "bull-harami": "BULLHARAMI",
+  // default: BULL_HARAMI
+  "bear-harami": "BEARHARAMI",
+  // default: BEAR_HARAMI
+  "bull-harami-cross": "BULLHARAMICROSS",
+  // default: BULL_HARAMI_CROSS
+  "bear-harami-cross": "BEARHARAMICROSS",
+  // default: BEAR_HARAMI_CROSS
+  "three-soldiers": "THREESOLDIERS",
+  // default: THREE_SOLDIERS
+  "three-crows": "THREECROWS",
+  // default: THREE_CROWS
+  "hanging-man": "HANGINGMAN",
+  // default: HANGING_MAN
+  "inverted-hammer": "INVERTEDH",
+  // default: INVERTED_HAMMER (backend uses INVERTEDH)
+  "shooting-star": "SHOOTINGSTAR",
+  // default: SHOOTING_STAR
+  "nvi-pvi": "NVIPVI",
+  // default: NVI_PVI
+  "top-long-short": "TOPLONGSHORT"
+  // default: TOP_LONG_SHORT
+  // Note: range-filter → RANGE_FILTER is correct via the default rule; no override needed.
 };
+var KNOWN_INDICATORS = [
+  // Moving Averages
+  { name: "ma", description: "Simple Moving Average" },
+  { name: "ema", description: "Exponential Moving Average" },
+  { name: "wma", description: "Weighted Moving Average" },
+  { name: "dema", description: "Double Exponential Moving Average" },
+  { name: "tema", description: "Triple Exponential Moving Average" },
+  { name: "zlema", description: "Zero-Lag Exponential Moving Average" },
+  { name: "hma", description: "Hull Moving Average" },
+  { name: "kama", description: "Kaufman Adaptive Moving Average" },
+  // Trend
+  { name: "macd", description: "MACD" },
+  { name: "sar", description: "Parabolic SAR" },
+  { name: "adx", description: "Average Directional Index" },
+  { name: "aroon", description: "Aroon Indicator" },
+  { name: "cci", description: "Commodity Channel Index" },
+  { name: "dpo", description: "Detrended Price Oscillator" },
+  { name: "envelope", description: "Envelope" },
+  { name: "halftrend", description: "HalfTrend" },
+  { name: "alphatrend", description: "AlphaTrend" },
+  // Momentum
+  { name: "rsi", description: "Relative Strength Index" },
+  { name: "stoch-rsi", description: "Stochastic RSI" },
+  { name: "stoch", description: "Stochastic Oscillator" },
+  { name: "roc", description: "Rate of Change" },
+  { name: "mom", description: "Momentum" },
+  { name: "ppo", description: "Price Percentage Oscillator" },
+  { name: "trix", description: "TRIX" },
+  { name: "ao", description: "Awesome Oscillator" },
+  { name: "uo", description: "Ultimate Oscillator" },
+  { name: "wr", description: "Williams %R" },
+  // Volatility
+  { name: "bb", description: "Bollinger Bands" },
+  { name: "boll", description: "Bollinger Bands (alias for bb)" },
+  { name: "bbwidth", description: "Bollinger Band Width" },
+  { name: "bbpct", description: "Bollinger Band %B" },
+  { name: "atr", description: "Average True Range" },
+  { name: "keltner", description: "Keltner Channel" },
+  { name: "donchian", description: "Donchian Channel" },
+  { name: "hv", description: "Historical Volatility" },
+  { name: "stddev", description: "Standard Deviation" },
+  // Volume
+  { name: "obv", description: "On-Balance Volume" },
+  { name: "vwap", description: "Volume Weighted Average Price" },
+  { name: "mvwap", description: "Moving VWAP" },
+  { name: "cmf", description: "Chaikin Money Flow" },
+  { name: "mfi", description: "Money Flow Index" },
+  { name: "ad", description: "Accumulation/Distribution" },
+  // Statistical
+  { name: "lr", description: "Linear Regression" },
+  { name: "slope", description: "Linear Regression Slope" },
+  { name: "angle", description: "Linear Regression Angle" },
+  { name: "variance", description: "Variance" },
+  { name: "meandev", description: "Mean Deviation" },
+  { name: "sigma", description: "Sigma" },
+  { name: "stderr", description: "Standard Error" },
+  // Custom
+  { name: "kdj", description: "KDJ Stochastic Oscillator" },
+  { name: "supertrend", description: "Supertrend" },
+  // Ichimoku
+  { name: "tenkan", description: "Ichimoku Tenkan-sen (Conversion Line)" },
+  { name: "kijun", description: "Ichimoku Kijun-sen (Base Line)" },
+  { name: "senkoa", description: "Ichimoku Senkou Span A (Leading Span A)" },
+  { name: "senkob", description: "Ichimoku Senkou Span B (Leading Span B)" },
+  { name: "chikou", description: "Ichimoku Chikou Span (Lagging Span)" },
+  // Candlestick Patterns
+  { name: "doji", description: "Doji candlestick pattern" },
+  { name: "bull-engulf", description: "Bullish Engulfing pattern" },
+  { name: "bear-engulf", description: "Bearish Engulfing pattern" },
+  { name: "bull-harami", description: "Bullish Harami pattern" },
+  { name: "bear-harami", description: "Bearish Harami pattern" },
+  { name: "bull-harami-cross", description: "Bullish Harami Cross pattern" },
+  { name: "bear-harami-cross", description: "Bearish Harami Cross pattern" },
+  { name: "three-soldiers", description: "Three White Soldiers pattern" },
+  { name: "three-crows", description: "Three Black Crows pattern" },
+  { name: "hanging-man", description: "Hanging Man pattern" },
+  { name: "inverted-hammer", description: "Inverted Hammer pattern" },
+  { name: "shooting-star", description: "Shooting Star pattern" },
+  // Bitcoin On-Chain
+  { name: "ahr999", description: "AHR999 Bitcoin accumulation index" },
+  { name: "rainbow", description: "Bitcoin Rainbow Chart" },
+  // Other
+  { name: "fisher", description: "Fisher Transform" },
+  { name: "nvi-pvi", description: "Negative/Positive Volume Index (returns both)" },
+  { name: "pmax", description: "PMAX" },
+  { name: "qqe", description: "QQE Mod" },
+  { name: "tdi", description: "Traders Dynamic Index" },
+  { name: "waddah", description: "Waddah Attar Explosion" },
+  { name: "range-filter", description: "Range Filter" },
+  { name: "cho", description: "Chande Momentum Oscillator" },
+  { name: "tr", description: "True Range" },
+  { name: "tp", description: "Typical Price" },
+  { name: "mp", description: "Median Price" },
+  { name: "top-long-short", description: "Top Trader Long/Short Ratio (timeframe-independent)" }
+];
 function resolveIndicatorCode(name) {
   const lower = name.toLowerCase();
   return INDICATOR_CODE_OVERRIDES[lower] ?? name.toUpperCase().replace(/-/g, "_");
@@ -1537,7 +1660,7 @@ function registerIndicatorTools() {
           },
           indicator: {
             type: "string",
-            description: "Indicator name (case-insensitive). Examples: ma, ema, rsi, macd, bb, kdj, supertrend, ahr999, rainbow, pi-cycle-top, pi-cycle-bottom, mayer, envelope, halftrend, alphatrend, pmax, waddah, tdi, qqe, range-filter"
+            description: "Indicator name (case-insensitive). Call market_list_indicators to see all supported names."
           },
           bar: {
             type: "string",
@@ -1594,6 +1717,14 @@ function registerIndicatorTools() {
         );
         return normalizeResponse(response);
       }
+    },
+    {
+      name: "market_list_indicators",
+      module: "market",
+      description: "List all supported technical indicator names and descriptions. Call this before market_get_indicator to discover valid indicator names. No credentials required.",
+      isWrite: false,
+      inputSchema: { type: "object", properties: {} },
+      handler: async () => ({ data: KNOWN_INDICATORS })
     }
   ];
 }
@@ -7770,6 +7901,10 @@ var activeOutput = stdioOutput;
 function setOutput(impl) {
   activeOutput = impl;
 }
+var envContext = null;
+function setEnvContext(ctx) {
+  envContext = ctx;
+}
 function output(message) {
   activeOutput.out(message);
 }
@@ -7783,9 +7918,18 @@ function errorLine(message) {
   activeOutput.err(message + EOL);
 }
 function printJson(data) {
-  activeOutput.out(JSON.stringify(data, null, 2) + EOL);
+  const payload = envContext ? {
+    env: envContext.demo ? "demo" : "live",
+    profile: envContext.profile,
+    data
+  } : data;
+  activeOutput.out(JSON.stringify(payload, null, 2) + EOL);
 }
 function printTable(rows) {
+  if (envContext) {
+    const envLabel = envContext.demo ? "demo (simulated trading)" : "live";
+    activeOutput.out(`Environment: ${envLabel}` + EOL + EOL);
+  }
   if (rows.length === 0) {
     activeOutput.out("(no data)" + EOL);
     return;
@@ -8364,7 +8508,7 @@ async function cmdDiagnoseMcp(options = {}) {
 
 // src/commands/diagnose.ts
 var CLI_VERSION = readCliVersion();
-var GIT_HASH = true ? "f1f0625" : "dev";
+var GIT_HASH = true ? "ab11ece" : "dev";
 function maskKey2(key) {
   if (!key) return "(not set)";
   if (key.length <= 8) return "****";
@@ -9896,6 +10040,10 @@ async function cmdMarketCandles(run, instId, opts) {
     }))
   );
 }
+function cmdMarketIndicatorList(json) {
+  if (json) return printJson(KNOWN_INDICATORS);
+  printTable(KNOWN_INDICATORS.map(({ name, description }) => ({ name, description })));
+}
 async function cmdMarketIndicator(run, indicator, instId, opts) {
   const params = opts.params ? opts.params.split(",").map((p) => Number(p.trim())).filter((n) => !Number.isNaN(n)) : void 0;
   const result = await run("market_get_indicator", {
@@ -12568,7 +12716,7 @@ function printSkillInstallResult(meta, json) {
 // src/index.ts
 var _require3 = createRequire3(import.meta.url);
 var CLI_VERSION2 = _require3("../package.json").version;
-var GIT_HASH2 = true ? "f1f0625" : "dev";
+var GIT_HASH2 = true ? "ab11ece" : "dev";
 function handleConfigCommand(action, rest, json, lang, force) {
   if (action === "init") return cmdConfigInit(lang === "zh" ? "zh" : "en");
   if (action === "show") return cmdConfigShow(json);
@@ -12618,18 +12766,20 @@ function handleMarketPublicCommand(run, action, rest, v, json) {
       instId: v.instId,
       json
     });
-  if (action === "indicator") {
-    const limit = v.limit !== void 0 ? Number(v.limit) : void 0;
-    const backtestTime = v["backtest-time"] !== void 0 ? Number(v["backtest-time"]) : void 0;
-    return cmdMarketIndicator(run, rest[0], rest[1], {
-      bar: v.bar,
-      params: v.params,
-      list: v.list,
-      limit,
-      backtestTime,
-      json
-    });
-  }
+  if (action === "indicator") return handleIndicatorAction(run, rest, v, json);
+}
+function handleIndicatorAction(run, rest, v, json) {
+  if (rest[0] === "list") return cmdMarketIndicatorList(json);
+  const limit = v.limit !== void 0 ? Number(v.limit) : void 0;
+  const backtestTime = v["backtest-time"] !== void 0 ? Number(v["backtest-time"]) : void 0;
+  return cmdMarketIndicator(run, rest[0], rest[1], {
+    bar: v.bar,
+    params: v.params,
+    list: v.list,
+    limit,
+    backtestTime,
+    json
+  });
 }
 function handleMarketDataCommand(run, action, rest, v, json) {
   const limit = v.limit !== void 0 ? Number(v.limit) : void 0;
@@ -13384,6 +13534,14 @@ function printHelpForLevel(positionals) {
   else if (!subgroup) printHelp(module);
   else printHelp(module, subgroup);
 }
+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" });
+  } catch {
+  }
+  return cmdDiagnose(config, v.profile ?? "default", { mcp: v.mcp, cli: v.cli, all: v.all, output: v.output });
+}
 async function main() {
   setOutput({
     out: (m) => process.stdout.write(m),
@@ -13405,15 +13563,9 @@ async function main() {
   if (module === "config") return handleConfigCommand(action, rest, json, v.lang, v.force);
   if (module === "setup") return handleSetupCommand(v);
   if (module === "upgrade") return cmdUpgrade(CLI_VERSION2, { beta: v.beta, check: v.check, force: v.force }, json);
-  if (module === "diagnose") {
-    let config2;
-    try {
-      config2 = loadProfileConfig({ profile: v.profile, demo: v.demo, live: v.live, verbose: v.verbose, userAgent: `okx-trade-cli/${CLI_VERSION2}`, sourceTag: "CLI" });
-    } catch {
-    }
-    return cmdDiagnose(config2, v.profile ?? "default", { mcp: v.mcp, cli: v.cli, all: v.all, output: v.output });
-  }
+  if (module === "diagnose") return runDiagnose(v);
   const config = loadProfileConfig({ profile: v.profile, demo: v.demo, live: v.live, verbose: v.verbose, userAgent: `okx-trade-cli/${CLI_VERSION2}`, sourceTag: "CLI" });
+  setEnvContext({ demo: config.demo, profile: v.profile ?? "default" });
   const client = new OkxRestClient(config);
   const baseRunner = createToolRunner(client, config);
   const writeToolNames = new Set(allToolSpecs().filter((t) => t.isWrite).map((t) => t.name));