perp-cli 0.4.2 → 0.4.9

package/dist/index.js

@@ -7,39 +7,35 @@ config({ path: resolve(process.env.HOME || "~", ".perp", ".env") });
 config();
 import { Command } from "commander";
 import chalk from "chalk";
-import { loadPrivateKey, parseSolanaKeypair } from "./config.js";
+import { Keypair } from "@solana/web3.js";
+import { tryLoadPrivateKey, parseSolanaKeypair } from "./config.js";
 import { PacificaAdapter } from "./exchanges/pacifica.js";
 import { HyperliquidAdapter } from "./exchanges/hyperliquid.js";
 import { registerMarketCommands } from "./commands/market.js";
 import { registerAccountCommands } from "./commands/account.js";
 import { registerTradeCommands } from "./commands/trade.js";
 import { registerManageCommands } from "./commands/manage.js";
-import { registerStreamCommands } from "./commands/stream.js";
+// stream commands removed — WS feeds still used by dashboard/event-stream internally
 import { registerArbCommands } from "./commands/arb.js";
 import { registerWalletCommands } from "./commands/wallet.js";
 import { registerBridgeCommands } from "./commands/bridge.js";
-import { registerDepositCommands } from "./commands/deposit.js";
-import { registerAlertCommands } from "./commands/alert.js";
+// deposit + withdraw merged into funds
+import { registerFundsCommands } from "./commands/funds.js";
+// alert commands removed
 import { registerArbAutoCommands } from "./commands/arb-auto.js";
-import { registerArbManageCommands } from "./commands/arb-manage.js";
-import { registerGapCommands } from "./commands/gap.js";
+import { registerArbManageCommands } from "./commands/arb/index.js";
 import { registerAgentCommands } from "./commands/agent.js";
-import { registerWithdrawCommands } from "./commands/withdraw.js";
 import { registerRebalanceCommands } from "./commands/rebalance.js";
 import { registerBotCommands } from "./commands/bot.js";
-import { registerHealthCommands } from "./commands/health.js";
-import { registerPortfolioCommands } from "./commands/portfolio.js";
 import { registerRiskCommands } from "./commands/risk.js";
 import { registerHistoryCommands } from "./commands/history.js";
-import { registerAnalyticsCommands } from "./commands/analytics.js";
 import { registerSettingsCommands } from "./commands/settings.js";
-import { registerDexCommands } from "./commands/dex.js";
+// dex commands merged into market (hip3) — use --dex flag for markets/balance
 import { registerPlanCommands } from "./commands/plan.js";
-import { registerFundingCommands } from "./commands/funding.js";
+// funding merged into arb.ts
 import { registerBacktestCommands } from "./commands/backtest.js";
 import { registerDashboardCommands } from "./commands/dashboard.js";
 import { registerInitCommand, EXCHANGE_ENV_MAP, validateKey } from "./commands/init.js";
-import { registerEnvCommands } from "./commands/env.js";
 import { loadSettings, saveSettings } from "./settings.js";
 import { setSharedApiNetwork } from "./shared-api.js";
 const _require = createRequire(import.meta.url);
@@ -59,6 +55,7 @@ program
     .option("--fields <fields>", "Comma-separated fields to include in JSON output (e.g. totalEquity,positions)")
     .option("--ndjson", "Output newline-delimited JSON (one object per line for streaming)")
     .option("--dry-run", "Simulate trades without executing (log as simulated)")
