@backtest-kit/cli 5.10.0 → 5.10.2

package/README.md

@@ -450,9 +450,10 @@ For projects that compile to or use CommonJS. Loaded via `require()`:
 | `--limit` | string | Number of candles to fetch (default: `250`) |
 | `--when` | string | End date for candle window — ISO 8601 or Unix ms (default: now) |
 | `--exchange` | string | Exchange name (default: first registered, falls back to CCXT Binance) |
-| `--json` | string | Write plots as a JSON array to a file (e.g. `--json=./output.json`) |
-| `--jsonl` | string | Write plots as JSONL (one row per line) to a file (e.g. `--jsonl=./output.jsonl`) |
-| `--markdown` | string | Write Markdown table to a file (e.g. `--markdown=./output.md`) |
+| `--output` | string | Output file base name without extension (default: `.pine` file name) |
+| `--json` | boolean | Write plots as a JSON array to `<pine-dir>/dump/{output}.json` |
+| `--jsonl` | boolean | Write plots as JSONL (one row per line) to `<pine-dir>/dump/{output}.jsonl` |
+| `--markdown` | boolean | Write Markdown table to `<pine-dir>/dump/{output}.md` |
 
 **Important:** `limit` must cover indicator warmup bars — rows before warmup completes will show `N/A` 
 
@@ -470,7 +471,7 @@ The CLI looks for `modules/pine.module` in two locations (first match wins):
 ```
 my-project/
 ├── math/
-│   ├── master_trend_15m.pine         ← indicator
+│   ├── impulse_trend_15m.pine         ← indicator
 │   └── modules/
 │       └── pine.module.ts            ← loaded first (next to .pine file)
 ├── modules/
@@ -507,7 +508,7 @@ Before loading `pine.module`, the CLI loads `.env` files in the same order as fo
 my-project/
 ├── math/
 │   ├── .env                          ← loaded second (overrides root)
-│   └── master_trend_15m.pine
+│   └── impulse_trend_15m.pine
 ├── .env                              ← loaded first
 └── package.json
 ```
