perp-cli 0.14.0 → 0.14.2

package/dist/commands/history.js

@@ -359,26 +359,39 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
             const limit = parseInt(opts.limit);
             const allTrades = [];
             const allFunding = [];
+            // A venue whose adapter / trades / funding read failed is listed here and left out of the
+            // totals (partial: true) — never counted as 0.
+            const errors = {};
+            const errText = (e) => (e instanceof Error ? e.message : String(e));
             // Fetch trades + funding in parallel from all exchanges
             await Promise.allSettled(exchanges.map(async (ex) => {
+                let adapter;
                 try {
-                    const adapter = await getAdapterForExchange(ex);
-                    const [trades, funding] = await Promise.all([
-                        adapter.getTradeHistory(limit),
-                        adapter.getFundingPayments(limit),
-                    ]);
-                    for (const t of trades) {
+                    adapter = await getAdapterForExchange(ex);
+                }
+                catch (e) {
+                    errors[`${ex}.adapter`] = errText(e);
+                    return;
+                }
+                const [trades, funding] = await Promise.allSettled([adapter.getTradeHistory(limit), adapter.getFundingPayments(limit)]);
+                if (trades.status === "fulfilled") {
+                    for (const t of trades.value) {
                         if (sinceMs && t.time < sinceMs)
                             continue;
                         allTrades.push({ exchange: ex, symbol: t.symbol, side: t.side, price: Number(t.price), size: Number(t.size), fee: Number(t.fee), time: t.time });
                     }
-                    for (const f of funding) {
+                }
+                else
+                    errors[`${ex}.trades`] = errText(trades.reason);
+                if (funding.status === "fulfilled") {
+                    for (const f of funding.value) {
                         if (sinceMs && f.time < sinceMs)
                             continue;
                         allFunding.push({ exchange: ex, symbol: f.symbol, payment: Number(f.payment), time: f.time });
                     }
                 }
-                catch { /* skip unavailable exchanges */ }
+                else
+                    errors[`${ex}.funding`] = errText(funding.reason);
             }));
             // Aggregate by exchange
             const byExchange = new Map();
@@ -428,6 +441,8 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
                 netPnl,
                 byExchange: Object.fromEntries([...byExchange.entries()].map(([ex, d]) => [ex, { ...d, netPnl: d.funding - d.fees }])),
                 daily,
+                errors,
+                partial: Object.keys(errors).length > 0,
             };
             if (isJson())
                 return printJson(jsonOk(result));
@@ -438,6 +453,8 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
             console.log(`  Trading Fees:    ${chalk.red(`-$${formatUsd(totalFees)}`)}`);
             console.log(`  Funding Income:  ${formatPnl(totalFunding)}`);
             console.log(`  Net P&L:         ${formatPnl(netPnl)}`);
+            for (const [k, msg] of Object.entries(errors))
+                console.log(chalk.yellow(`  ⚠ ${k} unavailable (left out of the totals): ${msg}`));
             if (byExchange.size > 0) {
                 console.log(chalk.white.bold("\n  By Exchange:"));
                 const rows = [...byExchange.entries()].map(([ex, d]) => [
@@ -480,27 +497,44 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
             const allFunding = [];
             // Fetch funding payments and current positions in parallel
             const positionNotionals = new Map();
+            // A venue whose adapter / funding / positions read failed is listed here; its funding is
+            // left out of the totals (partial: true) — never counted as 0.
+            const errors = {};
+            const errText = (e) => (e instanceof Error ? e.message : String(e));
             await Promise.allSettled(exchanges.map(async (ex) => {
+                let adapter;
                 try {
-                    const adapter = await getAdapterForExchange(ex);
-                    const [payments, positions] = await Promise.all([
-                        adapter.getFundingPayments(parseInt(opts.limit)),
-                        adapter.getPositions(),
-                    ]);
-                    for (const p of payments) {
+                    adapter = await getAdapterForExchange(ex);
+                }
+                catch (e) {
+                    errors[`${ex}.adapter`] = errText(e);
+                    return;
+                }
+                const [payments, positions] = await Promise.allSettled([
+                    adapter.getFundingPayments(parseInt(opts.limit)),
+                    adapter.getPositions(),
+                ]);
+                if (payments.status === "fulfilled") {
+                    for (const p of payments.value) {
                         if (sinceMs && p.time < sinceMs)
                             continue;
                         if (opts.symbol && !p.symbol.toUpperCase().includes(opts.symbol.toUpperCase()))
                             continue;
                         allFunding.push({ exchange: ex, symbol: p.symbol, payment: Number(p.payment), time: p.time });
                     }
-                    for (const p of positions) {
+                }
+                else
+                    errors[`${ex}.funding`] = errText(payments.reason);
+                // Positions only feed the annualized rate (null when the notional is unknown).
+                if (positions.status === "fulfilled") {
+                    for (const p of positions.value) {
                         if (Number(p.size) > 0) {
                             positionNotionals.set(`${ex}:${p.symbol}`, Math.abs(Number(p.size) * Number(p.markPrice)));
                         }
                     }
                 }
-                catch { /* skip unavailable exchanges */ }
+                else
+                    errors[`${ex}.positions`] = errText(positions.reason);
             }));
             allFunding.sort((a, b) => a.time - b.time);
             // Aggregate by exchange×symbol
@@ -556,16 +590,19 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
             const arbRows = arbPositions
                 .map(pos => {
                 const af = arbFunding.get(pos.symbol);
-                if (!af || (af.longFunding === 0 && af.shortFunding === 0))
+                // A leg on a venue whose funding read failed is unknown (null), not 0.
+                const longFunding = af && !(`${pos.longExchange}.adapter` in errors || `${pos.longExchange}.funding` in errors) ? af.longFunding : null;
+                const shortFunding = af && !(`${pos.shortExchange}.adapter` in errors || `${pos.shortExchange}.funding` in errors) ? af.shortFunding : null;
+                if (!af || (longFunding === 0 && shortFunding === 0))
                     return null;
                 return {
                     symbol: pos.symbol,
                     mode: pos.mode ?? "perp-perp",
                     longExchange: pos.longExchange,
                     shortExchange: pos.shortExchange,
-                    netFunding: af.longFunding + af.shortFunding,
-                    longFunding: af.longFunding,
-                    shortFunding: af.shortFunding,
+                    netFunding: longFunding !== null && shortFunding !== null ? longFunding + shortFunding : null,
+                    longFunding,
+                    shortFunding,
                     daysSinceEntry: Math.max(1, Math.round((Date.now() - new Date(pos.entryTime).getTime()) / 86400000)),
                 };
             })
@@ -580,6 +617,8 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
                 byExchange: Object.fromEntries(byExchange),
                 arbPositions: arbRows,
                 ...(opts.daily ? { daily } : {}),
+                errors,
+                partial: Object.keys(errors).length > 0,
             };
             if (isJson())
                 return printJson(jsonOk(result));
@@ -588,6 +627,8 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
             console.log(`  Total Payments:  ${allFunding.length}`);
             console.log(`  Net Funding:     ${formatPnl(totalFunding)}`);
             console.log(`  Period:          ~${Math.round(periodDays)} days`);
+            for (const [k, msg] of Object.entries(errors))
+                console.log(chalk.yellow(`  ⚠ ${k} unavailable (left out of the totals): ${msg}`));
             if (exSymRows.length > 0) {
                 console.log(chalk.white.bold("\n  By Exchange × Symbol:"));
                 const rows = exSymRows.map(e => [
@@ -605,7 +646,7 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
                     chalk.white.bold(a.symbol),
                     `${a.longExchange} → ${a.shortExchange}`,
                     a.mode,
-                    formatPnl(a.netFunding),
+                    a.netFunding !== null ? formatPnl(a.netFunding) : chalk.yellow("unavailable"),
                     `${a.daysSinceEntry}d`,
                 ]);
                 console.log(makeTable(["Symbol", "Long → Short", "Mode", "Net Funding", "Held"], rows));
@@ -647,24 +688,44 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
             let totalEquity = 0;
             let totalUPnl = 0;
             const symbolSet = new Set();
+            // A venue whose read failed is reported here and left out of the totals — never counted as 0.
+            const errors = {};
+            const errText = (e) => (e instanceof Error ? e.message : String(e));
+            let venuesRead = 0;
             await Promise.allSettled(exchanges.map(async (ex) => {
+                let adapter;
+                try {
+                    adapter = await getAdapterForExchange(ex);
+                }
+                catch (e) {
+                    errors[`${ex}.adapter`] = errText(e);
+                    return;
+                }
                 try {
-                    const adapter = await getAdapterForExchange(ex);
-                    const [balance, trades, funding] = await Promise.all([
-                        adapter.getBalance(),
-                        adapter.getTradeHistory(50).catch(() => []),
-                        adapter.getFundingPayments(50).catch(() => []),
-                    ]);
+                    const balance = await adapter.getBalance();
                     totalEquity += Number(balance.equity);
                     totalUPnl += Number(balance.unrealizedPnl);
-                    for (const t of trades) {
+                    venuesRead++;
+                }
+                catch (e) {
+                    errors[`${ex}.balance`] = errText(e);
+                    return;
+                }
+                const [trades, funding] = await Promise.allSettled([adapter.getTradeHistory(50), adapter.getFundingPayments(50)]);
+                if (trades.status === "fulfilled") {
+                    for (const t of trades.value) {
                         totalFees += Number(t.fee);
                         symbolSet.add(t.symbol);
                     }
-                    for (const f of funding)
+                }
+                else
+                    errors[`${ex}.trades`] = errText(trades.reason);
+                if (funding.status === "fulfilled") {
+                    for (const f of funding.value)
                         totalFunding += Number(f.payment);
                 }
-                catch { /* skip */ }
+                else
+                    errors[`${ex}.funding`] = errText(funding.reason);
             }));
             const report = {
                 period: opts.since ?? "all time",
@@ -691,6 +752,11 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
                         ? (stats.totalTrades / Math.max(1, (Date.now() - new Date(records[records.length - 1]?.timestamp ?? Date.now()).getTime()) / 86400000)).toFixed(1)
                         : "0",
                 },
+                errors,
+                // partial: some venue read failed — portfolio / costs cover only the venues that answered.
+                partial: Object.keys(errors).length > 0,
+                venuesRead,
+                venuesRequested: exchanges.length,
             };
             if (isJson())
                 return printJson(jsonOk(report));
@@ -707,6 +773,8 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
             console.log(`    Trading Fees:    ${chalk.red(`-$${formatUsd(totalFees)}`)}`);
             console.log(`    Funding Income:  ${formatPnl(totalFunding)}`);
             console.log(`    Net:             ${formatPnl(totalFunding - totalFees)}`);
+            for (const [k, msg] of Object.entries(errors))
+                console.log(chalk.yellow(`    ⚠ ${k} unavailable (left out of the totals): ${msg}`));
             console.log();
         });
     });
@@ -738,25 +806,49 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
             // Fetch funding + current positions from all relevant exchanges
             const fundingByExSym = new Map();
             const currentPrices = new Map();
+            // A venue whose adapter / funding / positions read failed is keyed here: rows touching it
+            // report null for the unknown part (funding / pricePnl), never 0 or the entry price.
+            const errors = {};
+            const errText = (e) => (e instanceof Error ? e.message : String(e));
+            const fundingFailed = new Set();
             await Promise.allSettled([...exchangeSet].map(async (ex) => {
+                let adapter;
                 try {
-                    const adapter = await getAdapterForExchange(ex);
-                    const [funding, livePositions] = await Promise.all([
-                        adapter.getFundingPayments(limit),
-                        adapter.getPositions(),
-                    ]);
-                    for (const f of funding) {
+                    adapter = await getAdapterForExchange(ex);
+                }
+                catch (e) {
+                    errors[`${ex}.adapter`] = errText(e);
+                    fundingFailed.add(ex);
+                    return;
+                }
+                const [funding, livePositions] = await Promise.allSettled([
+                    adapter.getFundingPayments(limit),
+                    adapter.getPositions(),
+                ]);
+                if (funding.status === "fulfilled") {
+                    for (const f of funding.value) {
                         if (sinceMs && f.time < sinceMs)
                             continue;
                         const key = `${ex}:${f.symbol}`;
                         fundingByExSym.set(key, (fundingByExSym.get(key) ?? 0) + Number(f.payment));
                     }
-                    for (const p of livePositions) {
+                }
+                else {
+                    errors[`${ex}.funding`] = errText(funding.reason);
+                    fundingFailed.add(ex);
+                }
+                if (livePositions.status === "fulfilled") {
+                    for (const p of livePositions.value) {
                         currentPrices.set(`${ex}:${p.symbol}`, Number(p.markPrice));
                     }
                 }
-                catch { /* skip */ }
+                else
+                    errors[`${ex}.positions`] = errText(livePositions.reason);
             }));
+            // Funding of a venue that answered: the sum of its payments (none = 0). A failed venue: unknown (null).
+            const fundingOf = (ex, sym) => fundingFailed.has(ex) ? null : fundingByExSym.get(`${ex}:${sym}`) ?? 0;
+            // Current mark from the live position; none (failed read / no live leg) = unknown (null), never the entry price.
+            const priceOf = (ex, sym) => currentPrices.get(`${ex}:${sym}`) ?? null;
             // Entries without a verified entry price (a bot leg the venue reported no fill price for)
             // have no price PnL: listed apart, never priced at a guess.
             const priced = positions.filter((p) => p.entryLongPrice !== null && p.entryShortPrice !== null);
@@ -764,21 +856,21 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
             // Build comparison data
             const rows = priced.map(pos => {
                 const daysHeld = Math.max(1, Math.round((Date.now() - new Date(pos.entryTime).getTime()) / 86400000));
-                const longFunding = fundingByExSym.get(`${pos.longExchange}:${pos.symbol}`) ?? 0;
-                const shortFunding = fundingByExSym.get(`${pos.shortExchange}:${pos.symbol}`) ?? 0;
-                const netFunding = longFunding + shortFunding;
-                // Estimate unrealized PnL from price movement
-                const longPrice = currentPrices.get(`${pos.longExchange}:${pos.symbol}`) ?? pos.entryLongPrice;
-                const shortPrice = currentPrices.get(`${pos.shortExchange}:${pos.symbol}`) ?? pos.entryShortPrice;
-                const longPnl = (longPrice - pos.entryLongPrice) * pos.longSize;
-                const shortPnl = (pos.entryShortPrice - shortPrice) * pos.shortSize;
-                const pricePnl = longPnl + shortPnl;
-                const totalPnl = pricePnl + netFunding;
+                const longFunding = fundingOf(pos.longExchange, pos.symbol);
+                const shortFunding = fundingOf(pos.shortExchange, pos.symbol);
+                const netFunding = longFunding !== null && shortFunding !== null ? longFunding + shortFunding : null;
+                // Estimate unrealized PnL from price movement (null when either leg's mark is unknown)
+                const longPrice = priceOf(pos.longExchange, pos.symbol);
+                const shortPrice = priceOf(pos.shortExchange, pos.symbol);
+                const pricePnl = longPrice !== null && shortPrice !== null
+                    ? (longPrice - pos.entryLongPrice) * pos.longSize + (pos.entryShortPrice - shortPrice) * pos.shortSize
+                    : null;
+                const totalPnl = pricePnl !== null && netFunding !== null ? pricePnl + netFunding : null;
                 // Notional for ROI calculation
                 const notional = pos.entryLongPrice * pos.longSize + pos.entryShortPrice * pos.shortSize;
-                const roi = notional > 0 ? (totalPnl / notional) * 100 : 0;
-                const fundingRoi = notional > 0 ? (netFunding / notional) * 100 : 0;
-                const annualizedRoi = daysHeld > 0 ? (fundingRoi / daysHeld) * 365 : 0;
+                const roi = totalPnl !== null ? (notional > 0 ? (totalPnl / notional) * 100 : 0) : null;
+                const fundingRoi = netFunding !== null ? (notional > 0 ? (netFunding / notional) * 100 : 0) : null;
+                const annualizedRoi = fundingRoi !== null ? (daysHeld > 0 ? (fundingRoi / daysHeld) * 365 : 0) : null;
                 return {
                     symbol: pos.symbol,
                     mode: pos.mode ?? "perp-perp",
@@ -795,14 +887,19 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
                     annualizedRoi,
                 };
             });
-            // Sort by total PnL descending
-            rows.sort((a, b) => b.totalPnl - a.totalPnl);
+            // Sort by total PnL descending (unknown totals last)
+            rows.sort((a, b) => (a.totalPnl === null ? 1 : b.totalPnl === null ? -1 : b.totalPnl - a.totalPnl));
+            // Totals skip the unknown (null) values; partial flags that they do not cover every row.
+            const sumKnown = (vals) => vals.reduce((s, v) => s + (v ?? 0), 0);
+            const complete = rows.filter(r => r.totalPnl !== null);
             const totals = {
-                funding: rows.reduce((s, r) => s + r.funding, 0),
-                pricePnl: rows.reduce((s, r) => s + r.pricePnl, 0),
-                totalPnl: rows.reduce((s, r) => s + r.totalPnl, 0),
-                notional: rows.reduce((s, r) => s + r.notional, 0),
+                funding: sumKnown(rows.map(r => r.funding)),
+                pricePnl: sumKnown(rows.map(r => r.pricePnl)),
+                totalPnl: sumKnown(complete.map(r => r.totalPnl)),
+                // ROI base: only the rows whose total PnL is known.
+                notional: complete.reduce((s, r) => s + r.notional, 0),
             };
+            const partial = Object.keys(errors).length > 0 || rows.some(r => r.funding === null || r.pricePnl === null);
             const result = {
                 period: opts.period ?? "all",
                 positionCount: rows.length,
@@ -812,6 +909,8 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
                     ...totals,
                     roi: totals.notional > 0 ? (totals.totalPnl / totals.notional) * 100 : 0,
                 },
+                errors,
+                partial,
             };
             if (isJson())
                 return printJson(jsonOk(result));
@@ -822,11 +921,11 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
                 `${r.longExchange} → ${r.shortExchange}`,
                 r.mode,
                 `${r.daysHeld}d`,
-                formatPnl(r.funding),
-                formatPnl(r.pricePnl),
-                formatPnl(r.totalPnl),
-                `${r.roi >= 0 ? "+" : ""}${r.roi.toFixed(2)}%`,
-                `${r.annualizedRoi >= 0 ? "+" : ""}${r.annualizedRoi.toFixed(1)}%`,
+                r.funding !== null ? formatPnl(r.funding) : chalk.yellow("unavailable"),
+                r.pricePnl !== null ? formatPnl(r.pricePnl) : chalk.yellow("unavailable"),
+                r.totalPnl !== null ? formatPnl(r.totalPnl) : chalk.yellow("unavailable"),
+                r.roi !== null ? `${r.roi >= 0 ? "+" : ""}${r.roi.toFixed(2)}%` : chalk.yellow("unavailable"),
+                r.annualizedRoi !== null ? `${r.annualizedRoi >= 0 ? "+" : ""}${r.annualizedRoi.toFixed(1)}%` : chalk.yellow("unavailable"),
             ]);
             console.log(makeTable(["Symbol", "Long → Short", "Mode", "Held", "Funding", "Price PnL", "Total PnL", "ROI", "Ann.ROI"], tableRows));
             if (unpricedPositions.length > 0)
@@ -838,6 +937,10 @@ function registerAnalyticsSubcommands(parent, getAdapterForExchange, isJson) {
             if (totals.notional > 0) {
                 console.log(`    Total ROI:        ${result.totals.roi >= 0 ? "+" : ""}${result.totals.roi.toFixed(2)}%`);
             }
+            if (partial)
+                console.log(chalk.yellow("    ⚠ Partial: totals leave out the unavailable values above"));
+            for (const [k, msg] of Object.entries(errors))
+                console.log(chalk.yellow(`    ⚠ ${k} unavailable: ${msg}`));
             console.log();
         });
     });

