perp-cli 0.4.0 → 0.4.8

package/dist/commands/pnl.js

@@ -0,0 +1,243 @@
+/**
+ * PnL Tracker CLI commands.
+ *
+ * perp pnl snapshot  — take one-time equity snapshots across exchanges
+ * perp pnl track     — continuous equity tracking (foreground)
+ * perp pnl daily     — daily PnL breakdown table
+ * perp pnl weekly    — weekly PnL breakdown table
+ * perp pnl summary   — performance summary (Sharpe, drawdown, win rate)
+ */
+import chalk from "chalk";
+import { printJson, jsonOk, jsonError, makeTable, formatUsd, formatPnl, withJsonErrors } from "../utils.js";
+import { saveEquitySnapshot, readEquityHistory, computePnlMetrics, computeDailyPnl, aggregateWeekly, } from "../equity-tracker.js";
+const EXCHANGES = ["pacifica", "hyperliquid", "lighter"];
+function parseSince(since) {
+    if (!since)
+        return undefined;
+    const match = since.match(/^(\d+)(h|d|w)$/);
+    if (match) {
+        const [, num, unit] = match;
+        const ms = { h: 3600000, d: 86400000, w: 604800000 }[unit] ?? 86400000;
+        return new Date(Date.now() - parseInt(num) * ms);
+    }
+    return new Date(since);
+}
+/** Take equity snapshot for given adapters. */
+async function takeSnapshot(getAdapterForExchange, exchanges) {
+    const ts = new Date().toISOString();
+    const snaps = [];
+    const results = await Promise.allSettled(exchanges.map(async (ex) => {
+        const adapter = await getAdapterForExchange(ex);
+        const [balance, positions] = await Promise.all([
+            adapter.getBalance(),
+            adapter.getPositions(),
+        ]);
+        const snap = {
+            ts,
+            exchange: ex,
+            equity: Number(balance.equity),
+            available: Number(balance.available),
+            marginUsed: Number(balance.marginUsed),
+            unrealizedPnl: Number(balance.unrealizedPnl),
+            positionCount: positions.filter(p => Number(p.size) > 0).length,
+        };
+        saveEquitySnapshot(snap);
+        return snap;
+    }));
+    for (const r of results) {
+        if (r.status === "fulfilled")
+            snaps.push(r.value);
+    }
+    return snaps;
+}
+export function registerPnlCommands(program, getAdapterForExchange, isJson) {
+    const pnl = program.command("pnl").description("PnL tracker — equity tracking & performance metrics");
+    // ── pnl snapshot ──
+    pnl
+        .command("snapshot")
+        .description("Take equity snapshot across all exchanges")
+        .option("--exchanges <list>", "Comma-separated exchange list", EXCHANGES.join(","))
+        .action(async (opts) => {
+        await withJsonErrors(isJson(), async () => {
+            const exchanges = opts.exchanges.split(",").map(e => e.trim());
+            const snaps = await takeSnapshot(getAdapterForExchange, exchanges);
+            if (isJson()) {
+                printJson(jsonOk({ snapshots: snaps }));
+            }
+            else {
+                const total = snaps.reduce((s, sn) => s + sn.equity, 0);
+                console.log(chalk.cyan.bold("Equity Snapshot\n"));
+                for (const s of snaps) {
+                    console.log(`  ${s.exchange.padEnd(14)} $${formatUsd(s.equity)}  ` +
+                        `avail $${formatUsd(s.available)}  ` +
+                        `uPnL ${formatPnl(s.unrealizedPnl)}  ` +
+                        `pos: ${s.positionCount}`);
+                }
+                console.log(`\n  ${"Total".padEnd(14)} $${formatUsd(total)}`);
+                console.log(chalk.gray(`\n  Saved at ${snaps[0]?.ts ?? "—"}`));
+            }
+        });
+    });
+    // ── pnl track ──
+    pnl
+        .command("track")
+        .description("Continuously track equity (foreground)")
+        .option("--interval <sec>", "Snapshot interval in seconds", "300")
+        .option("--exchanges <list>", "Comma-separated exchange list", EXCHANGES.join(","))
+        .action(async (opts) => {
+        const intervalMs = parseInt(opts.interval) * 1000;
+        const exchanges = opts.exchanges.split(",").map(e => e.trim());
+        console.log(chalk.cyan(`PnL tracker started — snapshot every ${opts.interval}s for [${exchanges.join(", ")}]`));
+        console.log(chalk.gray("Press Ctrl+C to stop\n"));
+        const controller = new AbortController();
+        process.on("SIGINT", () => controller.abort());
+        // Initial snapshot
+        const snaps = await takeSnapshot(getAdapterForExchange, exchanges);
+        const total = snaps.reduce((s, sn) => s + sn.equity, 0);
+        console.log(`${chalk.gray(new Date().toLocaleTimeString())} Total equity: $${formatUsd(total)}`);
+        while (!controller.signal.aborted) {
+            await new Promise((resolve) => {
+                const timer = setTimeout(resolve, intervalMs);
+                controller.signal.addEventListener("abort", () => { clearTimeout(timer); resolve(); }, { once: true });
+            });
+            if (controller.signal.aborted)
+                break;
+            try {
+                const s = await takeSnapshot(getAdapterForExchange, exchanges);
+                const t = s.reduce((sum, sn) => sum + sn.equity, 0);
+                const delta = t - total;
+                console.log(`${chalk.gray(new Date().toLocaleTimeString())} ` +
+                    `Total: $${formatUsd(t)}  ${formatPnl(delta)}`);
+            }
+            catch (err) {
+                console.error(chalk.red(`Snapshot error: ${err instanceof Error ? err.message : err}`));
+            }
+        }
+    });
+    // ── pnl daily ──
+    pnl
+        .command("daily")
+        .description("Daily PnL breakdown")
+        .option("--exchange <name>", "Single exchange filter")
+        .option("--days <n>", "Number of days to show", "14")
+        .option("--since <period>", "Time range (e.g. 7d, 2w, 30d)")
+        .action(async (opts) => {
+        await withJsonErrors(isJson(), async () => {
+            const since = parseSince(opts.since) ?? new Date(Date.now() - parseInt(opts.days) * 86400000);
+            const snapshots = readEquityHistory({ exchange: opts.exchange, since });
+            if (snapshots.length === 0) {
+                if (isJson()) {
+                    printJson(jsonError("NO_DATA", "No equity snapshots found. Run 'perp pnl snapshot' or 'perp pnl track' first."));
+                }
+                else {
+                    console.log(chalk.yellow("No equity snapshots found. Run 'perp pnl snapshot' or 'perp pnl track' first."));
+                }
+                return;
+            }
+            const daily = computeDailyPnl(snapshots, opts.exchange);
+            if (isJson()) {
+                printJson(jsonOk({ daily }));
+            }
+            else {
+                console.log(chalk.cyan.bold(`Daily PnL${opts.exchange ? ` (${opts.exchange})` : ""}\n`));
+                const head = ["Date", "Start", "End", "PnL", "PnL %"];
+                const rows = daily.map(d => [
+                    d.date,
+                    `$${formatUsd(d.startEquity)}`,
+                    `$${formatUsd(d.endEquity)}`,
+                    formatPnl(d.pnl),
+                    `${d.pnlPct >= 0 ? "+" : ""}${d.pnlPct.toFixed(2)}%`,
+                ]);
+                console.log(makeTable(head, rows));
+            }
+        });
+    });
+    // ── pnl weekly ──
+    pnl
+        .command("weekly")
+        .description("Weekly PnL breakdown")
+        .option("--exchange <name>", "Single exchange filter")
+        .option("--weeks <n>", "Number of weeks to show", "8")
+        .option("--since <period>", "Time range (e.g. 4w, 8w)")
+        .action(async (opts) => {
+        await withJsonErrors(isJson(), async () => {
+            const since = parseSince(opts.since) ?? new Date(Date.now() - parseInt(opts.weeks) * 7 * 86400000);
+            const snapshots = readEquityHistory({ exchange: opts.exchange, since });
+            if (snapshots.length === 0) {
+                if (isJson()) {
+                    printJson(jsonError("NO_DATA", "No equity snapshots found."));
+                }
+                else {
+                    console.log(chalk.yellow("No equity snapshots found. Run 'perp pnl snapshot' or 'perp pnl track' first."));
+                }
+                return;
+            }
+            const daily = computeDailyPnl(snapshots, opts.exchange);
+            const weekly = aggregateWeekly(daily);
+            if (isJson()) {
+                printJson(jsonOk({ weekly }));
+            }
+            else {
+                console.log(chalk.cyan.bold(`Weekly PnL${opts.exchange ? ` (${opts.exchange})` : ""}\n`));
+                const head = ["Week", "Start", "End", "PnL", "PnL %"];
+                const rows = weekly.map(w => [
+                    w.date,
+                    `$${formatUsd(w.startEquity)}`,
+                    `$${formatUsd(w.endEquity)}`,
+                    formatPnl(w.pnl),
+                    `${w.pnlPct >= 0 ? "+" : ""}${w.pnlPct.toFixed(2)}%`,
+                ]);
+                console.log(makeTable(head, rows));
+            }
+        });
+    });
+    // ── pnl summary ──
+    pnl
+        .command("summary")
+        .description("Performance summary — Sharpe, drawdown, win rate")
+        .option("--exchange <name>", "Single exchange filter")
+        .option("--since <period>", "Time range (e.g. 7d, 30d, 12w)")
+        .action(async (opts) => {
+        await withJsonErrors(isJson(), async () => {
+            const since = parseSince(opts.since);
+            const snapshots = readEquityHistory({ exchange: opts.exchange, since });
+            if (snapshots.length === 0) {
+                if (isJson()) {
+                    printJson(jsonError("NO_DATA", "No equity snapshots found."));
+                }
+                else {
+                    console.log(chalk.yellow("No equity snapshots found. Run 'perp pnl snapshot' or 'perp pnl track' first."));
+                }
+                return;
+            }
+            const metrics = computePnlMetrics(snapshots, opts.exchange);
+            if (isJson()) {
+                printJson(jsonOk({
+                    ...metrics,
+                    dailyReturns: undefined, // omit large array from JSON
+                    dailyCount: metrics.dailyReturns.length,
+                }));
+            }
+            else {
+                console.log(chalk.cyan.bold(`Performance Summary${opts.exchange ? ` (${opts.exchange})` : ""}\n`));
+                console.log(`  Period:          ${metrics.period.from} → ${metrics.period.to} (${metrics.period.days} days)`);
+                console.log(`  Total Return:    ${formatPnl(metrics.totalReturn)} (${metrics.totalReturnPct >= 0 ? "+" : ""}${metrics.totalReturnPct.toFixed(2)}%)`);
+                console.log(`  Peak Equity:     $${formatUsd(metrics.peakEquity)}`);
+                console.log(`  Avg Daily PnL:   ${formatPnl(metrics.avgDailyPnl)}`);
+                console.log();
+                console.log(`  Sharpe Ratio:    ${metrics.sharpeRatio >= 0 ? chalk.green(metrics.sharpeRatio.toFixed(2)) : chalk.red(metrics.sharpeRatio.toFixed(2))}`);
+                console.log(`  Max Drawdown:    ${chalk.red(`$${formatUsd(metrics.maxDrawdown)}`)} (${chalk.red(`-${metrics.maxDrawdownPct.toFixed(2)}%`)})`);
+                console.log(`  Current DD:      $${formatUsd(metrics.currentDrawdown)} (-${metrics.currentDrawdownPct.toFixed(2)}%)`);
+                console.log();
+                console.log(`  Win Days:        ${chalk.green(String(metrics.winDays))} / ${metrics.winDays + metrics.lossDays}`);
+                console.log(`  Win Rate:        ${metrics.winRate.toFixed(1)}%`);
+                if (metrics.bestDay) {
+                    console.log(`  Best Day:        ${metrics.bestDay.date}  ${formatPnl(metrics.bestDay.pnl)}`);
+                }
+                if (metrics.worstDay) {
+                    console.log(`  Worst Day:       ${metrics.worstDay.date}  ${formatPnl(metrics.worstDay.pnl)}`);
+                }
+            }
+        });
+    });
+}