@@ -538,7 +539,7 @@ addExchangeSchema({
 Then run:
 
 ```bash
-npx @backtest-kit/cli --pine ./math/master_trend_15m.pine \
+npx @backtest-kit/cli --pine ./math/impulse_trend_15m.pine \
   --exchange my-exchange \
   --symbol BTCUSDT \
   --timeframe 15m \
@@ -551,7 +552,7 @@ Or add it to `package.json`:
 ```json
 {
   "scripts": {
-    "pine": "npx @backtest-kit/cli --pine ./math/master_trend_15m.pine --symbol BTCUSDT --timeframe 15m --limit 180"
+    "pine": "npx @backtest-kit/cli --pine ./math/impulse_trend_15m.pine --symbol BTCUSDT --timeframe 15m --limit 180"
   }
 }
 ```
@@ -593,10 +594,115 @@ The CLI prints a Markdown table to stdout:
 | 112653.90 |  1.0000 | 2025-09-22T22:15:00.000Z |
 ```
 
-Redirect to a file to save the report:
+Save to `./math/dump/impulse_trend_15m.md` (uses `.pine` file name automatically, dump is created next to the `.pine` file):
 
 ```bash
-npm run pine > report.md
+npx @backtest-kit/cli --pine ./math/impulse_trend_15m.pine --markdown
+```
+
+Override the output name with `--output`:
+
+```bash
+npx @backtest-kit/cli --pine ./math/impulse_trend_15m.pine --jsonl --output feb2026_bb
+# → ./math/dump/feb2026_bb.jsonl
+```
+
+Print to stdout (no flag):
+
+```bash
+npx @backtest-kit/cli --pine ./math/impulse_trend_15m.pine
+```
+
+## 💾 Dumping Raw Candles
+
+`@backtest-kit/cli` can fetch raw OHLCV candles from any registered exchange and save them to a file — no strategy file required.
+
+### CLI Flags
+
+| Flag | Type | Description |
+|------|------|-------------|
+| `--dump` | boolean | Enable candle dump mode |
+| `--symbol` | string | Trading pair (default: `"BTCUSDT"`) |
+| `--timeframe` | string | Candle interval (default: `"15m"`) |
+| `--limit` | string | Number of candles to fetch (default: `250`) |
+| `--when` | string | End date for candle window — ISO 8601 or Unix ms (default: now) |
+| `--exchange` | string | Exchange name (default: first registered, falls back to CCXT Binance) |
+| `--output` | string | Output file base name without extension (default: `{SYMBOL}_{LIMIT}_{TIMEFRAME}_{TIMESTAMP}`) |
+| `--json` | boolean | Write candles as a JSON array to `./dump/{output}.json` |
+| `--jsonl` | boolean | Write candles as JSONL (one row per line) to `./dump/{output}.jsonl` |
+
+The `dump/` directory is created in the current working directory (where the CLI is invoked from).
+
+### Exchange via `dump.module`
+
+By default the CLI registers CCXT Binance automatically. To use a different exchange — or to configure API keys, custom rate limits, or a non-spot market — create a `modules/dump.module.ts` file. The CLI loads it automatically before fetching candles.
+
+The CLI looks for `modules/dump.module` in the current working directory
+
+```
+my-project/
+├── modules/
+│   └── dump.module.ts            ← exchange registration
+├── dump/                         ← auto-created: candle output files
+└── package.json
+```
+
+Inside `dump.module.ts` call `addExchangeSchema` from `backtest-kit`:
+
+```typescript
+// modules/dump.module.ts
+import { addExchangeSchema } from "backtest-kit";
+import ccxt from "ccxt";
+
+addExchangeSchema({
+  exchangeName: "my-exchange",
+  getCandles: async (symbol, interval, since, limit) => {
+    const exchange = new ccxt.bybit({ enableRateLimit: true });
+    const ohlcv = await exchange.fetchOHLCV(symbol, interval, since.getTime(), limit);
+    return ohlcv.map(([timestamp, open, high, low, close, volume]) => ({
+      timestamp, open, high, low, close, volume,
+    }));
+  },
+  formatPrice: (symbol, price) => price.toFixed(2),
+  formatQuantity: (symbol, quantity) => quantity.toFixed(8),
+});
+```
+
+### Output
+
+Each candle row contains OHLCV fields. Print to stdout:
+
+```bash
+npx @backtest-kit/cli --dump --symbol BTCUSDT --timeframe 15m --limit 100
+```
+
+Save to `./dump/BTCUSDT_100_15m_{timestamp}.jsonl`:
+
+```bash
+npx @backtest-kit/cli --dump --symbol BTCUSDT --timeframe 15m --limit 100 --jsonl
+```
+
+Fetch candles up to a specific date with `--when` and override the file name with `--output`:
+
+```bash
+npx @backtest-kit/cli --dump --symbol BTCUSDT --timeframe 15m --limit 500 \
+  --when "2026-02-28T00:00:00.000Z" \
+  --jsonl --output feb2026_btc
+# → ./dump/feb2026_btc.jsonl
+```
+
+Or add it to `package.json`:
+
+```json
+{
+  "scripts": {
+    "dump": "npx @backtest-kit/cli --dump --symbol BTCUSDT --timeframe 15m --limit 500 --jsonl"
+  }
+}
+```
+
+```bash
+npx @backtest-kit/cli --dump --symbol BTCUSDT --timeframe 15m --limit 500 --jsonl
 ```
 
 ## 🌍 Environment Variables

package/build/index.cjs

@@ -507,6 +507,10 @@ const getArgs = functoolsKit.singleshot(() => {
                 type: "boolean",
                 default: false,
             },
+            dump: {
+                type: "boolean",
+                default: false,
+            },
             timeframe: {
                 type: "string",
                 default: "",
@@ -519,17 +523,21 @@ const getArgs = functoolsKit.singleshot(() => {
                 type: "string",
                 default: "",
             },
-            json: {
+            output: {
                 type: "string",
                 default: "",
             },
+            json: {
+                type: "boolean",
+                default: false,
+            },
             jsonl: {
-                type: "string",
-                default: "",
+                type: "boolean",
+                default: false,
             },
             markdown: {
-                type: "string",
-                default: "",
+                type: "boolean",
+                default: false,
             },
         },
         strict: false,
@@ -2198,7 +2206,7 @@ const BEFORE_EXIT_FN$4 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$4 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$4);
 });
-const main$5 = async () => {
+const main$6 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -2209,7 +2217,7 @@ const main$5 = async () => {
     await cli.backtestMainService.connect();
     listenGracefulShutdown$4();
 };
-main$5();
+main$6();
 
 const BEFORE_EXIT_FN$3 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$3);
@@ -2230,7 +2238,7 @@ const BEFORE_EXIT_FN$3 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$3 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$3);
 });