package/dist/commands/portfolio.d.ts

@@ -17,4 +17,9 @@
 import type { Command } from "commander";
 import type { ExchangeAdapter } from "../exchanges/index.js";
 import "../exchanges/venues/index.js";
+/**
+ * Open-position count on a HIP-3 dex; null = the read failed (unknown — NOT "no positions").
+ * The failure is warned on stderr; callers must treat null as "may hold positions".
+ */
+export declare function checkDexPositions(address: string, dex: string): Promise<number | null>;
 export declare function registerPortfolioCommand(program: Command, getAdapterForExchange: (exchange: string) => Promise<ExchangeAdapter>, isJson: () => boolean, version: string, getHLAdapterForDex?: (dex: string) => Promise<ExchangeAdapter>): void;

package/dist/commands/portfolio.js

@@ -176,7 +176,7 @@ async function fetchExchangeEntry(exName, getAdapter) {
             adapter.getBalance(),
             adapter.getPositions(),
             adapter.getOpenOrders(),
-            adapter.getFundingPayments(200).catch(() => []),
+            adapter.getFundingPayments(200).then((rows) => ({ rows, error: null }), (e) => ({ rows: null, error: e instanceof Error ? e.message : String(e) })),
         ]);
         // Spot balances for every venue with def.spot (§12). Failures are surfaced on
         // stderr (the perp snapshot is still reported); unpriced tokens are excluded + warned.