package/dist/commands/settings.d.ts

@@ -1,2 +1,3 @@
 import { Command } from "commander";
-export declare function registerSettingsCommands(program: Command, isJson: () => boolean): void;
+import type { ExchangeAdapter } from "../exchanges/interface.js";
+export declare function registerSettingsCommands(program: Command, isJson: () => boolean, getAdapterForExchange?: (exchange: string) => Promise<ExchangeAdapter>): void;

package/dist/commands/settings.js

@@ -1,8 +1,8 @@
 import chalk from "chalk";
 import { printJson, jsonOk, withJsonErrors } from "../utils.js";
 import { loadSettings, saveSettings } from "../settings.js";
-export function registerSettingsCommands(program, isJson) {
-    const settings = program.command("settings").description("CLI settings (referrals, defaults)");
+export function registerSettingsCommands(program, isJson, getAdapterForExchange) {
+    const settings = program.command("settings").description("CLI settings (referrals, defaults, fees)");
     // ── settings show ──
     settings
         .command("show")
@@ -19,6 +19,12 @@ export function registerSettingsCommands(program, isJson) {
             console.log(`    Pacifica:      ${s.referralCodes.pacifica || chalk.gray("(none)")}`);
             console.log(`    Hyperliquid:   ${s.referralCodes.hyperliquid || chalk.gray("(none)")}`);
             console.log(`    Lighter:       ${s.referralCodes.lighter || chalk.gray("(none)")}`);
+            console.log(chalk.white.bold("\n  Fee Tiers:"));
+            for (const [ex, fee] of Object.entries(s.fees)) {
+                const tPct = (fee.taker * 100).toFixed(4);
+                const mPct = (fee.maker * 100).toFixed(4);
+                console.log(`    ${ex.padEnd(14)} taker: ${tPct}%  maker: ${mPct}%`);
+            }
             console.log(chalk.gray(`\n  Config: ~/.perp/settings.json\n`));
         });
     });