-const main$4 = async () => {
+const main$5 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -2241,7 +2249,7 @@ const main$4 = async () => {
     cli.paperMainService.connect();
     listenGracefulShutdown$3();
 };
-main$4();
+main$5();
 
 const BEFORE_EXIT_FN$2 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$2);
@@ -2262,7 +2270,7 @@ const BEFORE_EXIT_FN$2 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$2 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$2);
 });
-const main$3 = async () => {
+const main$4 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -2273,7 +2281,7 @@ const main$3 = async () => {
     await cli.liveMainService.connect();
     listenGracefulShutdown$2();
 };
-main$3();
+main$4();
 
 const BEFORE_EXIT_FN$1 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$1);
@@ -2283,7 +2291,7 @@ const BEFORE_EXIT_FN$1 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$1 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$1);
 });
-const main$2 = async () => {
+const main$3 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -2293,7 +2301,7 @@ const main$2 = async () => {
     }
     listenGracefulShutdown$1();
 };
-main$2();
+main$3();
 
 const BEFORE_EXIT_FN = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN);
@@ -2303,7 +2311,7 @@ const BEFORE_EXIT_FN = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN);
 });
-const main$1 = async () => {
+const main$2 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -2313,7 +2321,7 @@ const main$1 = async () => {
     }
     listenGracefulShutdown();
 };
-main$1();
+main$2();
 
 const EXTRACT_ROWS_FN = (plots, schema) => {
     const keys = Object.keys(schema);
@@ -2335,7 +2343,7 @@ const EXTRACT_ROWS_FN = (plots, schema) => {
     }
     return rows;
 };
-const main = async () => {
+const main$1 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -2380,25 +2388,80 @@ const main = async () => {
         return true;
     }))
         .map((key) => [key, key]));