@@ -200,8 +200,11 @@ async function fetchExchangeEntry(exName, getAdapter) {
             warn(`${def.displayName} spot balances unavailable: ${e instanceof Error ? e.message : String(e)}`);
         }
         const cutoff24h = Date.now() - 24 * 60 * 60 * 1000;
-        const recent = fundingPayments.filter(f => f.time >= cutoff24h);
-        const funding24h = recent.reduce((sum, f) => sum + Number(f.payment), 0);
+        if (fundingPayments.error !== null)
+            warn(`${def.displayName} funding history unavailable (funding24h null): ${fundingPayments.error}`);
+        const funding24h = fundingPayments.rows === null
+            ? null
+            : fundingPayments.rows.filter(f => f.time >= cutoff24h).reduce((sum, f) => sum + Number(f.payment), 0);
         // Shared balances (Pacifica USDC, HL unified USDC) are already in perp equity (§12.4 #8).
         const nonUsdcSpotValue = spot.filter(b => !b.shared).reduce((s, b) => s + b.valueUsd, 0);
         return {
@@ -227,6 +230,7 @@ async function fetchExchangeEntry(exName, getAdapter) {
             })),
             openOrders: orders.length,
             funding24h,
+            fundingError: fundingPayments.error,
             totalAccountValueUsd: Number(bal.equity) + nonUsdcSpotValue,
             error: null,
         };