@@ -58,6 +64,131 @@ export function registerSettingsCommands(program, isJson) {
             }
         });
     });
+    // ── settings fees ──
+    const fees = settings
+        .command("fees")
+        .description("Show or sync exchange fee tiers");
+    fees
+        .command("show")
+        .description("Show current fee tiers")
+        .action(async () => {
+        await withJsonErrors(isJson(), async () => {
+            const s = loadSettings();
+            if (isJson())
+                return printJson(jsonOk(s.fees));
+            console.log(chalk.cyan.bold("\n  Exchange Fee Tiers\n"));
+            for (const [ex, fee] of Object.entries(s.fees)) {
+                const tPct = (fee.taker * 100).toFixed(4);
+                const mPct = (fee.maker * 100).toFixed(4);
+                console.log(`  ${ex.padEnd(14)} taker: ${chalk.yellow(tPct + "%")}  maker: ${chalk.green(mPct + "%")}`);
+            }
+            console.log(chalk.gray(`\n  Sync from exchanges: perp settings fees sync`));
+            console.log(chalk.gray(`  Manual set: perp settings fees set <exchange> <taker> <maker>\n`));
+        });
+    });
+    fees
+        .command("sync")
+        .description("Fetch fee tiers from exchange APIs and save")
+        .option("--exchange <name>", "Sync only a specific exchange")
+        .action(async (opts) => {
+        await withJsonErrors(isJson(), async () => {
+            if (!getAdapterForExchange) {
+                console.error(chalk.red("  Fee sync requires exchange adapters. Set up keys first with `perp init`."));
+                return;
+            }
+            const s = loadSettings();
+            const exchanges = opts.exchange ? [opts.exchange.toLowerCase()] : ["hyperliquid", "pacifica", "lighter"];
+            const results = {};
+            for (const ex of exchanges) {
+                try {
+                    if (ex === "lighter") {
+                        // Lighter has 0% fees
+                        s.fees.lighter = { taker: 0, maker: 0 };
+                        results.lighter = { taker: 0, maker: 0, source: "known (0% fee exchange)" };
+                        if (!isJson())
+                            console.log(chalk.green(`  ✓ lighter: taker 0% / maker 0% (no fees)`));
+                        continue;
+                    }
+                    if (ex === "hyperliquid") {
+                        const adapter = await getAdapterForExchange("hyperliquid");
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        const hlAdapter = adapter;
+                        if (typeof hlAdapter.getUserFees === "function") {
+                            const feeData = await hlAdapter.getUserFees();
+                            // HL returns: { activeReferralDiscount, dailyUserVlm, feeSchedule: { ... }, userCrossRate, userAddRate }
+                            // userCrossRate is the effective taker fee, userAddRate is the maker fee
+                            const taker = parseFloat(feeData?.userCrossRate ?? feeData?.takerRate ?? "0.00035");
+                            const maker = parseFloat(feeData?.userAddRate ?? feeData?.makerRate ?? "0.00002");
+                            s.fees.hyperliquid = { taker: Math.abs(taker), maker };
+                            results.hyperliquid = { taker: Math.abs(taker), maker, source: "API (getUserFees)" };
+                            if (!isJson()) {
+                                console.log(chalk.green(`  ✓ hyperliquid: taker ${(Math.abs(taker) * 100).toFixed(4)}% / maker ${(maker * 100).toFixed(4)}%`));
+                            }
+                        }
+                        else {
+                            if (!isJson())
+                                console.log(chalk.yellow(`  ⚠ hyperliquid: getUserFees not available, keeping current`));
+                        }
+                        continue;
+                    }
+                    if (ex === "pacifica") {
+                        const adapter = await getAdapterForExchange("pacifica");
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        const pacAdapter = adapter;
+                        if (typeof pacAdapter.sdk?.getAccount === "function" && pacAdapter.publicKey) {
+                            const info = await pacAdapter.sdk.getAccount(pacAdapter.publicKey);
+                            const taker = parseFloat(info?.taker_fee ?? "0.00035");
+                            const maker = parseFloat(info?.maker_fee ?? "0.0001");
+                            s.fees.pacifica = { taker, maker };
+                            results.pacifica = { taker, maker, source: "API (getAccount)" };
+                            if (!isJson()) {
+                                console.log(chalk.green(`  ✓ pacifica: taker ${(taker * 100).toFixed(4)}% / maker ${(maker * 100).toFixed(4)}%`));
+                            }
+                        }
+                        else {
+                            if (!isJson())
+                                console.log(chalk.yellow(`  ⚠ pacifica: account API not available, keeping current`));
+                        }
+                        continue;
+                    }
+                    if (!isJson())
+                        console.log(chalk.yellow(`  ⚠ ${ex}: unknown exchange, skipped`));
+                }
+                catch (err) {
+                    if (!isJson()) {
+                        console.log(chalk.red(`  ✗ ${ex}: ${err instanceof Error ? err.message : String(err)}`));
+                    }
+                }
+            }
+            saveSettings(s);
+            if (isJson())
+                return printJson(jsonOk(results));
+            console.log(chalk.gray("\n  Fees saved to ~/.perp/settings.json\n"));
+        });
+    });
+    fees
+        .command("set")
+        .description("Manually set fee tier for an exchange")
+        .argument("<exchange>", "Exchange name")
+        .argument("<taker>", "Taker fee as percentage (e.g. 0.035 for 0.035%)")
+        .argument("<maker>", "Maker fee as percentage (e.g. 0.01 for 0.01%)")
+        .action(async (exchange, takerStr, makerStr) => {
+        await withJsonErrors(isJson(), async () => {
+            const s = loadSettings();
+            const ex = exchange.toLowerCase();
+            const taker = parseFloat((parseFloat(takerStr) / 100).toPrecision(10));
+            const maker = parseFloat((parseFloat(makerStr) / 100).toPrecision(10));
+            if (isNaN(taker) || isNaN(maker)) {
+                console.error(chalk.red("  Invalid fee values. Use percentages, e.g.: perp settings fees set hyperliquid 0.035 0.002"));
+                return;
+            }
+            s.fees[ex] = { taker, maker };
+            saveSettings(s);
+            if (isJson())
+                return printJson(jsonOk({ exchange: ex, taker, maker }));
+            console.log(chalk.green(`\n  ${ex}: taker ${takerStr}% / maker ${makerStr}%\n`));
+        });
+    });
     // ── settings set ──
     settings
         .command("set")