-    const jsonPath = values.json;
-    if (jsonPath) {
+    const dumpName = values.output || path.basename(entryPoint, path.extname(entryPoint));
+    const dumpDir = path.join(process.cwd(), "dump");
+    if (values.json) {
         const rows = EXTRACT_ROWS_FN(plots, signalSchema);
-        await fs$1.writeFile(jsonPath, JSON.stringify(rows, null, 2), "utf-8");
+        const filePath = path.resolve(dumpDir, `${dumpName}.json`);
+        await fs$1.mkdir(dumpDir, { recursive: true });
+        await fs$1.writeFile(filePath, JSON.stringify(rows, null, 2), "utf-8");
+        console.log(`Saved: ${filePath}`);
         return;
     }
-    const jsonlPath = values.jsonl;
-    if (jsonlPath) {
+    if (values.jsonl) {
         const rows = EXTRACT_ROWS_FN(plots, signalSchema);
-        await fs$1.writeFile(jsonlPath, rows.map((r) => JSON.stringify(r)).join("\n"), "utf-8");
+        const filePath = path.resolve(dumpDir, `${dumpName}.jsonl`);
+        await fs$1.mkdir(dumpDir, { recursive: true });
+        await fs$1.writeFile(filePath, rows.map((r) => JSON.stringify(r)).join("\n"), "utf-8");
+        console.log(`Saved: ${filePath}`);
         return;
     }
-    const markdownPath = values.markdown;
-    if (markdownPath) {
-        await fs$1.writeFile(markdownPath, await BacktestKitPinets.toMarkdown(signalId, plots, signalSchema), "utf-8");
+    if (values.markdown) {
+        const filePath = path.resolve(dumpDir, `${dumpName}.md`);
+        await fs$1.mkdir(dumpDir, { recursive: true });
+        await fs$1.writeFile(filePath, await BacktestKitPinets.toMarkdown(signalId, plots, signalSchema), "utf-8");
+        console.log(`Saved: ${filePath}`);
         return;
     }
     console.log(await BacktestKitPinets.toMarkdown(signalId, plots, signalSchema));
 };
+main$1();
+
+const main = async () => {
+    if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
+        return;
+    }
+    const { values } = getArgs();
+    if (!values.dump) {
+        return;
+    }
+    await cli.moduleConnectionService.loadModule("./dump.module");
+    {
+        await cli.exchangeSchemaService.addSchema();
+        await cli.symbolSchemaService.addSchema();
+    }
+    const [defaultExchangeName = null] = await BacktestKit.listExchangeSchema();
+    const exchangeName = values.exchange || defaultExchangeName?.exchangeName;
+    const symbol = values.symbol || "BTCUSDT";
+    const timeframe = values.timeframe || "15m";
+    const limitStr = values.limit || "250";
+    const limitNum = parseInt(limitStr);
+    const limit = isNaN(limitNum) ? 250 : limitNum;
+    const whenStr = values.when || Date.now().toString();
+    const whenStamp = Date.parse(whenStr);
+    const when = isNaN(whenStamp) ? new Date() : new Date(whenStamp);
+    const timestamp = BacktestKit.alignToInterval(when, timeframe).getTime();
+    const candles = await BacktestKit.Exchange.getRawCandles(symbol, timeframe, {
+        exchangeName,
+    }, limit, undefined, timestamp);
+    const dumpName = values.output || `${symbol}_${limit}_${timeframe}_${timestamp}`;
+    const dumpDir = path.join(process.cwd(), "dump");
+    if (values.json) {
+        const filePath = path.resolve(dumpDir, `${dumpName}.json`);
+        await fs$1.mkdir(dumpDir, { recursive: true });
+        await fs$1.writeFile(filePath, JSON.stringify(candles, null, 2), "utf-8");
+        console.log(`Saved: ${filePath}`);
+        return;
+    }
+    if (values.jsonl) {
+        const filePath = path.resolve(dumpDir, `${dumpName}.jsonl`);
+        await fs$1.mkdir(dumpDir, { recursive: true });
+        await fs$1.writeFile(filePath, candles.map((r) => JSON.stringify(r)).join("\n"), "utf-8");
+        console.log(`Saved: ${filePath}`);
+        return;
+    }
+    console.log(JSON.stringify(candles, null, 2));
+};
 main();
 
 function setLogger(logger) {

package/build/index.mjs

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import * as BacktestKit from 'backtest-kit';
-import { Storage, Notification, Markdown, Report, Dump, Memory, StorageLive, StorageBacktest, NotificationLive, NotificationBacktest, setConfig, Log, listExchangeSchema, addExchangeSchema, roundTicks, listFrameSchema, addFrameSchema, listenDoneLive, listenDoneBacktest, shutdown, listenSignal, listStrategySchema, overrideExchangeSchema, Backtest, Live, getCandles, checkCandles, warmCandles, listenRisk, listenStrategyCommit, listenSync } from 'backtest-kit';
+import { Storage, Notification, Markdown, Report, Dump, Memory, StorageLive, StorageBacktest, NotificationLive, NotificationBacktest, setConfig, Log, listExchangeSchema, addExchangeSchema, roundTicks, listFrameSchema, addFrameSchema, listenDoneLive, listenDoneBacktest, shutdown, listenSignal, listStrategySchema, overrideExchangeSchema, Backtest, Live, getCandles, checkCandles, warmCandles, listenRisk, listenStrategyCommit, listenSync, alignToInterval, Exchange } from 'backtest-kit';
 import { getErrorMessage, errorData, singleshot, str, BehaviorSubject, compose, execpool, queued, sleep, randomString, createAwaiter, TIMEOUT_SYMBOL, typo, retry, trycatch, memoize } from 'functools-kit';
 import fs, { constants } from 'fs';
 import * as stackTrace from 'stack-trace';
-import path from 'path';
-import fs$1, { access, readFile, writeFile } from 'fs/promises';
+import path, { basename, extname, join, resolve } from 'path';
+import fs$1, { access, readFile, mkdir, writeFile } from 'fs/promises';
 import dotenv from 'dotenv';
 import { createActivator } from 'di-kit';
 import { fileURLToPath } from 'url';
@@ -482,6 +482,10 @@ const getArgs = singleshot(() => {
                 type: "boolean",
                 default: false,
             },
+            dump: {
+                type: "boolean",
+                default: false,
+            },
             timeframe: {
                 type: "string",
                 default: "",
@@ -494,17 +498,21 @@ const getArgs = singleshot(() => {
                 type: "string",
                 default: "",
             },
-            json: {
+            output: {
                 type: "string",
                 default: "",
             },
+            json: {
+                type: "boolean",
+                default: false,
+            },
             jsonl: {
-                type: "string",
-                default: "",
+                type: "boolean",
+                default: false,
             },
             markdown: {
-                type: "string",
-                default: "",
+                type: "boolean",
+                default: false,
             },
         },
         strict: false,
@@ -2169,7 +2177,7 @@ const BEFORE_EXIT_FN$4 = singleshot(async () => {
 const listenGracefulShutdown$4 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$4);
 });
-const main$5 = async () => {
+const main$6 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2180,7 +2188,7 @@ const main$5 = async () => {
     await cli.backtestMainService.connect();
     listenGracefulShutdown$4();
 };
-main$5();
+main$6();
 
 const BEFORE_EXIT_FN$3 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$3);
@@ -2201,7 +2209,7 @@ const BEFORE_EXIT_FN$3 = singleshot(async () => {
 const listenGracefulShutdown$3 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$3);
 });
-const main$4 = async () => {
+const main$5 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2212,7 +2220,7 @@ const main$4 = async () => {
     cli.paperMainService.connect();
     listenGracefulShutdown$3();
 };
-main$4();
+main$5();
 
 const BEFORE_EXIT_FN$2 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$2);
@@ -2233,7 +2241,7 @@ const BEFORE_EXIT_FN$2 = singleshot(async () => {
 const listenGracefulShutdown$2 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$2);
 });
-const main$3 = async () => {
+const main$4 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2244,7 +2252,7 @@ const main$3 = async () => {
     await cli.liveMainService.connect();
     listenGracefulShutdown$2();
 };
-main$3();
+main$4();
 
 const BEFORE_EXIT_FN$1 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$1);
@@ -2254,7 +2262,7 @@ const BEFORE_EXIT_FN$1 = singleshot(async () => {
 const listenGracefulShutdown$1 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$1);
 });
-const main$2 = async () => {
+const main$3 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2264,7 +2272,7 @@ const main$2 = async () => {
     }
     listenGracefulShutdown$1();
 };
-main$2();
+main$3();
 
 const BEFORE_EXIT_FN = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN);
