perp-cli 0.4.8 → 0.4.10

package/dist/exchanges/hyperliquid-spot.js

@@ -27,6 +27,7 @@ export class HyperliquidSpotAdapter {
     _spotAssetReverse = new Map(); // spotIndex → "ETH"
     _spotDecimals = new Map();
     _initialized = false;
+    _cachedMetaCtx = null;
     constructor(hlAdapter) {
         this._hl = hlAdapter;
     }
@@ -39,9 +40,12 @@ export class HyperliquidSpotAdapter {
     }
     async _loadSpotMeta() {
         try {
-            const meta = await this._infoPost({ type: "spotMeta" });
-            if (!meta?.universe)
+            // Single API call — spotMetaAndAssetCtxs includes all data from spotMeta
+            const metaCtx = await this._infoPost({ type: "spotMetaAndAssetCtxs" });
+            if (!metaCtx?.[0]?.universe)
                 return;
+            this._cachedMetaCtx = metaCtx;
+            const meta = metaCtx[0];
             // Token index → name map
             const tokenNames = new Map();
             for (const t of meta.tokens ?? []) {
@@ -54,29 +58,15 @@ export class HyperliquidSpotAdapter {
                 if (!baseToken)
                     continue;
                 const key = baseToken.toUpperCase();
-                // Prefer /USDC pairs (quote token = USDC). Skip non-USDC pairs if we already have one.
                 const isUsdcPair = u.tokens[1] === usdcTokenIndex;
                 if (this._spotAssetMap.has(key) && !isUsdcPair)
                     continue;
                 this._spotAssetMap.set(key, u.index);
                 this._spotAssetReverse.set(u.index, key);
-            }
-            // Get spot decimals from metaAndAssetCtxs
-            const metaCtx = await this._infoPost({ type: "spotMetaAndAssetCtxs" });
-            if (metaCtx?.[0]?.universe) {
-                for (const u of metaCtx[0].universe) {
-                    const baseToken = tokenNames.get(u.tokens[0]) ?? "";
-                    if (!baseToken)
-                        continue;
-                    const key = baseToken.toUpperCase();
-                    const isUsdcPair = u.tokens[1] === usdcTokenIndex;
-                    if (this._spotDecimals.has(key) && !isUsdcPair)
-                        continue;
-                    this._spotDecimals.set(key, {
-                        size: u.szDecimals ?? 2,
-                        price: 6, // HL spot prices use up to 6 significant digits
-                    });
-                }
+                this._spotDecimals.set(key, {
+                    size: u.szDecimals ?? 2,
+                    price: 6,
+                });
             }
         }
         catch (e) {
@@ -86,7 +76,9 @@ export class HyperliquidSpotAdapter {
     async getSpotMarkets() {
         await this.init();
         try {
-            const metaCtx = await this._infoPost({ type: "spotMetaAndAssetCtxs" });
+            // Reuse cached metaCtx from init, or fetch fresh if cache expired
+            const metaCtx = this._cachedMetaCtx
+                ?? await this._infoPost({ type: "spotMetaAndAssetCtxs" });
             if (!metaCtx?.[0]?.universe)
                 return [];
             const tokenNames = new Map();

package/dist/exchanges/lighter-spot.js

@@ -83,28 +83,26 @@ export class LighterSpotAdapter {
     }
     async getSpotMarkets() {
         await this.init();
-        const markets = [];
-        for (const [symbol, marketId] of this._spotMarketMap) {
+        const entries = Array.from(this._spotMarketMap.entries());
+        // Fetch all orderbooks in parallel (instead of sequential per-market)
+        const obResults = await Promise.allSettled(entries.map(([symbol]) => this.getSpotOrderbook(symbol).then(ob => {
+            if (ob.bids.length > 0 && ob.asks.length > 0) {
+                return String((Number(ob.bids[0][0]) + Number(ob.asks[0][0])) / 2);
+            }
+            return "0";
+        })));
+        return entries.map(([symbol], i) => {
             const parts = symbol.split("/");
             const base = parts[0] ?? "";
             const quote = parts[1] ?? "USDC";
             const dec = this._spotDecimals.get(symbol) ?? { size: 4, price: 2 };
-            // Get mark price from orderbook mid
-            let markPrice = "0";
-            try {
-                const ob = await this.getSpotOrderbook(symbol);
-                if (ob.bids.length > 0 && ob.asks.length > 0) {
-                    markPrice = String((Number(ob.bids[0][0]) + Number(ob.asks[0][0])) / 2);
-                }
-            }
-            catch { /* skip */ }
-            markets.push({
+            const markPrice = obResults[i].status === "fulfilled" ? obResults[i].value : "0";
+            return {
                 symbol, baseToken: base, quoteToken: quote,
                 markPrice, volume24h: "0",
                 sizeDecimals: dec.size, priceDecimals: dec.price,
-            });
-        }
-        return markets;
+            };
+        });
     }
     async getSpotOrderbook(symbol) {
         await this.init();

package/dist/exchanges/lighter.js

@@ -73,12 +73,28 @@ export class LighterAdapter {
             await this._refreshMarketMap();
             return;
         }
-        const res = await fetch(`${this._baseUrl}/api/v1/account?by=l1_address&value=${this._address}`);
-        const json = await res.json();
-        if (json.accounts && json.accounts.length > 0) {
-            this._accountIndex = this._accountIndexInit >= 0
-                ? this._accountIndexInit
-                : json.accounts[0].account_index;
+        // Retry account lookup on 429 (rate limit) — critical for _accountIndex
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                const res = await fetch(`${this._baseUrl}/api/v1/account?by=l1_address&value=${this._address}`);
+                if (res.status === 429 && attempt < 2) {
+                    await new Promise(r => setTimeout(r, 1000 * (attempt + 1)));
+                    continue;
+                }
+                const json = await res.json();
+                if (json.accounts && json.accounts.length > 0) {
+                    this._accountIndex = this._accountIndexInit >= 0
+                        ? this._accountIndexInit
+                        : json.accounts[0].account_index;
+                }
+                break;
+            }
+            catch {
+                if (attempt < 2) {
+                    await new Promise(r => setTimeout(r, 1000));
+                    continue;
+                }
+            }
         }
         // Auto-generate API key if we have PK but no API key and account exists
         let signerReady = false;
@@ -286,6 +302,8 @@ export class LighterAdapter {
         }
     }
     async getBalance() {
+        if (!this._address)
+            throw new Error("No private key configured — account data unavailable. Run: perp init");
         const acct = await this.fetchAccount();
         if (!acct)
             return { equity: "0", available: "0", marginUsed: "0", unrealizedPnl: "0" };
@@ -301,6 +319,8 @@ export class LighterAdapter {
         };
     }
     async getPositions() {
+        if (!this._address)
+            throw new Error("No private key configured — account data unavailable. Run: perp init");
         const acct = await this.fetchAccount();
         if (!acct)
             return [];
@@ -336,6 +356,8 @@ export class LighterAdapter {
         return this.restGet(path, params);
     }
     async getOpenOrders() {
+        if (!this._address)
+            throw new Error("No private key configured — account data unavailable. Run: perp init");
         if (this._accountIndex < 0 || this._readOnly)
             return [];
         try {
@@ -344,13 +366,26 @@ export class LighterAdapter {
             const totalOrders = Number(acct?.total_order_count ?? 0);
             if (totalOrders === 0)
                 return [];
-            // Query each market in parallel (accountActiveOrders requires auth + market_id)
+            // Only query markets that have open orders (avoids 156-market fan-out)
+            const activeMarketIds = new Set();
+            for (const p of acct?.positions ?? []) {
+                if (Number(p.open_order_count ?? 0) > 0 || Number(p.pending_order_count ?? 0) > 0) {
+                    activeMarketIds.add(Number(p.market_id));
+                }
+            }
+            if (activeMarketIds.size === 0)
+                return [];
+            const reverseMap = new Map();
+            for (const [sym, id] of this._marketMap)
+                reverseMap.set(id, sym);
             const allOrders = [];
-            const entries = Array.from(this._marketMap.entries());
-            const results = await Promise.allSettled(entries.map(([sym, marketId]) => this.restGetAuth("/accountActiveOrders", {
-                account_index: String(this._accountIndex),
-                market_id: String(marketId),
-            }).then(res => ({ sym, orders: (res.orders ?? []) }))));
+            const results = await Promise.allSettled(Array.from(activeMarketIds).map((marketId) => {
+                const sym = reverseMap.get(marketId) ?? `Market-${marketId}`;
+                return this.restGetAuth("/accountActiveOrders", {
+                    account_index: String(this._accountIndex),
+                    market_id: String(marketId),
+                }).then(res => ({ sym, orders: (res.orders ?? []) }));
+            }));
             for (const r of results) {
                 if (r.status !== "fulfilled" || !r.value.orders.length)
                     continue;
@@ -575,6 +610,8 @@ export class LighterAdapter {
         }));
     }
     async getOrderHistory(limit = 30) {
+        if (!this._address)
+            throw new Error("No private key configured — account data unavailable. Run: perp init");
         const raw = await this._getOrderHistoryRaw();
         const orders = (raw.orders ?? []);
         return orders.slice(0, limit).map((o) => ({
@@ -589,6 +626,8 @@ export class LighterAdapter {
         }));
     }
     async getTradeHistory(limit = 30) {
+        if (!this._address)
+            throw new Error("No private key configured — account data unavailable. Run: perp init");
         const raw = await this._getTradeHistoryRaw(limit);
         const trades = (raw.trades ?? []);
         return trades.slice(0, limit).map((t) => ({
@@ -601,6 +640,8 @@ export class LighterAdapter {
         }));
     }
     async getFundingPayments(limit = 30) {
+        if (!this._address)
+            throw new Error("No private key configured — account data unavailable. Run: perp init");
         const raw = await this._getPositionFundingRaw();
         const items = (raw.funding ?? []);
         return items.slice(0, limit).map((f) => ({
@@ -704,15 +745,35 @@ export class LighterAdapter {
             return { funding: [] };
         if (this._marketMap.size === 0)
             await this._refreshMarketMap();
+        // Only query markets where the account has/had positions (avoids 156-market fan-out)
+        const acct = await this.fetchAccount();
+        const activeMarketIds = new Set();
+        if (acct) {
+            for (const p of acct.positions ?? []) {
+                const pos = Number(p.position || 0);
+                const rpnl = Number(p.realized_pnl || 0);
+                if (pos !== 0 || rpnl !== 0) {
+                    activeMarketIds.add(Number(p.market_id));
+                }
+            }
+        }
+        if (activeMarketIds.size === 0)
+            return { funding: [] };
+        // Resolve market_id → symbol from marketMap
+        const reverseMap = new Map();
+        for (const [sym, id] of this._marketMap)
+            reverseMap.set(id, sym);
         const allFunding = [];
-        const entries = Array.from(this._marketMap.entries());
-        const results = await Promise.allSettled(entries.map(([sym, marketId]) => this.restGetAuth("/positionFunding", {
-            account_index: String(this._accountIndex),
-            market_id: String(marketId),
-        }).then((res) => {
-            const items = (res.funding ?? res.data ?? []);
-            return items.map((f) => ({ ...f, symbol: f.symbol ?? sym }));
-        })));
+        const results = await Promise.allSettled(Array.from(activeMarketIds).map((marketId) => {
+            const sym = reverseMap.get(marketId) ?? `Market-${marketId}`;
+            return this.restGetAuth("/positionFunding", {
+                account_index: String(this._accountIndex),
+                market_id: String(marketId),
+            }).then((res) => {
+                const items = (res.funding ?? res.data ?? []);
+                return items.map((f) => ({ ...f, symbol: f.symbol ?? sym }));
+            });
+        }));
         for (const r of results) {
             if (r.status === "fulfilled")
                 allFunding.push(...r.value);
@@ -872,7 +933,7 @@ export class LighterAdapter {
         return res.json();
     }
     ensureSigner() {
-        if (this._readOnly) {
+        if (this._readOnly || this._accountIndex < 0 || !this._signer) {
             throw new Error("This command requires a Lighter API key. Run `perp -e lighter manage setup-api-key` first, " +
                 "then set LIGHTER_API_KEY in your .env");
         }

package/dist/exchanges/pacifica.js

@@ -77,6 +77,8 @@ export class PacificaAdapter {
         };
     }
     async getBalance() {
+        if (!this._hasRealKey)
+            throw new Error("No private key configured — account data unavailable. Run: perp init");
         const [info, positions] = await Promise.all([
             this.client.getAccount(this.account),
             this._getPositions(),
@@ -92,6 +94,8 @@ export class PacificaAdapter {
         };
     }
     async getPositions() {
+        if (!this._hasRealKey)
+            throw new Error("No private key configured — account data unavailable. Run: perp init");
         const [positions, prices] = await Promise.all([
             this._getPositions(),
             this._getPrices(),
@@ -123,6 +127,8 @@ export class PacificaAdapter {
         });
     }
     async getOpenOrders() {
+        if (!this._hasRealKey)
+            throw new Error("No private key configured — account data unavailable. Run: perp init");
         const orders = await this.client.getOrders(this.account);
         return orders.map((o) => {
             const raw = o;
@@ -220,6 +226,8 @@ export class PacificaAdapter {
         }));
     }
     async getOrderHistory(limit = 30) {
+        if (!this._hasRealKey)
+            throw new Error("No private key configured — account data unavailable. Run: perp init");
         const result = await this.client.getOrderHistory(this.account);
         const data = (result.data ?? result.orders ?? []);
         if (!Array.isArray(data))
@@ -236,6 +244,8 @@ export class PacificaAdapter {
         }));
     }
     async getTradeHistory(limit = 30) {
+        if (!this._hasRealKey)
+            throw new Error("No private key configured — account data unavailable. Run: perp init");
         const raw = await this.client.getTradeHistory(this.account);
         const trades = (raw.data ?? raw);
         if (!Array.isArray(trades))
@@ -250,6 +260,8 @@ export class PacificaAdapter {
         }));
     }
     async getFundingPayments(limit = 30) {
+        if (!this._hasRealKey)
+            throw new Error("No private key configured — account data unavailable. Run: perp init");
         const raw = await this.client.getFundingAccountHistory(this.account);
         const history = (raw.data ?? raw);
         if (!Array.isArray(history))

package/dist/execution-log.d.ts

@@ -1,7 +1,7 @@
 export interface ExecutionRecord {
     id: string;
     timestamp: string;
-    type: "market_order" | "limit_order" | "cancel" | "stop_order" | "edit_order" | "rebalance" | "arb_entry" | "arb_close" | "bridge" | "multi_leg" | "multi_leg_rollback";
+    type: "market_order" | "limit_order" | "cancel" | "stop_order" | "edit_order" | "rebalance" | "arb_entry" | "arb_close" | "bridge" | "multi_leg" | "multi_leg_rollback" | "split_order";
     exchange: string;
     symbol: string;
     side: string;

package/dist/index.js

@@ -15,34 +15,27 @@ 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 { registerPnlCommands } from "./commands/pnl.js";
-import { registerMultilegCommands } from "./commands/multileg.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);
@@ -62,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) => {
@@ -96,14 +90,16 @@ function getExchange() {
     return resolveExchangeAlias(program.opts().exchange);
 }
 async function getAdapter() {
-    if (_adapter)
-        return _adapter;
     const opts = program.opts();
+    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);
+    const pk = await tryLoadPrivateKey(exchange, opts.privateKey, walletName);
     switch (exchange) {
         case "pacifica": {
             const keypair = pk ? parseSolanaKeypair(pk) : Keypair.generate();
@@ -193,22 +189,23 @@ 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(rawExchange) {
     const exchange = resolveExchangeAlias(rawExchange);
     const opts = program.opts();
     const network = opts.network;
     const isTestnet = network === "testnet";
-    const pk = await tryLoadPrivateKey(exchange, opts.privateKey);
+    const walletName = opts.wallet;
+    const pk = await tryLoadPrivateKey(exchange, opts.privateKey, walletName);
     switch (exchange) {
         case "pacifica": {
             if (_pacificaAdapter)
@@ -287,7 +284,8 @@ async function getHLAdapterForDex(dex) {
     if (_dexAdapters.has(dex))
         return _dexAdapters.get(dex);
     const opts = program.opts();
-    const pk = await tryLoadPrivateKey("hyperliquid", opts.privateKey);
+    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);
@@ -297,125 +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);
-registerPnlCommands(program, getAdapterForExchange, isJson);
-registerMultilegCommands(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, getAdapterForExchange);
+// 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 {
-        // Use allSettled to handle unfunded/404 accounts gracefully
-        const [balanceResult, positionsResult, ordersResult] = await Promise.allSettled([
-            adapter.getBalance(),
-            adapter.getPositions(),
-            adapter.getOpenOrders(),
-        ]);
-        const balance = balanceResult.status === "fulfilled" ? balanceResult.value : { equity: "0", available: "0", marginUsed: "0", unrealizedPnl: "0" };
-        const positions = positionsResult.status === "fulfilled" ? positionsResult.value : [];
-        const orders = ordersResult.status === "fulfilled" ? ordersResult.value : [];
-        // Collect errors for reporting
-        const errors = [];
-        if (balanceResult.status === "rejected")
-            errors.push(`balance: ${balanceResult.reason instanceof Error ? balanceResult.reason.message : String(balanceResult.reason)}`);
-        if (positionsResult.status === "rejected")
-            errors.push(`positions: ${positionsResult.reason instanceof Error ? positionsResult.reason.message : String(positionsResult.reason)}`);
-        if (ordersResult.status === "rejected")
-            errors.push(`orders: ${ordersResult.reason instanceof Error ? ordersResult.reason.message : String(ordersResult.reason)}`);
-        // Detect unfunded account (all calls failed, likely 404)
-        const allFailed = errors.length === 3;
-        const isUnfunded = allFailed && errors.some(e => e.includes("404") || e.includes("not found") || e.includes("does not exist"));
-        if (json) {
-            const { jsonOk, printJson } = await import("./utils.js");
-            return printJson(jsonOk({
-                exchange: adapter.name,
-                balance,
-                positions,
-                orders,
-                ...(isUnfunded ? { warning: "Account not yet initialized on this exchange. Deposit funds to get started." } : {}),
-                ...(errors.length > 0 && !isUnfunded ? { errors } : {}),
-            }));
-        }
-        console.log(chalk.cyan.bold(`\n  ${adapter.name.toUpperCase()} Account Status\n`));
-        if (isUnfunded) {
-            console.log(chalk.yellow("  Account not yet initialized on this exchange."));
-            console.log(chalk.gray("  Deposit funds to get started: perp deposit <exchange> <amount>\n"));
-        }
-        else {
-            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}`);
-                });
-            }
-            if (errors.length > 0) {
-                console.log(chalk.yellow(`\n  Warnings: ${errors.join(", ")}`));
-            }
-        }
-        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;