@@ -240,7 +244,9 @@ async function fetchExchangeEntry(exName, getAdapter) {
             spot: [],
             positions: [],
             openOrders: 0,
-            funding24h: 0,
+            funding24h: null,
+            // The whole venue was unreadable: funding is unknown for the same reason.
+            fundingError: err instanceof Error ? err.message : String(err),
             totalAccountValueUsd: 0,
             error: err instanceof Error ? err.message : String(err),
         };
@@ -251,13 +257,17 @@ function buildTotals(entries) {
     let spotValueUsd = 0;
     let marginUsed = 0;
     let funding24h = 0;
+    let fundingIncomplete = false;
     let accountValueUsd = 0;
     for (const e of entries) {
         if (e.perp) {
             equity += Number(e.perp.equity);
             marginUsed += Number(e.perp.marginUsed);
         }
-        funding24h += e.funding24h;
+        if (e.funding24h === null)
+            fundingIncomplete = true;
+        else
+            funding24h += e.funding24h;
         // Non-USDC spot value (for unified accounts USDC is already in equity)
         const exSpot = e.isUnified
             ? e.spot.filter(b => b.token.replace(/-SPOT$/i, "").toUpperCase() !== "USDC")
@@ -272,7 +282,7 @@ function buildTotals(entries) {
     const marginPct = denom > 0 ? (marginUsed / denom) * 100 : 0;
     const level = marginPct < 30 ? "LOW" : marginPct < 60 ? "MEDIUM" : "HIGH";
     return {
-        totals: { equity, spotValueUsd, accountValueUsd, marginUsed, marginPct, funding24h },
+        totals: { equity, spotValueUsd, accountValueUsd, marginUsed, marginPct, funding24h, fundingIncomplete },
         risk: { level, marginPct },
     };
 }
@@ -537,7 +547,11 @@ async function runWatch(resolved, version, getAdapterForExchange, isJsonMode) {
 }
 // ── Serve mode (delegates to dashboard infra) ──────────────────────────────
 const KNOWN_HIP3_DEXES = ["xyz", "flx", "hyna", "km", "cash", "vntl"];
-async function checkDexPositions(address, dex) {
+/**
+ * Open-position count on a HIP-3 dex; null = the read failed (unknown — NOT "no positions").
+ * The failure is warned on stderr; callers must treat null as "may hold positions".
+ */
+export async function checkDexPositions(address, dex) {
     try {
         // Selected network (review L7): follows -n via setSharedApiNetwork (live binding).
         const res = await fetch(HYPERLIQUID_API_URL, {
@@ -545,15 +559,22 @@ async function checkDexPositions(address, dex) {
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify({ type: "clearinghouseState", user: address, dex }),
         });
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
         const state = await res.json();
-        const positions = (state?.assetPositions ?? []);
-        return positions.filter(p => {
+        if (!state || !Array.isArray(state.assetPositions))
+            throw new Error("clearinghouseState without assetPositions");
+        return state.assetPositions.filter(p => {
             const pos = (p.position ?? p);
-            return Number(pos.szi ?? 0) !== 0;
+            const szi = Number(pos.szi);
+            if (!Number.isFinite(szi))
+                throw new Error(`position without a numeric szi (${String(pos.coin)})`);
+            return szi !== 0;
         }).length;
     }
-    catch {
-        return 0;
+    catch (e) {
+        process.stderr.write(`[warn] hl:${dex} positions unknown (HIP-3 dex read failed; included in the dashboard): ${e instanceof Error ? e.message : String(e)}\n`);
+        return null;
     }
 }
 async function autoDetectHip3Dexes(address, getHLAdapterForDex, verbose) {
@@ -561,16 +582,22 @@ async function autoDetectHip3Dexes(address, getHLAdapterForDex, verbose) {
         dex,
         count: await checkDexPositions(address, dex),
     })));
-    const activeDexes = checks.filter(c => c.count > 0);
+    // Unknown (null) counts are included: a failed read must not hide a dex that may hold positions.
+    const activeDexes = checks.filter(c => c.count === null || c.count > 0);
     const results = [];
     for (const { dex, count } of activeDexes) {
         try {
             const adapter = await getHLAdapterForDex(dex);
             results.push({ name: `hl:${dex}`, adapter });
-            if (verbose)
-                console.log(chalk.green(`  ✓ hl:${dex} (HIP-3, ${count} position${count > 1 ? "s" : ""})`));
+            if (verbose) {
+                console.log(count === null
+                    ? chalk.yellow(`  ⚠ hl:${dex} (HIP-3, positions unknown — read failed)`)
+                    : chalk.green(`  ✓ hl:${dex} (HIP-3, ${count} position${count > 1 ? "s" : ""})`));
+            }
+        }
+        catch (e) {
+            process.stderr.write(`[warn] hl:${dex} left out of the dashboard (adapter unavailable${count === null ? ", positions unknown" : `, ${count} position(s)`}): ${e instanceof Error ? e.message : String(e)}\n`);
         }
-        catch { /* skip */ }
     }
     return results;
 }
@@ -578,12 +605,20 @@ async function runServe(resolved, getAdapterForExchange, isJsonMode, getHLAdapte
     const { startDashboard } = await import("../dashboard/index.js");
     if (isJsonMode) {
         const exchanges = [];
+        // A venue whose adapter failed is not monitored — reported in serve.errors + stderr, not dropped silently.
+        const errors = {};
+        const noteError = (name, e) => {
+            errors[name] = e instanceof Error ? e.message : String(e);
+            process.stderr.write(`[warn] ${name} not monitored (adapter unavailable): ${errors[name]}\n`);
+        };
         for (const name of resolved.exchangeList) {
             try {
                 const adapter = await getAdapterForExchange(name);
                 exchanges.push({ name, adapter });
             }
-            catch { /* skip */ }
+            catch (e) {
+                noteError(name, e);
+            }
         }
         if (getHLAdapterForDex) {
             for (const dex of resolved.dexList) {
@@ -591,7 +626,9 @@ async function runServe(resolved, getAdapterForExchange, isJsonMode, getHLAdapte
                     const adapter = await getHLAdapterForDex(dex);
                     exchanges.push({ name: `hl:${dex}`, adapter });
                 }
-                catch { /* skip */ }
+                catch (e) {
+                    noteError(`hl:${dex}`, e);
+                }
             }
             if (resolved.autoDex && !resolved.dexList.length && resolved.exchangeList.includes("hyperliquid")) {
                 const hlEx = exchanges.find(e => e.name === "hyperliquid");
@@ -612,12 +649,13 @@ async function runServe(resolved, getAdapterForExchange, isJsonMode, getHLAdapte
             scope: resolved.scope,
             mode: "serve",
             exchanges: [],
-            totals: { equity: 0, spotValueUsd: 0, accountValueUsd: 0, marginUsed: 0, marginPct: 0, funding24h: 0 },
+            totals: { equity: 0, spotValueUsd: 0, accountValueUsd: 0, marginUsed: 0, marginPct: 0, funding24h: 0, fundingIncomplete: false },
             risk: { level: "LOW", marginPct: 0 },
             serve: {
                 url: `http://localhost:${dashboard.port}`,
                 port: dashboard.port,
                 exchanges: exchanges.map(e => e.name),
+                errors,
             },
         };
         printJson(jsonOk(data));
@@ -757,7 +795,7 @@ export function registerPortfolioCommand(program, getAdapterForExchange, isJson,
                     scope: resolved.scope,
                     mode: "health",
                     exchanges: [],
-                    totals: { equity: 0, spotValueUsd: 0, accountValueUsd: 0, marginUsed: 0, marginPct: 0, funding24h: 0 },
+                    totals: { equity: 0, spotValueUsd: 0, accountValueUsd: 0, marginUsed: 0, marginPct: 0, funding24h: 0, fundingIncomplete: false },
                     risk: { level: "LOW", marginPct: 0 },
                     health,
                 };