@@ -2274,7 +2282,7 @@ const BEFORE_EXIT_FN = singleshot(async () => {
 const listenGracefulShutdown = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN);
 });
-const main$1 = async () => {
+const main$2 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2284,7 +2292,7 @@ const main$1 = async () => {
     }
     listenGracefulShutdown();
 };
-main$1();
+main$2();
 
 const EXTRACT_ROWS_FN = (plots, schema) => {
     const keys = Object.keys(schema);
@@ -2306,7 +2314,7 @@ const EXTRACT_ROWS_FN = (plots, schema) => {
     }
     return rows;
 };
-const main = async () => {
+const main$1 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2351,25 +2359,80 @@ const main = async () => {
         return true;
     }))
         .map((key) => [key, key]));
-    const jsonPath = values.json;
-    if (jsonPath) {
+    const dumpName = values.output || basename(entryPoint, extname(entryPoint));
+    const dumpDir = join(process.cwd(), "dump");
+    if (values.json) {
         const rows = EXTRACT_ROWS_FN(plots, signalSchema);
-        await writeFile(jsonPath, JSON.stringify(rows, null, 2), "utf-8");
+        const filePath = resolve(dumpDir, `${dumpName}.json`);
+        await mkdir(dumpDir, { recursive: true });
+        await writeFile(filePath, JSON.stringify(rows, null, 2), "utf-8");
+        console.log(`Saved: ${filePath}`);
         return;
     }
-    const jsonlPath = values.jsonl;
-    if (jsonlPath) {
+    if (values.jsonl) {
         const rows = EXTRACT_ROWS_FN(plots, signalSchema);
-        await writeFile(jsonlPath, rows.map((r) => JSON.stringify(r)).join("\n"), "utf-8");
+        const filePath = resolve(dumpDir, `${dumpName}.jsonl`);
+        await mkdir(dumpDir, { recursive: true });
+        await writeFile(filePath, rows.map((r) => JSON.stringify(r)).join("\n"), "utf-8");
+        console.log(`Saved: ${filePath}`);
         return;
     }
-    const markdownPath = values.markdown;
-    if (markdownPath) {
-        await writeFile(markdownPath, await toMarkdown(signalId, plots, signalSchema), "utf-8");
+    if (values.markdown) {
+        const filePath = resolve(dumpDir, `${dumpName}.md`);
+        await mkdir(dumpDir, { recursive: true });
+        await writeFile(filePath, await toMarkdown(signalId, plots, signalSchema), "utf-8");
+        console.log(`Saved: ${filePath}`);
         return;
     }
     console.log(await toMarkdown(signalId, plots, signalSchema));
 };
+main$1();
+
+const main = async () => {
+    if (!getEntry(import.meta.url)) {
+        return;
+    }
+    const { values } = getArgs();
+    if (!values.dump) {
+        return;
+    }
+    await cli.moduleConnectionService.loadModule("./dump.module");
+    {
+        await cli.exchangeSchemaService.addSchema();
+        await cli.symbolSchemaService.addSchema();
+    }
+    const [defaultExchangeName = null] = await listExchangeSchema();
+    const exchangeName = values.exchange || defaultExchangeName?.exchangeName;
+    const symbol = values.symbol || "BTCUSDT";
+    const timeframe = values.timeframe || "15m";
+    const limitStr = values.limit || "250";
+    const limitNum = parseInt(limitStr);
+    const limit = isNaN(limitNum) ? 250 : limitNum;
+    const whenStr = values.when || Date.now().toString();
+    const whenStamp = Date.parse(whenStr);
+    const when = isNaN(whenStamp) ? new Date() : new Date(whenStamp);
+    const timestamp = alignToInterval(when, timeframe).getTime();
+    const candles = await Exchange.getRawCandles(symbol, timeframe, {
+        exchangeName,
+    }, limit, undefined, timestamp);
+    const dumpName = values.output || `${symbol}_${limit}_${timeframe}_${timestamp}`;
+    const dumpDir = join(process.cwd(), "dump");
+    if (values.json) {
+        const filePath = resolve(dumpDir, `${dumpName}.json`);
+        await mkdir(dumpDir, { recursive: true });
+        await writeFile(filePath, JSON.stringify(candles, null, 2), "utf-8");
+        console.log(`Saved: ${filePath}`);
+        return;
+    }
+    if (values.jsonl) {
+        const filePath = resolve(dumpDir, `${dumpName}.jsonl`);
+        await mkdir(dumpDir, { recursive: true });
+        await writeFile(filePath, candles.map((r) => JSON.stringify(r)).join("\n"), "utf-8");
+        console.log(`Saved: ${filePath}`);
+        return;
+    }
+    console.log(JSON.stringify(candles, null, 2));
+};
 main();
 
 function setLogger(logger) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/cli",
-  "version": "5.10.0",
+  "version": "5.10.2",
   "description": "Zero-boilerplate CLI runner for backtest-kit strategies. Run backtests, paper trading, and live bots with candle cache warming, web dashboard, and Telegram notifications — no setup code required.",
   "author": {
     "name": "Petr Tripolsky",