package/dist/commands/stream.js

@@ -1,93 +1,170 @@
 import { PacificaWSClient } from "../pacifica/index.js";
 import chalk from "chalk";
 import { formatUsd, formatPercent } from "../utils.js";
+/** Create an HL or Lighter market feed, connected and ready. */
+async function getMarketFeed(exchange) {
+    const { createMarketFeed } = await import("../ws/market-feed.js");
+    const feed = createMarketFeed(exchange);
+    await feed.connect();
+    process.on("SIGINT", () => { feed.close(); process.exit(0); });
+    return feed;
+}
 export function registerStreamCommands(program, getNetwork, getExchange, getAdapter) {
     const stream = program.command("stream").description("Live WebSocket streams (Ctrl+C to stop)");
+    // ── stream prices ──
     stream
         .command("prices")
         .description("Stream live prices")
         .action(async () => {
-        const ws = new PacificaWSClient({ network: getNetwork() });
-        await ws.connect();
-        ws.subscribe("prices");
-        ws.on("prices", (msg) => {
-            const data = msg;
-            const d = data.data ?? data;
-            if (Array.isArray(d)) {
-                d.forEach((p) => {
-                    const mark = Number(p.mark ?? p.m ?? 0);
-                    const funding = Number(p.funding ?? p.f ?? 0);
-                    const sym = String(p.symbol ?? p.s ?? "").padEnd(10);
-                    console.log(`${chalk.white.bold(sym)} $${formatUsd(mark)}  ${formatPercent(funding)}`);
-                });
-            }
-        });
-        console.log(chalk.cyan("Streaming prices... (Ctrl+C to stop)\n"));
+        const exchange = getExchange();
+        if (exchange === "pacifica") {
+            const ws = new PacificaWSClient({ network: getNetwork() });
+            await ws.connect();
+            ws.subscribe("prices");
+            ws.on("prices", (msg) => {
+                const data = msg;
+                const d = data.data ?? data;
+                if (Array.isArray(d)) {
+                    d.forEach((p) => {
+                        const mark = Number(p.mark ?? p.m ?? 0);
+                        const funding = Number(p.funding ?? p.f ?? 0);
+                        const sym = String(p.symbol ?? p.s ?? "").padEnd(10);
+                        console.log(`${chalk.white.bold(sym)} $${formatUsd(mark)}  ${formatPercent(funding)}`);
+                    });
+                }
+            });
+            console.log(chalk.cyan("Streaming pacifica prices... (Ctrl+C to stop)\n"));
+        }
+        else {
+            const feed = await getMarketFeed(exchange);
+            feed.subscribePrices();
+            feed.on("prices", (updates) => {
+                for (const p of updates) {
+                    const sym = p.symbol.padEnd(10);
+                    console.log(`${chalk.white.bold(sym)} $${formatUsd(p.mid)}`);
+                }
+            });
+            console.log(chalk.cyan(`Streaming ${exchange} prices... (Ctrl+C to stop)\n`));
+        }
         await new Promise(() => { }); // keep alive
     });
+    // ── stream book ──
     stream
         .command("book <symbol>")
         .description("Stream orderbook updates")
         .action(async (symbol) => {
-        const ws = new PacificaWSClient({ network: getNetwork() });
-        await ws.connect();
-        ws.subscribe("book", { symbol: symbol.toUpperCase() });
-        ws.on("book", (msg) => {
-            const data = msg;
-            console.log(`${chalk.cyan(new Date().toLocaleTimeString())} ${JSON.stringify(data.data ?? data)}`);
-        });
-        console.log(chalk.cyan(`Streaming ${symbol.toUpperCase()} orderbook... (Ctrl+C to stop)\n`));
+        const exchange = getExchange();
+        const sym = symbol.toUpperCase();
+        if (exchange === "pacifica") {
+            const ws = new PacificaWSClient({ network: getNetwork() });
+            await ws.connect();
+            ws.subscribe("book", { symbol: sym });
+            ws.on("book", (msg) => {
+                const data = msg;
+                console.log(`${chalk.cyan(new Date().toLocaleTimeString())} ${JSON.stringify(data.data ?? data)}`);
+            });
+        }
+        else {
+            const feed = await getMarketFeed(exchange);
+            feed.subscribeBook(sym);
+            feed.on("book", (data) => {
+                const topBids = data.bids.slice(0, 5).map(([p, s]) => `${p}x${s}`).join(" ");
+                const topAsks = data.asks.slice(0, 5).map(([p, s]) => `${p}x${s}`).join(" ");
+                console.log(`${chalk.cyan(new Date().toLocaleTimeString())} ${chalk.green("BID")} ${topBids}  ${chalk.red("ASK")} ${topAsks}`);
+            });
+        }
+        console.log(chalk.cyan(`Streaming ${sym} orderbook on ${exchange}... (Ctrl+C to stop)\n`));
         await new Promise(() => { });
     });
+    // ── stream trades ──
     stream
         .command("trades <symbol>")
         .description("Stream live trades")
         .action(async (symbol) => {
-        const ws = new PacificaWSClient({ network: getNetwork() });
-        await ws.connect();
-        ws.subscribe("trades", { symbol: symbol.toUpperCase() });
-        ws.on("trades", (msg) => {
-            const data = msg;
-            const d = (data.data ?? data);
-            const side = String(d.side ?? d.d ?? "");
-            const price = String(d.price ?? d.p ?? "");
-            const amount = String(d.amount ?? d.a ?? "");
-            const color = side === "bid" || side === "buy" ? chalk.green : chalk.red;
-            console.log(`${chalk.gray(new Date().toLocaleTimeString())} ${color(side === "bid" ? "BUY " : "SELL")} $${formatUsd(price)} x ${amount}`);
-        });
-        console.log(chalk.cyan(`Streaming ${symbol.toUpperCase()} trades... (Ctrl+C to stop)\n`));
+        const exchange = getExchange();
+        const sym = symbol.toUpperCase();
+        if (exchange === "pacifica") {
+            const ws = new PacificaWSClient({ network: getNetwork() });
+            await ws.connect();
+            ws.subscribe("trades", { symbol: sym });
+            ws.on("trades", (msg) => {
+                const data = msg;
+                const d = (data.data ?? data);
+                const side = String(d.side ?? d.d ?? "");
+                const price = String(d.price ?? d.p ?? "");
+                const amount = String(d.amount ?? d.a ?? "");
+                const color = side === "bid" || side === "buy" ? chalk.green : chalk.red;
+                console.log(`${chalk.gray(new Date().toLocaleTimeString())} ${color(side === "bid" ? "BUY " : "SELL")} $${formatUsd(price)} x ${amount}`);
+            });
+        }
+        else {
+            const feed = await getMarketFeed(exchange);
+            feed.subscribeTrades(sym);
+            feed.on("trade", (t) => {
+                const color = t.side === "buy" ? chalk.green : chalk.red;
+                console.log(`${chalk.gray(new Date().toLocaleTimeString())} ${color(t.side === "buy" ? "BUY " : "SELL")} $${formatUsd(t.price)} x ${t.size}`);
+            });
+        }
+        console.log(chalk.cyan(`Streaming ${sym} trades on ${exchange}... (Ctrl+C to stop)\n`));
         await new Promise(() => { });
     });
+    // ── stream bbo ──
     stream
         .command("bbo <symbol>")
         .description("Stream best bid/offer")
         .action(async (symbol) => {
-        const ws = new PacificaWSClient({ network: getNetwork() });
-        await ws.connect();
-        ws.subscribe("bbo", { symbol: symbol.toUpperCase() });
-        ws.on("bbo", (msg) => {
-            const data = msg.data ?? msg;
-            console.log(`${chalk.gray(new Date().toLocaleTimeString())} ${JSON.stringify(data)}`);
-        });
-        console.log(chalk.cyan(`Streaming ${symbol.toUpperCase()} BBO... (Ctrl+C to stop)\n`));
+        const exchange = getExchange();
+        const sym = symbol.toUpperCase();
+        if (exchange === "pacifica") {
+            const ws = new PacificaWSClient({ network: getNetwork() });
+            await ws.connect();
+            ws.subscribe("bbo", { symbol: sym });
+            ws.on("bbo", (msg) => {
+                const data = msg.data ?? msg;
+                console.log(`${chalk.gray(new Date().toLocaleTimeString())} ${JSON.stringify(data)}`);
+            });
+        }
+        else {
+            // BBO derived from orderbook (HL/Lighter don't have dedicated BBO channel)
+            const feed = await getMarketFeed(exchange);
+            feed.subscribeBook(sym);
+            feed.on("book", (data) => {
+                const bid = data.bids[0] ?? ["—", "—"];
+                const ask = data.asks[0] ?? ["—", "—"];
+                console.log(`${chalk.gray(new Date().toLocaleTimeString())} ${chalk.green("bid")} ${bid[0]} (${bid[1]})  ${chalk.red("ask")} ${ask[0]} (${ask[1]})`);
+            });
+        }
+        console.log(chalk.cyan(`Streaming ${sym} BBO on ${exchange}... (Ctrl+C to stop)\n`));
         await new Promise(() => { });
     });
+    // ── stream candle ──
     stream
         .command("candle <symbol> <interval>")
         .description("Stream candlestick data")
         .action(async (symbol, interval) => {
-        const ws = new PacificaWSClient({ network: getNetwork() });
-        await ws.connect();
-        ws.subscribe("candle", { symbol: symbol.toUpperCase(), interval });
-        ws.on("candle", (msg) => {
-            const data = msg.data ?? msg;
-            const d = data;
-            console.log(`${chalk.gray(new Date().toLocaleTimeString())} O:$${formatUsd(String(d.o ?? ""))} H:$${formatUsd(String(d.h ?? ""))} L:$${formatUsd(String(d.l ?? ""))} C:$${formatUsd(String(d.c ?? ""))} V:${d.v ?? ""}`);
-        });
-        console.log(chalk.cyan(`Streaming ${symbol.toUpperCase()} ${interval} candles... (Ctrl+C to stop)\n`));
+        const exchange = getExchange();
+        const sym = symbol.toUpperCase();
+        if (exchange === "pacifica") {
+            const ws = new PacificaWSClient({ network: getNetwork() });
+            await ws.connect();
+            ws.subscribe("candle", { symbol: sym, interval });
+            ws.on("candle", (msg) => {
+                const data = msg.data ?? msg;
+                const d = data;
+                console.log(`${chalk.gray(new Date().toLocaleTimeString())} O:$${formatUsd(String(d.o ?? ""))} H:$${formatUsd(String(d.h ?? ""))} L:$${formatUsd(String(d.l ?? ""))} C:$${formatUsd(String(d.c ?? ""))} V:${d.v ?? ""}`);
+            });
+        }
+        else {
+            const feed = await getMarketFeed(exchange);
+            feed.subscribeCandle(sym, interval);
+            feed.on("candle", (d) => {
+                console.log(`${chalk.gray(new Date().toLocaleTimeString())} O:$${formatUsd(d.o)} H:$${formatUsd(d.h)} L:$${formatUsd(d.l)} C:$${formatUsd(d.c)} V:${d.v}`);
+            });
+        }
+        console.log(chalk.cyan(`Streaming ${sym} ${interval} candles on ${exchange}... (Ctrl+C to stop)\n`));
         await new Promise(() => { });
     });
-    // ── stream events ── (unified account events as NDJSON)
+    // ── stream events ── (unified account events as NDJSON, already exchange-agnostic)
     if (getAdapter) {
         stream
             .command("events")