+    .option("-w, --wallet <name>", "Use a specific wallet by name (from 'perp wallet list')")
     .option("--dex <name>", "HIP-3 deployed perp dex name (Hyperliquid only)")
     .configureOutput({
     writeErr: (str) => {
@@ -80,71 +77,83 @@ let _adapter = null;
 let _pacificaAdapter = null;
 let _hlAdapter = null;
 let _lighterAdapter = null;
+/** Map short aliases to canonical exchange names. Full names pass through. */
+function resolveExchangeAlias(name) {
+    const aliases = {
+        hl: "hyperliquid",
+        lt: "lighter",
+        pac: "pacifica",
+    };
+    return aliases[name.toLowerCase()] ?? name.toLowerCase();
+}
 function getExchange() {
-    return program.opts().exchange;
+    return resolveExchangeAlias(program.opts().exchange);
 }
 async function getAdapter() {
-    if (_adapter)
-        return _adapter;
     const opts = program.opts();
-    const exchange = opts.exchange;
+    const walletName = opts.wallet;
+    // Skip cache when --wallet is specified (different wallet = different account)
+    if (!walletName && _adapter)
+        return _adapter;
+    const exchange = resolveExchangeAlias(opts.exchange);
     const network = opts.network;
     const isTestnet = network === "testnet";
+    // Try to load key — null means no key configured (read-only mode)
+    const pk = await tryLoadPrivateKey(exchange, opts.privateKey, walletName);
     switch (exchange) {
         case "pacifica": {
-            const pk = await loadPrivateKey("pacifica", opts.privateKey);
-            const keypair = parseSolanaKeypair(pk);
+            const keypair = pk ? parseSolanaKeypair(pk) : Keypair.generate();
             const pacNetwork = (isTestnet ? "testnet" : "mainnet");
             const settings = loadSettings();
             const builderCode = process.env.PACIFICA_BUILDER_CODE || settings.referralCodes.pacifica || "PERPCLI";
-            _pacificaAdapter = new PacificaAdapter(keypair, pacNetwork, builderCode);
+            _pacificaAdapter = new PacificaAdapter(keypair, pacNetwork, builderCode, !!pk);
             _adapter = _pacificaAdapter;
             break;
         }
         case "hyperliquid": {
-            const pk = await loadPrivateKey("hyperliquid", opts.privateKey);
-            _hlAdapter = new HyperliquidAdapter(pk, isTestnet);
+            _hlAdapter = new HyperliquidAdapter(pk ?? undefined, isTestnet);
             if (opts.dex)
                 _hlAdapter.setDex(opts.dex);
             await _hlAdapter.init();
-            const hlSettings = loadSettings();
-            if (hlSettings.referrals && !hlSettings.referralApplied.hyperliquid) {
-                const hlRef = process.env.HL_REFERRAL_CODE || hlSettings.referralCodes.hyperliquid;
-                if (hlRef) {
-                    _hlAdapter.autoSetReferrer(hlRef).then(() => {
-                        const s = loadSettings();
-                        s.referralApplied.hyperliquid = true;
-                        saveSettings(s);
-                    }).catch(() => {
-                        // Already referred or API error — mark as done either way
-                        const s = loadSettings();
-                        s.referralApplied.hyperliquid = true;
-                        saveSettings(s);
-                    });
+            if (pk) {
+                const hlSettings = loadSettings();
+                if (hlSettings.referrals && !hlSettings.referralApplied.hyperliquid) {
+                    const hlRef = process.env.HL_REFERRAL_CODE || hlSettings.referralCodes.hyperliquid;
+                    if (hlRef) {
+                        _hlAdapter.autoSetReferrer(hlRef).then(() => {
+                            const s = loadSettings();
+                            s.referralApplied.hyperliquid = true;
+                            saveSettings(s);
+                        }).catch(() => {
+                            const s = loadSettings();
+                            s.referralApplied.hyperliquid = true;
+                            saveSettings(s);
+                        });
+                    }
                 }
             }
             _adapter = _hlAdapter;
             break;
         }
         case "lighter": {
-            const pk = await loadPrivateKey("lighter", opts.privateKey);
             const { LighterAdapter } = await import("./exchanges/lighter.js");
-            _lighterAdapter = new LighterAdapter(pk, isTestnet);
+            _lighterAdapter = new LighterAdapter(pk ?? "", isTestnet);
             await _lighterAdapter.init();
-            const ltSettings = loadSettings();
-            if (ltSettings.referrals && !ltSettings.referralApplied.lighter) {
-                const ltRef = process.env.LIGHTER_REFERRAL_CODE || ltSettings.referralCodes.lighter;
-                if (ltRef) {
-                    _lighterAdapter.useReferralCode(ltRef).then(() => {
-                        const s = loadSettings();
-                        s.referralApplied.lighter = true;
-                        saveSettings(s);
-                    }).catch(() => {
-                        // Already referred or API error — mark as done either way
-                        const s = loadSettings();
-                        s.referralApplied.lighter = true;
-                        saveSettings(s);
-                    });
+            if (pk) {
+                const ltSettings = loadSettings();
+                if (ltSettings.referrals && !ltSettings.referralApplied.lighter) {
+                    const ltRef = process.env.LIGHTER_REFERRAL_CODE || ltSettings.referralCodes.lighter;
+                    if (ltRef) {
+                        _lighterAdapter.useReferralCode(ltRef).then(() => {
+                            const s = loadSettings();
+                            s.referralApplied.lighter = true;
+                            saveSettings(s);
+                        }).catch(() => {
+                            const s = loadSettings();
+                            s.referralApplied.lighter = true;
+                            saveSettings(s);
+                        });
+                    }
                 }
             }
             _adapter = _lighterAdapter;
@@ -162,7 +171,7 @@ function getAdapterSync() {
     return _adapter;
 }
 function isJson() {
-    return !!program.opts().json;
+    return !!program.opts().json || process.argv.includes("--ndjson");
 }
 function isDryRun() {
     return !!program.opts().dryRun;
@@ -180,30 +189,32 @@ function getHLAdapter() {
 }
 // Register command groups with async adapter getter
 registerMarketCommands(program, getAdapter, isJson);
-registerAccountCommands(program, getAdapter, isJson);
-registerTradeCommands(program, getAdapter, isJson, isDryRun);
+registerAccountCommands(program, getAdapter, isJson, getAdapterForExchange);
+registerTradeCommands(program, getAdapter, isJson, isDryRun, getAdapterForExchange);
 registerManageCommands(program, getAdapter, isJson, getPacificaAdapter);
-registerStreamCommands(program, () => program.opts().network, getExchange, getAdapter);
-registerArbCommands(program, isJson);
+// stream commands removed
+registerArbCommands(program, isJson, getAdapterForExchange);
 registerWalletCommands(program, isJson);
 registerBridgeCommands(program, isJson);
-registerDepositCommands(program, getAdapter, isJson, () => program.opts().network);
-registerAlertCommands(program, isJson, getAdapterForExchange);
+registerFundsCommands(program, getAdapter, isJson, () => program.opts().network);
+// alert commands removed
 // Helper to get adapter for a specific exchange (used by arb-auto)
-async function getAdapterForExchange(exchange) {
+async function getAdapterForExchange(rawExchange) {
+    const exchange = resolveExchangeAlias(rawExchange);
     const opts = program.opts();
     const network = opts.network;
     const isTestnet = network === "testnet";
+    const walletName = opts.wallet;
+    const pk = await tryLoadPrivateKey(exchange, opts.privateKey, walletName);
     switch (exchange) {
         case "pacifica": {
             if (_pacificaAdapter)
                 return _pacificaAdapter;
-            const pk = await loadPrivateKey("pacifica", opts.privateKey);
-            const keypair = parseSolanaKeypair(pk);
+            const keypair = pk ? parseSolanaKeypair(pk) : Keypair.generate();
             const pacNetwork = (isTestnet ? "testnet" : "mainnet");
             const s1 = loadSettings();
             const builderCode = process.env.PACIFICA_BUILDER_CODE || s1.referralCodes.pacifica || "PERPCLI";
-            _pacificaAdapter = new PacificaAdapter(keypair, pacNetwork, builderCode);
+            _pacificaAdapter = new PacificaAdapter(keypair, pacNetwork, builderCode, !!pk);
             if (!_adapter)
                 _adapter = _pacificaAdapter;
             return _pacificaAdapter;
@@ -211,24 +222,25 @@ async function getAdapterForExchange(exchange) {
         case "hyperliquid": {
             if (_hlAdapter)
                 return _hlAdapter;
-            const pk = await loadPrivateKey("hyperliquid", opts.privateKey);
-            _hlAdapter = new HyperliquidAdapter(pk, isTestnet);
+            _hlAdapter = new HyperliquidAdapter(pk ?? undefined, isTestnet);
             if (opts.dex)
                 _hlAdapter.setDex(opts.dex);
             await _hlAdapter.init();
-            const s2 = loadSettings();
-            if (s2.referrals && !s2.referralApplied.hyperliquid) {
-                const hlRef = process.env.HL_REFERRAL_CODE || s2.referralCodes.hyperliquid;
-                if (hlRef) {
-                    _hlAdapter.autoSetReferrer(hlRef).then(() => {
-                        const s = loadSettings();
-                        s.referralApplied.hyperliquid = true;
-                        saveSettings(s);
-                    }).catch(() => {
-                        const s = loadSettings();
-                        s.referralApplied.hyperliquid = true;
-                        saveSettings(s);
-                    });
+            if (pk) {
+                const s2 = loadSettings();
+                if (s2.referrals && !s2.referralApplied.hyperliquid) {
+                    const hlRef = process.env.HL_REFERRAL_CODE || s2.referralCodes.hyperliquid;
+                    if (hlRef) {
+                        _hlAdapter.autoSetReferrer(hlRef).then(() => {
+                            const s = loadSettings();
+                            s.referralApplied.hyperliquid = true;
+                            saveSettings(s);
+                        }).catch(() => {
+                            const s = loadSettings();
+                            s.referralApplied.hyperliquid = true;
+                            saveSettings(s);
+                        });
+                    }
                 }
             }
             if (!_adapter)
@@ -238,23 +250,24 @@ async function getAdapterForExchange(exchange) {
         case "lighter": {
             if (_lighterAdapter)
                 return _lighterAdapter;
-            const pk = await loadPrivateKey("lighter", opts.privateKey);
             const { LighterAdapter } = await import("./exchanges/lighter.js");
-            _lighterAdapter = new LighterAdapter(pk, isTestnet);
+            _lighterAdapter = new LighterAdapter(pk ?? "", isTestnet);
             await _lighterAdapter.init();
-            const s3 = loadSettings();
-            if (s3.referrals && !s3.referralApplied.lighter) {
-                const ltRef = process.env.LIGHTER_REFERRAL_CODE || s3.referralCodes.lighter;
-                if (ltRef) {
-                    _lighterAdapter.useReferralCode(ltRef).then(() => {
-                        const s = loadSettings();
-                        s.referralApplied.lighter = true;
-                        saveSettings(s);
-                    }).catch(() => {
-                        const s = loadSettings();
-                        s.referralApplied.lighter = true;
-                        saveSettings(s);
-                    });
+            if (pk) {
+                const s3 = loadSettings();
+                if (s3.referrals && !s3.referralApplied.lighter) {
+                    const ltRef = process.env.LIGHTER_REFERRAL_CODE || s3.referralCodes.lighter;
+                    if (ltRef) {
+                        _lighterAdapter.useReferralCode(ltRef).then(() => {
+                            const s = loadSettings();
+                            s.referralApplied.lighter = true;
+                            saveSettings(s);
+                        }).catch(() => {
+                            const s = loadSettings();
+                            s.referralApplied.lighter = true;
+                            saveSettings(s);
+                        });
+                    }
                 }
             }
             if (!_adapter)
@@ -271,8 +284,9 @@ async function getHLAdapterForDex(dex) {
     if (_dexAdapters.has(dex))
         return _dexAdapters.get(dex);
     const opts = program.opts();
-    const pk = await loadPrivateKey("hyperliquid", opts.privateKey);
-    const adapter = new HyperliquidAdapter(pk, opts.network === "testnet");
+    const walletName = opts.wallet;
+    const pk = await tryLoadPrivateKey("hyperliquid", opts.privateKey, walletName);
+    const adapter = new HyperliquidAdapter(pk ?? undefined, opts.network === "testnet");
     if (dex !== "hl")
         adapter.setDex(dex);
     await adapter.init();
@@ -281,92 +295,43 @@ async function getHLAdapterForDex(dex) {
 }
 registerArbAutoCommands(program, getAdapterForExchange, isJson, getHLAdapterForDex);
 registerArbManageCommands(program, getAdapterForExchange, isJson);
-registerGapCommands(program, isJson);
 registerAgentCommands(program, getAdapter, isJson);
-registerWithdrawCommands(program, getAdapter, isJson);
+// withdraw merged into funds
 registerRebalanceCommands(program, getAdapterForExchange, isJson);
 // Jobs & strategies
 import { registerJobsCommands } from "./commands/jobs.js";
-import { registerRunCommands } from "./commands/run.js";
 registerJobsCommands(program, isJson);
-registerRunCommands(program, getAdapter, getAdapterForExchange, isJson);
 registerBotCommands(program, getAdapter, getAdapterForExchange, isJson);
 // Agent-friendly commands
-registerHealthCommands(program, isJson);
-registerPortfolioCommands(program, getAdapterForExchange, isJson);
 registerRiskCommands(program, getAdapterForExchange, isJson);
-registerHistoryCommands(program, isJson);
-registerAnalyticsCommands(program, getAdapterForExchange, isJson);
+registerHistoryCommands(program, isJson, getAdapterForExchange);
 registerSettingsCommands(program, isJson, getAdapterForExchange);
-registerDexCommands(program, getAdapter, isJson);
+// dex commands removed — use 'market hip3' + --dex flag
 registerPlanCommands(program, getAdapter, isJson);
-registerFundingCommands(program, isJson);
+// funding merged into arb — registerFundingCommands removed
 registerBacktestCommands(program, isJson);
 registerDashboardCommands(program, getAdapterForExchange, isJson, getHLAdapterForDex);
 registerInitCommand(program);
-registerEnvCommands(program, isJson);
-// Agent discovery: perp api-spec — returns full CLI spec as JSON
-program
+// Agent discovery: perp api-spec — deprecated, use 'perp agent schema'
+const apiSpecCmd = program
     .command("api-spec")
-    .description("Return full CLI command spec as JSON (for agent discovery)")
+    .description("Use 'perp agent schema'")
     .action(async () => {
     const { jsonOk, printJson } = await import("./utils.js");
     const { getCliSpec } = await import("./cli-spec.js");
     printJson(jsonOk(getCliSpec(program)));
 });
-// Status command
-program
-    .command("status")
-    .description("Quick overview: account + positions + open orders")
-    .action(async () => {
-    const adapter = await getAdapter();
-    const json = isJson();
-    try {
-        const [balance, positions, orders] = await Promise.all([
-            adapter.getBalance(),
-            adapter.getPositions(),
-            adapter.getOpenOrders(),
-        ]);
-        if (json) {
-            const { jsonOk, printJson } = await import("./utils.js");
-            return printJson(jsonOk({ exchange: adapter.name, balance, positions, orders }));
-        }
-        console.log(chalk.cyan.bold(`\n  ${adapter.name.toUpperCase()} Account Status\n`));
-        console.log(`  Equity:      $${Number(balance.equity).toFixed(2)}`);
-        console.log(`  Available:   $${Number(balance.available).toFixed(2)}`);
-        console.log(`  Margin Used: $${Number(balance.marginUsed).toFixed(2)}`);
-        console.log(`  Positions:   ${positions.length}`);
-        console.log(`  Open Orders: ${orders.length}`);
-        if (positions.length > 0) {
-            console.log(chalk.cyan.bold("\n  Positions:"));
-            positions.forEach((p) => {
-                const color = p.side === "long" ? chalk.green : chalk.red;
-                const pnlNum = Number(p.unrealizedPnl);
-                const pnlColor = pnlNum >= 0 ? chalk.green : chalk.red;
-                console.log(`    ${color(p.side.toUpperCase().padEnd(5))} ${chalk.white(p.symbol.padEnd(12))} ${p.size.padEnd(10)} entry: $${Number(p.entryPrice).toFixed(2)}  pnl: ${pnlColor(pnlNum >= 0 ? "+" : "")}$${pnlNum.toFixed(2)}`);
-            });
-        }
-        if (orders.length > 0) {
-            console.log(chalk.cyan.bold("\n  Open Orders:"));
-            orders.forEach((o) => {
-                const color = o.side === "buy" ? chalk.green : chalk.red;
-                console.log(`    ${color(o.side.toUpperCase().padEnd(4))} ${chalk.white(o.symbol.padEnd(12))} ${o.type.padEnd(8)} $${Number(o.price).toFixed(2)} x ${o.size}`);
-            });
-        }
-        console.log();
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        if (isJson()) {
-            const { jsonError } = await import("./utils.js");
-            console.log(JSON.stringify(jsonError("COMMAND_ERROR", msg)));
-        }
-        else {
-            console.error(chalk.red(`Error: ${msg}`));
-        }
-        process.exit(1);
+apiSpecCmd._hidden = true;
+// Deprecated: perp status → use 'perp portfolio' or 'perp account'
+const statusCmd = program.command("status").description("Use 'perp portfolio'")
+    .option("--health", "Check connectivity").action(async (opts) => {
+    if (opts.health) {
+        const { runHealthCheck } = await import("./commands/risk.js");
+        return runHealthCheck(isJson);
     }
+    console.log("Use 'perp portfolio' or 'perp account' instead.");
 });
+statusCmd._hidden = true;
 // Switch shared API URLs if --network testnet is used
 program.hook("preAction", () => {
     const network = program.opts().network;
@@ -375,7 +340,7 @@ program.hook("preAction", () => {
 });
 // Smart landing page: `perp` with no subcommand
 const rawArgs = process.argv.slice(2);
-const hasSubcommand = rawArgs.some((a) => !a.startsWith("-") && !["pacifica", "hyperliquid", "lighter", "mainnet", "testnet"].includes(a));
+const hasSubcommand = rawArgs.some((a) => !a.startsWith("-") && !["pacifica", "hyperliquid", "lighter", "hl", "lt", "pac", "mainnet", "testnet"].includes(a));
 if (rawArgs.length === 0 || (!hasSubcommand && !rawArgs.includes("-h") && !rawArgs.includes("--help") && !rawArgs.includes("-V") && !rawArgs.includes("--version"))) {
     // No subcommand — show smart landing instead of help dump
     (async () => {

package/dist/liquidity.d.ts

@@ -1,4 +1,5 @@
 import type { ExchangeAdapter } from "./exchanges/interface.js";
+import type { SpotAdapter } from "./exchanges/spot-interface.js";
 export interface LiquidityCheck {
     /** Max executable size (base) within slippage tolerance */
     maxSize: number;
@@ -32,3 +33,14 @@ export declare function checkArbLiquidity(longAdapter: ExchangeAdapter, shortAda
     longSlippage: number;
     shortSlippage: number;
 }>;
+/**
+ * Check liquidity for a spot+perp arb pair.
+ * Spot side uses asks (for buy) or bids (for sell).
+ * Perp side uses bids (for short entry) or asks (for long entry).
+ */
+export declare function checkSpotPerpLiquidity(spotAdapter: SpotAdapter, perpAdapter: ExchangeAdapter, spotSymbol: string, perpSymbol: string, sizeUsd: number, maxSlippagePct?: number, log?: (msg: string) => void): Promise<{
+    viable: boolean;
+    adjustedSizeUsd: number;
+    spotSlippage: number;
+    perpSlippage: number;
+}>;

package/dist/liquidity.js

@@ -98,3 +98,46 @@ export async function checkArbLiquidity(longAdapter, shortAdapter, symbol, sizeU
         return { viable: false, adjustedSizeUsd: 0, longSlippage: 0, shortSlippage: 0 };
     }
 }
+/**
+ * Check liquidity for a spot+perp arb pair.
+ * Spot side uses asks (for buy) or bids (for sell).
+ * Perp side uses bids (for short entry) or asks (for long entry).
+ */
+export async function checkSpotPerpLiquidity(spotAdapter, perpAdapter, spotSymbol, perpSymbol, sizeUsd, maxSlippagePct = 0.5, log) {
+    try {
+        const [spotOB, perpOB] = await Promise.all([
+            spotAdapter.getSpotOrderbook(spotSymbol),
+            perpAdapter.getOrderbook(perpSymbol),
+        ]);
+        // Spot buy = consume asks; Perp short = consume bids
+        const spotCheck = computeExecutableSize(spotOB.asks, sizeUsd, maxSlippagePct);
+        const perpCheck = computeExecutableSize(perpOB.bids, sizeUsd, maxSlippagePct);
+        // Cross-market price gap check (spot vs perp)
+        if (spotOB.asks.length > 0 && perpOB.bids.length > 0) {
+            const bestSpotAsk = Number(spotOB.asks[0][0]);
+            const bestPerpBid = Number(perpOB.bids[0][0]);
+            const gapPct = Math.abs(bestSpotAsk - bestPerpBid) / Math.min(bestSpotAsk, bestPerpBid) * 100;
+            if (gapPct > 2) {
+                log?.(`[LIQ] spot-perp ${spotSymbol}: price gap ${gapPct.toFixed(2)}% too wide`);
+                return { viable: false, adjustedSizeUsd: 0, spotSlippage: spotCheck.slippagePct, perpSlippage: perpCheck.slippagePct };
+            }
+        }
+        const executableUsd = Math.min(spotCheck.maxSize * spotCheck.avgFillPrice, perpCheck.maxSize * perpCheck.avgFillPrice);
+        const minViable = sizeUsd * 0.2;
+        if (executableUsd < minViable) {
+            log?.(`[LIQ] spot-perp ${spotSymbol}: only $${executableUsd.toFixed(0)} executable (need min $${minViable.toFixed(0)})`);
+            return { viable: false, adjustedSizeUsd: 0, spotSlippage: spotCheck.slippagePct, perpSlippage: perpCheck.slippagePct };
+        }
+        const adjustedSizeUsd = Math.min(sizeUsd, executableUsd);
+        return {
+            viable: true,
+            adjustedSizeUsd,
+            spotSlippage: spotCheck.slippagePct,
+            perpSlippage: perpCheck.slippagePct,
+        };
+    }
+    catch {
+        log?.(`[LIQ] spot-perp ${spotSymbol}: orderbook fetch failed`);
+        return { viable: false, adjustedSizeUsd: 0, spotSlippage: 0, perpSlippage: 0 };
+    }
+}