perp-cli 0.7.1 → 0.7.2

package/dist/bot/config.d.ts

@@ -56,6 +56,7 @@ export interface BotConfig {
     monitor_interval_sec: number;
 }
 export declare function loadBotConfig(pathOrInline: string): BotConfig;
+export declare function parseStrategy(type: string, raw: Record<string, unknown>): StrategyParams;
 export declare function quickGridConfig(opts: {
     exchange: string;
     symbol: string;

package/dist/bot/config.js

@@ -53,7 +53,7 @@ function parseBotConfig(raw) {
     };
     return { name, exchange, symbol, strategy, entry_conditions: entryConds, exit_conditions: exitConds, risk, monitor_interval_sec: monitorInterval };
 }
-function parseStrategy(type, raw) {
+export function parseStrategy(type, raw) {
     switch (type) {
         case "grid":
             return {

package/dist/bot/engine.js

@@ -247,9 +247,12 @@ mode = "headless") {
                     }
                 }
                 // ── Emit state update for TUI / JSON ──
-                const positions = await fetchPositions(adapter, config.symbol);
-                const openOrders = await fetchOpenOrders(adapter, config.symbol);
-                const tuiState = buildTuiState(state, config, snapshot, positions, openOrders, strategyCtx);
+                const [positions, openOrders, exchangeBalances] = await Promise.all([
+                    extraAdapters ? fetchAllPositions(adapter, config.symbol, extraAdapters) : fetchPositions(adapter, config.symbol, adapter.name),
+                    fetchOpenOrders(adapter, config.symbol),
+                    extraAdapters ? fetchExchangeBalances(adapter, extraAdapters) : Promise.resolve(undefined),
+                ]);
+                const tuiState = buildTuiState(state, config, snapshot, positions, openOrders, strategyCtx, exchangeBalances);
                 if (mode === "tui") {
                     tuiEmitter.emitState(tuiState);
                 }
@@ -390,11 +393,12 @@ function sleep(ms) {
     return new Promise(r => setTimeout(r, ms));
 }
 // ── TUI helpers ──
-async function fetchPositions(adapter, symbol) {
+async function fetchPositions(adapter, symbol, exchangeName) {
     try {
         const positions = await adapter.getPositions();
+        const isAll = symbol.toUpperCase() === "ALL";
         return positions
-            .filter(p => p.symbol.toUpperCase().includes(symbol.toUpperCase()) && parseFloat(p.size) !== 0)
+            .filter(p => (isAll || p.symbol.toUpperCase().includes(symbol.toUpperCase())) && parseFloat(p.size) !== 0)
             .map(p => ({
             symbol: p.symbol,
             side: p.side,
@@ -402,12 +406,42 @@ async function fetchPositions(adapter, symbol) {
             entryPrice: p.entryPrice,
             markPrice: p.markPrice,
             unrealizedPnl: p.unrealizedPnl,
+            exchange: exchangeName ?? adapter.name,
         }));
     }
     catch {
         return [];
     }
 }
+async function fetchExchangeBalances(primaryAdapter, extraAdapters) {
+    const adapters = [[primaryAdapter.name, primaryAdapter]];
+    if (extraAdapters) {
+        for (const [name, a] of extraAdapters)
+            adapters.push([name, a]);
+    }
+    const results = [];
+    await Promise.all(adapters.map(async ([name, a]) => {
+        try {
+            const bal = await a.getBalance();
+            results.push({ exchange: name, equity: bal.equity, available: bal.available });
+        }
+        catch { /* skip */ }
+    }));
+    return results;
+}
+async function fetchAllPositions(primaryAdapter, symbol, extraAdapters) {
+    const adapters = [[primaryAdapter.name, primaryAdapter]];
+    if (extraAdapters) {
+        for (const [name, a] of extraAdapters)
+            adapters.push([name, a]);
+    }
+    const all = [];
+    await Promise.all(adapters.map(async ([name, a]) => {
+        const pos = await fetchPositions(a, symbol, name);
+        all.push(pos);
+    }));
+    return all.flat();
+}
 async function fetchOpenOrders(adapter, symbol) {
     try {
         const orders = await adapter.getOpenOrders();
@@ -425,7 +459,7 @@ async function fetchOpenOrders(adapter, symbol) {
         return [];
     }
 }
-function buildTuiState(state, config, snapshot, positions, openOrders, strategyCtx) {
+function buildTuiState(state, config, snapshot, positions, openOrders, strategyCtx, exchangeBalances) {
     // Extract serializable strategy state from the Map
     const strategyState = {};
     for (const [k, v] of strategyCtx.state) {
@@ -460,5 +494,6 @@ function buildTuiState(state, config, snapshot, positions, openOrders, strategyC
         openOrders,
         strategyState,
         tick: strategyCtx.tick,
+        exchangeBalances,
     };
 }

package/dist/bot/index.d.ts

@@ -1,4 +1,4 @@
-export { loadBotConfig, quickGridConfig, quickDCAConfig, } from "./config.js";
+export { loadBotConfig, parseStrategy, quickGridConfig, quickDCAConfig, } from "./config.js";
 export type { ConditionType, Condition, RiskConfig, GridStrategyParams, DCAStrategyParams, FundingArbStrategyParams, GenericStrategyParams, StrategyParams, BotConfig, } from "./config.js";
 export { runBot } from "./engine.js";
 export type { BotLog, BotOutputMode } from "./engine.js";

package/dist/bot/index.js

@@ -1,5 +1,5 @@
 // bot/ barrel — public API
-export { loadBotConfig, quickGridConfig, quickDCAConfig, } from "./config.js";
+export { loadBotConfig, parseStrategy, quickGridConfig, quickDCAConfig, } from "./config.js";
 export { runBot } from "./engine.js";
 export { PRESETS, getPreset, getPresetsByStrategy } from "./presets.js";
 export { evaluateCondition, evaluateAllConditions, getMarketSnapshot, calculateRSI } from "./conditions.js";

package/dist/bot/tui/BotDashboard.d.ts

@@ -1,3 +1,8 @@
+export interface ExchangeBalance {
+    exchange: string;
+    equity: string;
+    available: string;
+}
 export interface BotTuiState {
     phase: string;
     equity: number;
@@ -18,6 +23,7 @@ export interface BotTuiState {
     openOrders: OpenOrder[];
     strategyState: Record<string, unknown>;
     tick: number;
+    exchangeBalances?: ExchangeBalance[];
 }
 export interface Position {
     symbol: string;
@@ -26,6 +32,7 @@ export interface Position {
     entryPrice: string;
     markPrice: string;
     unrealizedPnl: string;
+    exchange?: string;
 }
 export interface OpenOrder {
     orderId: string;

package/dist/bot/tui/BotDashboard.js

@@ -68,9 +68,10 @@ export function BotDashboard({ initialState, onQuit, onPause, subscribe }) {
     const drawdownPct = state.peakEquity > 0 ? (drawdown / state.peakEquity) * 100 : 0;
     const bidOrders = state.openOrders.filter((o) => o.side.toLowerCase() === "buy");
     const askOrders = state.openOrders.filter((o) => o.side.toLowerCase() === "sell");
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", marginBottom: 1, children: [_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, color: "cyan", children: [state.strategy, " | ", state.symbol, " | ", state.exchange] }), _jsxs(Text, { color: "gray", children: ["Runtime: ", formatDuration(state.runtime), " | Tick: ", state.tick] })] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: phaseColor(state.phase), children: phaseIndicator(state.phase) }) })] }), _jsxs(Box, { borderStyle: "single", borderColor: "gray", paddingX: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Text, { children: ["Price: ", _jsxs(Text, { bold: true, color: "white", children: ["$", state.price.toFixed(2)] })] }), _jsxs(Text, { color: "gray", children: ["Vol24h: ", _jsxs(Text, { color: "white", children: [state.volatility24h.toFixed(1), "%"] })] }), _jsxs(Text, { color: "gray", children: ["FR: ", _jsxs(Text, { color: state.fundingRate >= 0 ? "green" : "red", children: [(state.fundingRate * 100).toFixed(4), "%"] })] }), _jsxs(Text, { color: "gray", children: ["OI: ", _jsx(Text, { color: "white", children: state.openInterest })] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Account" }), _jsxs(Text, { children: ["Equity: ", _jsxs(Text, { bold: true, color: "white", children: ["$", state.equity.toFixed(2)] }), _jsxs(Text, { color: "gray", children: [" (peak: $", state.peakEquity.toFixed(2), ")"] })] }), _jsxs(Text, { children: ["Daily P&L: ", _jsxs(Text, { bold: true, color: pnlColor(state.dailyPnl), children: ["$", state.dailyPnl.toFixed(2)] })] })] }), _jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: " " }), _jsxs(Text, { children: ["Drawdown: ", _jsxs(Text, { bold: true, color: drawdown > 0 ? "red" : "green", children: ["$", drawdown.toFixed(2), " (", drawdownPct.toFixed(1), "%)"] })] }), _jsxs(Text, { children: ["Fills: ", _jsx(Text, { bold: true, color: "white", children: state.fills }), _jsx(Text, { color: "gray", children: " | Total P&L: " }), _jsxs(Text, { bold: true, color: pnlColor(state.totalPnl), children: ["$", state.totalPnl.toFixed(2)] })] })] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Positions" }), state.positions.length === 0 ? (_jsx(Text, { color: "gray", children: "  No open positions" })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: "gray", children: pad("Symbol", 10) }), _jsx(Text, { color: "gray", children: pad("Side", 6) }), _jsx(Text, { color: "gray", children: pad("Size", 12) }), _jsx(Text, { color: "gray", children: pad("Entry", 12) }), _jsx(Text, { color: "gray", children: pad("Mark", 12) }), _jsx(Text, { color: "gray", children: "uPnL" })] }), state.positions.map((p, i) => {
+    const hasMultiExchange = (state.exchangeBalances?.length ?? 0) > 1;
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", marginBottom: 1, children: [_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, color: "cyan", children: [state.strategy, " | ", state.symbol, " | ", state.exchange] }), _jsxs(Text, { color: "gray", children: ["Runtime: ", formatDuration(state.runtime), " | Tick: ", state.tick] })] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: phaseColor(state.phase), children: phaseIndicator(state.phase) }) })] }), _jsxs(Box, { borderStyle: "single", borderColor: "gray", paddingX: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Text, { children: ["Price: ", _jsxs(Text, { bold: true, color: "white", children: ["$", state.price.toFixed(2)] })] }), _jsxs(Text, { color: "gray", children: ["Vol24h: ", _jsxs(Text, { color: "white", children: [state.volatility24h.toFixed(1), "%"] })] }), _jsxs(Text, { color: "gray", children: ["FR: ", _jsxs(Text, { color: state.fundingRate >= 0 ? "green" : "red", children: [(state.fundingRate * 100).toFixed(4), "%"] })] }), _jsxs(Text, { color: "gray", children: ["OI: ", _jsx(Text, { color: "white", children: state.openInterest })] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Account" }), _jsxs(Text, { children: ["Equity: ", _jsxs(Text, { bold: true, color: "white", children: ["$", state.equity.toFixed(2)] }), _jsxs(Text, { color: "gray", children: [" (peak: $", state.peakEquity.toFixed(2), ")"] })] }), _jsxs(Text, { children: ["Daily P&L: ", _jsxs(Text, { bold: true, color: pnlColor(state.dailyPnl), children: ["$", state.dailyPnl.toFixed(2)] })] })] }), _jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: " " }), _jsxs(Text, { children: ["Drawdown: ", _jsxs(Text, { bold: true, color: drawdown > 0 ? "red" : "green", children: ["$", drawdown.toFixed(2), " (", drawdownPct.toFixed(1), "%)"] })] }), _jsxs(Text, { children: ["Fills: ", _jsx(Text, { bold: true, color: "white", children: state.fills }), _jsx(Text, { color: "gray", children: " | Total P&L: " }), _jsxs(Text, { bold: true, color: pnlColor(state.totalPnl), children: ["$", state.totalPnl.toFixed(2)] })] })] })] }), state.exchangeBalances && state.exchangeBalances.length > 1 && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Exchange Balances" }), _jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: "gray", children: pad("Exchange", 16) }), _jsx(Text, { color: "gray", children: pad("Equity", 14) }), _jsx(Text, { color: "gray", children: "Available" })] }), state.exchangeBalances.map((eb, i) => (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: "white", children: pad(eb.exchange, 16) }), _jsx(Text, { color: "white", children: pad(`$${parseFloat(eb.equity).toFixed(2)}`, 14) }), _jsxs(Text, { color: "gray", children: ["$", parseFloat(eb.available).toFixed(2)] })] }, i)))] })), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Positions" }), state.positions.length === 0 ? (_jsx(Text, { color: "gray", children: "  No open positions" })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [hasMultiExchange && _jsx(Text, { color: "gray", children: pad("Exchange", 14) }), _jsx(Text, { color: "gray", children: pad("Symbol", 10) }), _jsx(Text, { color: "gray", children: pad("Side", 6) }), _jsx(Text, { color: "gray", children: pad("Size", 12) }), _jsx(Text, { color: "gray", children: pad("Entry", 12) }), _jsx(Text, { color: "gray", children: pad("Mark", 12) }), _jsx(Text, { color: "gray", children: "uPnL" })] }), state.positions.map((p, i) => {
                                 const upnl = parseFloat(p.unrealizedPnl);
-                                return (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: "white", children: pad(p.symbol, 10) }), _jsx(Text, { color: p.side.toLowerCase() === "long" ? "green" : "red", children: pad(p.side, 6) }), _jsx(Text, { color: "white", children: pad(p.size, 12) }), _jsx(Text, { color: "white", children: pad(p.entryPrice, 12) }), _jsx(Text, { color: "white", children: pad(p.markPrice, 12) }), _jsxs(Text, { color: pnlColor(upnl), children: ["$", upnl.toFixed(2)] })] }, i));
+                                return (_jsxs(Box, { flexDirection: "row", children: [hasMultiExchange && _jsx(Text, { color: "cyan", children: pad(p.exchange ?? "—", 14) }), _jsx(Text, { color: "white", children: pad(p.symbol, 10) }), _jsx(Text, { color: p.side.toLowerCase() === "long" ? "green" : "red", children: pad(p.side, 6) }), _jsx(Text, { color: "white", children: pad(p.size, 12) }), _jsx(Text, { color: "white", children: pad(p.entryPrice, 12) }), _jsx(Text, { color: "white", children: pad(p.markPrice, 12) }), _jsxs(Text, { color: pnlColor(upnl), children: ["$", upnl.toFixed(2)] })] }, i));
                             })] }))] }), _jsxs(Box, { marginTop: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Box, { flexDirection: "column", width: "50%", children: [_jsxs(Text, { color: "green", bold: true, children: ["Bids (", bidOrders.length, ")"] }), bidOrders.length === 0 ? (_jsx(Text, { color: "gray", children: "  --" })) : (bidOrders.slice(0, 8).map((o, i) => (_jsxs(Text, { color: "green", children: [pad(o.price, 12), " ", pad(o.size, 10), " ", o.type] }, i))))] }), _jsxs(Box, { flexDirection: "column", width: "50%", children: [_jsxs(Text, { color: "red", bold: true, children: ["Asks (", askOrders.length, ")"] }), askOrders.length === 0 ? (_jsx(Text, { color: "gray", children: "  --" })) : (askOrders.slice(0, 8).map((o, i) => (_jsxs(Text, { color: "red", children: [pad(o.price, 12), " ", pad(o.size, 10), " ", o.type] }, i))))] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Strategy State" }), _jsxs(Box, { flexDirection: "row", flexWrap: "wrap", children: [Object.entries(state.strategyState).slice(0, 12).map(([k, v]) => (_jsxs(Box, { marginRight: 2, children: [_jsxs(Text, { color: "gray", children: [k, ": "] }), _jsx(Text, { color: "white", children: String(v) })] }, k))), Object.keys(state.strategyState).length === 0 && (_jsx(Text, { color: "gray", children: "  --" }))] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", borderStyle: "single", borderColor: "gray", paddingX: 1, height: MAX_LOG_LINES + 2, children: [_jsx(Text, { color: "cyan", bold: true, children: "Log" }), logs.length === 0 ? (_jsx(Text, { color: "gray", children: "  Waiting for events..." })) : (logs.map((entry, i) => (_jsxs(Text, { children: [_jsxs(Text, { color: "gray", children: [entry.time, " "] }), _jsx(Text, { children: colorizeLog(entry.message) })] }, i))))] }), _jsx(Box, { marginTop: 1, flexDirection: "row", justifyContent: "center", children: _jsxs(Text, { color: "gray", children: ["[", _jsx(Text, { color: "white", bold: true, children: "Q" }), "]uit  [", _jsx(Text, { color: "white", bold: true, children: "P" }), "]", paused ? "resume" : "ause"] }) })] }));
 }
 // ── Utility ──

package/dist/bot/tui/index.d.ts

@@ -1,5 +1,5 @@
 export { BotDashboard } from "./BotDashboard.js";
-export type { BotTuiState, Position, OpenOrder, LogEntry, StateListener, LogListener, DashboardProps } from "./BotDashboard.js";
+export type { BotTuiState, ExchangeBalance, Position, OpenOrder, LogEntry, StateListener, LogListener, DashboardProps } from "./BotDashboard.js";
 import type { DashboardProps } from "./BotDashboard.js";
 export declare function startDashboard(props: DashboardProps): {
     unmount: () => void;

package/dist/commands/arb-auto.js

@@ -1144,7 +1144,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
         if (opts.compare)
             return handleCompare(isJson, opts.compare);
         if (opts.rates)
-            return handleRates(isJson, { symbol: opts.symbol, symbols: opts.symbols, all: opts.all, minSpread: opts.min });
+            return handleRates(isJson, { symbol: opts.symbol, symbols: opts.symbols, all: opts.all, minSpread: opts.min, top: opts.top });
         if (opts.basis)
             return handleBasisScan(isJson, { minBasis: opts.min, symbol: typeof opts.basis === "string" ? opts.basis : opts.symbol });
         if (opts.hip3)
@@ -1226,7 +1226,9 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
         if (!isJson())
             console.log(chalk.cyan("  Scanning perp-perp funding rate spreads...\n"));
         const spreads = await fetchFundingSpreads();
-        const filtered = spreads.filter(s => Math.abs(s.spread) >= minSpread);
+        let filtered = spreads.filter(s => Math.abs(s.spread) >= minSpread);
+        if (opts.top)
+            filtered = filtered.slice(0, parseInt(opts.top));
         if (isJson()) {
             const perpPerp = filtered.map(s => {
                 const grossSpread = Math.abs(s.spread);

package/dist/commands/arb.d.ts

@@ -25,6 +25,7 @@ export declare function handleRates(isJson: () => boolean, opts: {
     symbols?: string;
     all?: boolean;
     minSpread: string;
+    top?: string;
 }): Promise<void>;
 export declare function handleBasisScan(isJson: () => boolean, opts: {
     minBasis: string;

package/dist/commands/arb.js

@@ -278,6 +278,8 @@ export async function handleRates(isJson, opts) {
             saveFundingSnapshot(allRates);
     }
     catch { /* non-critical */ }
+    if (opts.top)
+        snapshot.symbols = snapshot.symbols.slice(0, parseInt(opts.top));
     if (isJson()) {
         // Enrich with 24h rate history for each symbol
         const now = new Date();

package/dist/commands/bot.js

@@ -1,6 +1,6 @@
 import chalk from "chalk";
 import { printJson, jsonOk } from "../utils.js";
-import { loadBotConfig, quickGridConfig, quickDCAConfig, runBot, PRESETS, getPreset, getPresetsByStrategy } from "../bot/index.js";
+import { loadBotConfig, parseStrategy, quickGridConfig, quickDCAConfig, runBot, PRESETS, getPreset, getPresetsByStrategy } from "../bot/index.js";
 import { updateJobState } from "../jobs.js";
 import { runTWAP, runFundingArb, runGrid, runDCA, runTrailingStop } from "../strategies/index.js";
 export function registerBotCommands(program, getAdapter, getAdapterFor, isJson) {
@@ -88,7 +88,7 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
     // ── bot quick dca ──
     bot
         .command("quick-dca <symbol> <side> <amount> <interval>")
-        .description("Quick-start a DCA bot")
+        .description("Quick-start a DCA bot (interval: seconds between orders)")
         .option("--orders <n>", "Total orders (0 = unlimited)", "0")
         .option("--price-limit <price>", "Don't buy above / sell below this price")
         .option("--trigger-drop <pct>", "Only buy when price drops X% from recent high")
@@ -343,6 +343,8 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         .option("--max-slots <n>", "Max concurrent positions", "3")
         .option("--daily-limit <usd>", "Daily loss limit in USD", "250")
         .option("--headless", "Run without TUI dashboard")
+        .option("--background", "Run in background (tmux)")
+        .option("--job-id <id>", "Job ID")
         .action(async (symbol, opts) => {
         const adapter = await getAdapter();
         const sym = (symbol ?? "ETH").toUpperCase();
@@ -366,9 +368,27 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
             },
             monitor_interval_sec: 10,
         };
+        if (opts.background) {
+            const { startJob } = await import("../jobs.js");
+            const cliArgs = [
+                `-e`, adapter.name, `apex`, sym,
+                `--preset`, opts.preset, `--max-slots`, opts.maxSlots,
+                `--daily-limit`, opts.dailyLimit,
+            ];
+            const job = startJob({
+                strategy: `bot:apex`,
+                exchange: adapter.name,
+                params: { symbol: sym, ...opts },
+                cliArgs,
+            });
+            if (isJson())
+                return printJson(jsonOk(job));
+            printBotJobStarted(config.name, job.id);
+            return;
+        }
         const mode = resolveOutputMode(isJson, opts.headless);
         const log = makeLog();
-        await runBot(adapter, config, undefined, log, undefined, mode);
+        await runBot(adapter, config, opts.jobId, log, undefined, mode);
     });
     // ── bot reflect ──
     bot
@@ -411,12 +431,24 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
     // ── bot run <strategy> <symbol> ──
     bot
         .command("run <strategy> [symbol]")
-        .description("Run any registered strategy (symbol optional for multi-symbol strategies like funding-auto)")
+        .description("Run a strategy (use 'perp bot list-strategies' to see all). Symbol optional for multi-symbol strategies.")
         .option("--config <path>", "YAML/JSON config file")
         .option("--headless", "Run without TUI dashboard")
         .option("--param <key=value>", "Strategy parameter (repeatable)", (val, acc) => [...acc, val], [])
         .action(async (strategyName, symbol, opts) => {
         const sym = symbol?.toUpperCase() || "ALL";
+        // Strategies that require an explicit symbol
+        const symbolRequiredStrategies = [
+            "grid", "dca", "simple-mm", "engine-mm", "avellaneda-mm",
+            "momentum-breakout", "mean-reversion", "aggressive-taker",
+            "grid-mm", "liquidation-mm", "regime-mm",
+        ];
+        if (sym === "ALL" && symbolRequiredStrategies.includes(strategyName)) {
+            console.error(chalk.red(`\n  Error: The '${strategyName}' strategy requires a <symbol> argument.`));
+            console.error(chalk.gray(`  Usage: perp bot run ${strategyName} <symbol>\n`));
+            process.exitCode = 1;
+            return;
+        }
         // Load or build config
         let config;
         if (opts.config) {
@@ -445,11 +477,12 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
                     params[key] = raw;
             }
             const adapter = await getAdapter();
+            const strategy = parseStrategy(strategyName, params);
             config = {
                 name: `${strategyName}-${sym.toLowerCase()}-${Date.now().toString(36)}`,
                 exchange: adapter.name,
                 symbol: sym,
-                strategy: params,
+                strategy,
                 entry_conditions: [{ type: "always", value: 0 }],
                 exit_conditions: [],
                 risk: {
@@ -464,10 +497,14 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         }
         // Verify strategy is registered
         await import("../bot/engine.js");
-        const { getStrategy } = await import("../bot/strategy-registry.js");
+        const { getStrategy, listStrategies: listStrats } = await import("../bot/strategy-registry.js");
         if (!getStrategy(strategyName)) {
+            const available = listStrats();
             console.error(chalk.red(`\n  Unknown strategy: "${strategyName}"`));
-            console.error(chalk.gray(`  Run 'perp bot list-strategies' to see available strategies.\n`));
+            console.error(chalk.gray(`\n  Available strategies:`));
+            for (const s of available)
+                console.error(chalk.gray(`    - ${s}`));
+            console.error();
             return;
         }
         const adapter = await getAdapter();

package/dist/commands/bridge.js

@@ -3,7 +3,7 @@ import { formatUsd, makeTable, printJson, jsonOk } from "../utils.js";
 import { logExecution } from "../execution-log.js";
 import { executeBestBridge, getAllQuotes, checkDebridgeStatus, checkBridgeGasBalance, CHAIN_IDS, USDC_ADDRESSES, EXCHANGE_TO_CHAIN, } from "../bridge-engine.js";
 export function registerBridgeCommands(program, isJson) {
-    const bridge = program.command("bridge").description("Cross-chain USDC bridge (deBridge DLN)");
+    const bridge = program.command("bridge").description("Cross-chain USDC bridge (deBridge DLN). See also: perp funds bridge (CCTP V2)");
     // ── bridge chains ──
     bridge
         .command("chains")

package/dist/commands/funds.js

@@ -628,7 +628,7 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork) {
     // ═══════════════════════════════════════════════════════
     funds
         .command("bridge")
-        .description("Bridge USDC between chains via CCTP V2")
+        .description("Bridge USDC between chains via CCTP V2. See also: perp bridge (deBridge DLN)")
         .requiredOption("--from <chain>", "Source chain (arbitrum, ethereum)")
         .requiredOption("--to <chain>", "Destination chain (arbitrum, ethereum, solana)")
         .requiredOption("--amount <amount>", "USDC amount")

package/dist/commands/history.js

@@ -75,7 +75,11 @@ export function registerHistoryCommands(program, isJson, getAdapterForExchange)
                         : chalk.red;
                 const sideColor = r.side === "buy" || r.side === "long" ? chalk.green : chalk.red;
                 const time = new Date(r.timestamp).toLocaleString();
-                const notional = r.notional ? `$${formatUsd(r.notional)}` : r.price ? `$${formatUsd(Number(r.price) * Number(r.size))}` : "-";
+                const metaPrice = r.meta?.price ?? r.meta?.markPrice ?? r.meta?.entryPrice;
+                const effectivePrice = r.price ?? (typeof metaPrice === "number" || typeof metaPrice === "string" ? String(metaPrice) : undefined);
+                const sizeNum = Number(r.size);
+                const priceNum = effectivePrice ? Number(effectivePrice) : 0;
+                const notional = r.notional ? `$${formatUsd(r.notional)}` : (priceNum > 0 && sizeNum > 0) ? `$${formatUsd(priceNum * sizeNum)}` : "-";
                 return [
                     chalk.gray(time),
                     chalk.white(r.exchange),

package/dist/commands/market.js

@@ -163,7 +163,7 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
             if (isJson())
                 return printJson(jsonError("SYMBOL_NOT_FOUND", `Market ${sym} not found`));
             console.log(chalk.red(`\n  Market "${sym}" not found.\n`));
-            return;
+            return process.exit(1);
         }
         if (isJson())
             return printJson(jsonOk(m));
@@ -228,9 +228,10 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
     market
         .command("trades <symbol>")
         .description("Recent trades for a symbol")
-        .action(async (symbol) => {
+        .option("--limit <n>", "Number of recent trades to show", "20")
+        .action(async (symbol, opts) => {
         const adapter = await getAdapter();
-        const trades = await adapter.getRecentTrades(symbol.toUpperCase(), 20);
+        const trades = await adapter.getRecentTrades(symbol.toUpperCase(), parseInt(opts.limit));
         if (isJson())
             return printJson(jsonOk(trades));
         if (trades.length === 0) {
@@ -258,12 +259,20 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
             console.log(chalk.gray("\n  No funding history.\n"));
             return;
         }
-        const rows = history.map((h) => [
-            new Date(h.time).toLocaleString(),
-            formatPercent(h.rate),
-            h.price != null ? `$${formatUsd(h.price)}` : chalk.gray("n/a"),
-        ]);
-        console.log(makeTable(["Time", "Funding Rate", "Oracle"], rows));
+        const hasOracle = history.some((h) => h.price != null && h.price !== "0" && h.price !== "");
+        const rows = history.map((h) => {
+            const base = [
+                new Date(h.time).toLocaleString(),
+                formatPercent(h.rate),
+            ];
+            if (hasOracle)
+                base.push(h.price != null ? `$${formatUsd(h.price)}` : chalk.gray("n/a"));
+            return base;
+        });
+        const headers = hasOracle ? ["Time", "Funding Rate", "Oracle"] : ["Time", "Funding Rate"];
+        console.log(makeTable(headers, rows));
+        if (!hasOracle)
+            console.log(chalk.gray("  Note: Oracle price not available for this exchange.\n"));
     });
     market
         .command("mid <symbol>")
@@ -367,7 +376,7 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
             console.log(chalk.cyan.bold("\n  HIP-3 Deployed Perp DEXes\n"));
             const rows = dexes.map(d => [
                 chalk.white.bold(d.name),
-                chalk.gray(d.deployer.slice(0, 10) + "..."),
+                chalk.gray(d.deployer ? d.deployer.slice(0, 6) + "..." + d.deployer.slice(-4) : "-"),
                 String(d.assets.length),
                 d.assets.slice(0, 5).join(", ") + (d.assets.length > 5 ? ` +${d.assets.length - 5}` : ""),
             ]);

package/dist/commands/trade.js

@@ -244,7 +244,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
     trade
         .command("limit <symbol> <side> <price> <size>")
         .description("Place a limit order")
-        .option("--tif <tif>", "Time in force: GTC, IOC, ALO, TOB", "GTC")
+        .option("--tif <tif>", "Time in force: GTC, IOC, ALO (HL only), TOB (HL only)", "GTC")
         .option("--reduce-only", "Reduce only order")
         .option("--client-id <id>", "Client order ID for idempotent tracking")
         .option("--auto-id", "Auto-generate a client order ID")
@@ -494,7 +494,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
     // === TP/SL — Pacifica + Hyperliquid ===
     trade
         .command("tpsl <symbol> <side>")
-        .description("Set take-profit / stop-loss on a position")
+        .description("Set take-profit / stop-loss on a position (side: the side to CLOSE — buy to close short, sell to close long)")
         .option("--tp <price>", "Take profit trigger price")
         .option("--tp-limit <price>", "Take profit limit price")
         .option("--sl <price>", "Stop loss trigger price")
@@ -558,7 +558,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
     trade
         .command("scale-tp <symbol>")
         .description("Place multiple take-profit limit orders at different price levels (분할익절)")
-        .requiredOption("--levels <levels>", "Comma-separated price:percent pairs (e.g., 72000:25,75000:25,80000:50)")
+        .requiredOption("--levels <levels>", "[required] Comma-separated price:percent pairs (e.g., 72000:25,75000:25,80000:50)")
         .option("--size <size>", "Override total position size (default: uses current position)")
         .action(async (symbol, opts) => {
         const sym = symbol.toUpperCase();

package/dist/exchanges/aster.d.ts

@@ -14,6 +14,10 @@ export declare class AsterAdapter implements ExchangeAdapter {
     private _testnet;
     constructor(apiKey?: string, apiSecret?: string, testnet?: boolean);
     get isReadOnly(): boolean;
+    /** CLI symbol → Aster API symbol (ETH → ETHUSDT) */
+    private _toApi;
+    /** Aster API symbol → CLI symbol (ETHUSDT → ETH) */
+    private _fromApi;
     init(): Promise<void>;
     getMarkets(): Promise<ExchangeMarketInfo[]>;
     getOrderbook(symbol: string): Promise<{