perp-cli 0.7.12 → 0.7.15

package/dist/bot/engine.js

@@ -152,22 +152,6 @@ mode = "headless") {
             try {
                 // Get market data (enriched for strategy use)
                 const snapshot = await getEnrichedSnapshot(adapter, config.symbol);
-                // Update equity
-                try {
-                    const bal = await adapter.getBalance();
-                    state.equity = parseFloat(bal.equity);
-                    if (state.equity > state.peakEquity)
-                        state.peakEquity = state.equity;
-                    // Reset daily baseline at day boundary
-                    const today = new Date().toISOString().slice(0, 10);
-                    if (today !== state.dailyStartDate) {
-                        state.dailyStartEquity = state.equity;
-                        state.dailyStartDate = today;
-                    }
-                    state.dailyPnl = state.equity - state.dailyStartEquity;
-                    state.totalPnl = state.equity - state.initialEquity;
-                }
-                catch { /* non-critical */ }
                 const context = {
                     equity: state.equity,
                     startTime: state.startTime,
@@ -258,18 +242,41 @@ mode = "headless") {
                         effectiveLog(`  Exit condition met, returning to monitoring...`);
                     }
                 }
-                // ── Emit state update for TUI / JSON ──
+                // ── Fetch balances + emit state update for TUI / JSON ──
                 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),
+                    fetchExchangeBalances(adapter, extraAdapters),
                 ]);
-                const tuiState = buildTuiState(state, config, snapshot, positions, openOrders, strategyCtx, exchangeBalances);
-                if (mode === "tui") {
-                    tuiEmitter.emitState(tuiState);
+                // Update equity using the already-fetched balance (avoids a redundant getBalance() call)
+                try {
+                    const primaryBal = exchangeBalances.find(b => b.exchange === adapter.name);
+                    if (primaryBal) {
+                        state.equity = parseFloat(primaryBal.equity);
+                        if (state.equity > state.peakEquity)
+                            state.peakEquity = state.equity;
+                        // Reset daily baseline at day boundary
+                        const today = new Date().toISOString().slice(0, 10);
+                        if (today !== state.dailyStartDate) {
+                            state.dailyStartEquity = state.equity;
+                            state.dailyStartDate = today;
+                        }
+                        state.dailyPnl = state.equity - state.dailyStartEquity;
+                        state.totalPnl = state.equity - state.initialEquity;
+                    }
+                }
+                catch { /* non-critical */ }
+                if (mode === "tui" || mode === "json") {
+                    const tuiState = buildTuiState(state, config, snapshot, positions, openOrders, strategyCtx, exchangeBalances);
+                    if (mode === "tui") {
+                        tuiEmitter.emitState(tuiState);
+                    }
+                    else {
+                        console.log(JSON.stringify(tuiState));
+                    }
                 }
-                else if (mode === "json") {
-                    console.log(JSON.stringify(tuiState));
+                else {
+                    effectiveLog(`  tick: phase=${state.phase} equity=$${state.equity.toFixed(2)}`);
                 }
                 // Update job state
                 if (jobId) {
@@ -447,6 +454,60 @@ async function fetchExchangeBalances(primaryAdapter, extraAdapters) {
     }));
     return results;
 }
+async function fetchSpotPositions(adapter) {
+    const name = adapter.name.toLowerCase();
+    if (name !== "hyperliquid" && name !== "lighter")
+        return [];
+    try {
+        if (name === "hyperliquid") {
+            const { HyperliquidSpotAdapter } = await import("../exchanges/hyperliquid-spot.js");
+            const { HyperliquidAdapter } = await import("../exchanges/hyperliquid.js");
+            if (!(adapter instanceof HyperliquidAdapter))
+                return [];
+            const hlSpot = new HyperliquidSpotAdapter(adapter);
+            await hlSpot.init();
+            const [raw, markets] = await Promise.all([hlSpot.getSpotBalances(), hlSpot.getSpotMarkets()]);
+            const priceMap = new Map(markets.map(m => [m.baseToken.toUpperCase(), m.markPrice]));
+            const strip = (t) => t.replace(/-SPOT$/i, "").toUpperCase();
+            const hlPositions = [];
+            for (const b of raw) {
+                if (Number(b.total) <= 0)
+                    continue;
+                const base = strip(b.token);
+                const markPrice = priceMap.get(base) ?? "0";
+                if (base === "USDC" || markPrice === "0")
+                    continue;
+                hlPositions.push({ symbol: base, side: "spot", size: b.total, entryPrice: "—", markPrice, unrealizedPnl: "—", exchange: adapter.name });
+            }
+            return hlPositions;
+        }
+        if (name === "lighter") {
+            const { LighterAdapter } = await import("../exchanges/lighter.js");
+            const { LighterSpotAdapter } = await import("../exchanges/lighter-spot.js");
+            if (!(adapter instanceof LighterAdapter))
+                return [];
+            const ltSpot = new LighterSpotAdapter(adapter);
+            await ltSpot.init();
+            const [raw, markets] = await Promise.all([ltSpot.getSpotBalances(), ltSpot.getSpotMarkets()]);
+            const priceMap = new Map(markets.map(m => [m.baseToken.toUpperCase(), m.markPrice]));
+            const ltPositions = [];
+            for (const b of raw) {
+                if (Number(b.total) <= 0)
+                    continue;
+                const base = b.token.toUpperCase();
+                const markPrice = priceMap.get(base) ?? "0";
+                if (base === "USDC" || base === "USDC_SPOT" || markPrice === "0")
+                    continue;
+                ltPositions.push({ symbol: base, side: "spot", size: b.total, entryPrice: "—", markPrice, unrealizedPnl: "—", exchange: adapter.name });
+            }
+            return ltPositions;
+        }
+    }
+    catch {
+        // Spot adapter unavailable — skip silently
+    }
+    return [];
+}
 async function fetchAllPositions(primaryAdapter, symbol, extraAdapters) {
     const adapters = [[primaryAdapter.name, primaryAdapter]];
     if (extraAdapters) {
@@ -455,8 +516,11 @@ async function fetchAllPositions(primaryAdapter, symbol, extraAdapters) {
     }
     const all = [];
     await Promise.all(adapters.map(async ([name, a]) => {
-        const pos = await fetchPositions(a, symbol, name);
-        all.push(pos);
+        const [perpPos, spotPos] = await Promise.all([
+            fetchPositions(a, symbol, name),
+            fetchSpotPositions(a),
+        ]);
+        all.push([...perpPos, ...spotPos]);
     }));
     return all.flat();
 }

package/dist/bot/strategies/funding-arb-strategy.js

@@ -26,6 +26,9 @@ export class FundingArbStrategy {
         ctx.state.set("arbRunning", true);
         ctx.state.set("arbOpenPositions", []);
         ctx.state.set("arbPositions", 0);
+        ctx.state.set("fundingIncome", 0);
+        ctx.state.set("fundingLastCheck", Date.now());
+        ctx.state.set("fundingHistory", []);
         ctx.log(`  [ARB] Funding arb ready | spread >= ${params.min_spread}% | close < ${params.close_spread}% | size $${params.size_usd}`);
         ctx.log(`  [ARB] Exchanges: ${params.exchanges.join(", ")}`);
     }
@@ -54,6 +57,41 @@ export class FundingArbStrategy {
                 map.set(r.symbol.toUpperCase(), { rate: r.rate, price: r.price });
             ratesByExchange.set(name, map);
         }
+        // ── Fetch funding income periodically (every 5 minutes) ──
+        const lastCheck = ctx.state.get("fundingLastCheck");
+        if (openPositions.length > 0 && Date.now() - lastCheck > 5 * 60 * 1000) {
+            try {
+                let totalFunding = 0;
+                for (const [name, a] of adapters) {
+                    try {
+                        const payments = await a.getFundingPayments(50);
+                        const startTime = ctx.state.get("fundingLastCheck");
+                        const recent = payments.filter(p => p.timestamp > startTime - 5 * 60 * 1000);
+                        const sum = recent.reduce((s, p) => s + parseFloat(p.amount), 0);
+                        totalFunding += sum;
+                        if (Math.abs(sum) > 0.001) {
+                            ctx.log(`  [FUND] ${name}: $${sum.toFixed(4)} funding received`);
+                        }
+                    }
+                    catch { /* not all adapters support this */ }
+                }
+                const prev = ctx.state.get("fundingIncome");
+                ctx.state.set("fundingIncome", prev + totalFunding);
+                ctx.state.set("fundingLastCheck", Date.now());
+            }
+            catch { /* non-critical */ }
+        }
+        // ── Update strategy state for TUI display ──
+        const arbPosForDisplay = openPositions.map(p => {
+            const longRate = ratesByExchange.get(p.longExchange)?.get(p.symbol)?.rate;
+            const shortRate = ratesByExchange.get(p.shortExchange)?.get(p.symbol)?.rate;
+            const spread = (longRate !== undefined && shortRate !== undefined)
+                ? computeAnnualSpread(shortRate, p.shortExchange, longRate, p.longExchange)
+                : 0;
+            return `${p.symbol} ${p.longExchange}↔${p.shortExchange} ${spread.toFixed(1)}%`;
+        });
+        ctx.state.set("arbPositionDetails", arbPosForDisplay);
+        ctx.state.set("fundingTotal", `$${ctx.state.get("fundingIncome").toFixed(4)}`);
         // ── Check existing positions for close_spread ──
         const toClose = [];
         for (const pos of openPositions) {

package/dist/bot/tui/BotDashboard.js

@@ -1,4 +1,4 @@
-import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import { useState, useEffect, useCallback } from "react";
 import { Box, Text, useApp, useInput } from "ink";
 // ── Helpers ──
@@ -73,7 +73,17 @@ export function BotDashboard({ initialState, onQuit, onPause, subscribe }) {
     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) }) })] }), isMultiSymbol ? (_jsxs(Box, { borderStyle: "single", borderColor: "gray", paddingX: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Text, { children: ["Exchanges: ", _jsx(Text, { bold: true, color: "white", children: state.exchangeBalances?.length ?? 1 })] }), _jsxs(Text, { color: "gray", children: ["Positions: ", _jsx(Text, { bold: true, color: state.positions.length > 0 ? "yellow" : "white", children: state.positions.length })] }), _jsxs(Text, { color: "gray", children: ["Total Equity: ", _jsxs(Text, { bold: true, color: "white", children: ["$", (state.exchangeBalances?.reduce((s, e) => s + parseFloat(e.equity), 0) ?? state.equity).toFixed(2)] })] }), _jsxs(Text, { color: "gray", children: ["PnL: ", _jsxs(Text, { bold: true, color: state.totalPnl >= 0 ? "green" : "red", children: ["$", state.totalPnl.toFixed(2)] })] })] })) : (_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: [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"] }) })] }));
+                            })] }))] }), _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))))] })] }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: state.strategyState.fundingTotal !== undefined ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: "cyan", bold: true, children: "Funding & Arb" }), _jsxs(Box, { flexDirection: "row", marginLeft: 2, children: [_jsx(Text, { color: "gray", children: "Funding Income: " }), _jsx(Text, { color: "white", children: String(state.strategyState.fundingTotal) }), _jsx(Text, { color: "gray", children: "        Positions: " }), _jsx(Text, { color: "white", children: String(state.strategyState.arbPositions ?? 0) })] }), Array.isArray(state.strategyState.arbPositionDetails) &&
+                            state.strategyState.arbPositionDetails.map((detail, i) => (_jsx(Box, { marginLeft: 2, children: _jsx(Text, { color: "yellow", children: detail }) }, i)))] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: "cyan", bold: true, children: "Strategy State" }), _jsxs(Box, { flexDirection: "row", flexWrap: "wrap", children: [Object.entries(state.strategyState)
+                                    .filter(([k, v]) => {
+                                    if (k === 'arbRunning' || k === 'fundingLastCheck' || k === 'fundingHistory' || k === 'arbOpenPositions')
+                                        return false;
+                                    if (Array.isArray(v) || (typeof v === 'object' && v !== null))
+                                        return false;
+                                    return true;
+                                })
+                                    .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 ──
 function pad(s, width) {

package/dist/exchanges/aster.d.ts

@@ -14,7 +14,11 @@ export declare class AsterAdapter implements ExchangeAdapter {
     private _testnet;
     private _marketsCache;
     private _marketsCacheTime;
+    private _accountCache;
+    private _positionsCache;
+    private _ordersCache;
     private static readonly CACHE_TTL;
+    private static readonly ACCOUNT_CACHE_TTL;
     constructor(apiKey?: string, apiSecret?: string, testnet?: boolean);
     get isReadOnly(): boolean;
     /** CLI symbol → Aster API symbol (ETH → ETHUSDT) */

package/dist/exchanges/aster.js

@@ -14,7 +14,11 @@ export class AsterAdapter {
     _testnet;
     _marketsCache = null;
     _marketsCacheTime = 0;
-    static CACHE_TTL = 10_000; // 10 seconds
+    _accountCache = null;
+    _positionsCache = null;
+    _ordersCache = null;
+    static CACHE_TTL = 30_000; // 30 seconds (markets)
+    static ACCOUNT_CACHE_TTL = 5_000; // 5 seconds (account/positions/orders)
     constructor(apiKey, apiSecret, testnet = false) {
         this._apiKey = apiKey || process.env.ASTER_API_KEY || "";
         this._apiSecret = apiSecret || process.env.ASTER_API_SECRET || "";
@@ -137,21 +141,29 @@ export class AsterAdapter {
     }
     // ── Account ──
     async getBalance() {
+        if (this._accountCache && Date.now() - this._accountCache.time < AsterAdapter.ACCOUNT_CACHE_TTL) {
+            return this._accountCache.data;
+        }
         const account = await this._signedGet("/fapi/v2/account");
         const totalWallet = Number(account.totalWalletBalance ?? 0);
         const unrealizedPnl = Number(account.totalUnrealizedProfit ?? 0);
         const available = Number(account.availableBalance ?? 0);
         const marginUsed = Number(account.totalInitialMargin ?? 0);
-        return {
+        const result = {
             equity: String(totalWallet + unrealizedPnl),
             available: String(available),
             marginUsed: String(marginUsed),
             unrealizedPnl: String(unrealizedPnl),
         };
+        this._accountCache = { data: result, time: Date.now() };
+        return result;
     }
     async getPositions() {
+        if (this._positionsCache && Date.now() - this._positionsCache.time < AsterAdapter.ACCOUNT_CACHE_TTL) {
+            return this._positionsCache.data;
+        }
         const data = await this._signedGet("/fapi/v2/positionRisk");
-        return (data ?? [])
+        const result = (data ?? [])
             .filter((p) => Number(p.positionAmt ?? 0) !== 0)
             .map((p) => {
             const amt = Number(p.positionAmt ?? 0);
@@ -166,10 +178,15 @@ export class AsterAdapter {
                 leverage: Number(p.leverage ?? 1),
             };
         });
+        this._positionsCache = { data: result, time: Date.now() };
+        return result;
     }
     async getOpenOrders() {
+        if (this._ordersCache && Date.now() - this._ordersCache.time < AsterAdapter.ACCOUNT_CACHE_TTL) {
+            return this._ordersCache.data;
+        }
         const orders = await this._signedGet("/fapi/v1/openOrders");
-        return (orders ?? []).map((o) => ({
+        const result = (orders ?? []).map((o) => ({
             orderId: String(o.orderId ?? ""),
             symbol: this._fromApi(String(o.symbol ?? "")),
             side: String(o.side).toLowerCase(),
@@ -179,6 +196,8 @@ export class AsterAdapter {
             status: String(o.status ?? ""),
             type: String(o.type ?? ""),
         }));
+        this._ordersCache = { data: result, time: Date.now() };
+        return result;
     }
     async getOrderHistory(limit = 30) {
         // allOrders requires symbol — get from positions or recent trades

package/dist/exchanges/hyperliquid.d.ts

@@ -16,6 +16,9 @@ export declare class HyperliquidAdapter implements ExchangeAdapter {
     /** HIP-3 deployed perp dex name. Empty string = native (validator) perps. */
     private _dex;
     private static _lastNonce;
+    private _marketsCache;
+    private _marketsCacheTime;
+    private static readonly CACHE_TTL;
     constructor(privateKey?: string, testnet?: boolean);
     /** Set the HIP-3 deployed perp dex to query/trade on. */
     setDex(dex: string): void;
@@ -44,7 +47,7 @@ export declare class HyperliquidAdapter implements ExchangeAdapter {
         asks: [string, string][];
     }>;
     private ensureAddress;
-    /** Always fetches live clearinghouseState, writes result to shared cache for dashboard */
+    /** Read-through cached clearinghouseState — returns cached data if fresh */
     private _getClearinghouseState;
     /** Cached spot clearinghouse state — shared between getBalance() and HyperliquidSpotAdapter */
     _getSpotClearinghouseState(): Promise<Record<string, unknown>>;

package/dist/exchanges/hyperliquid.js

@@ -15,7 +15,9 @@ export class HyperliquidAdapter {
     /** HIP-3 deployed perp dex name. Empty string = native (validator) perps. */
     _dex = "";
     static _lastNonce = 0;
-    // In-memory cache removed — using file-based cache (src/cache.ts) for cross-process dedup
+    _marketsCache = null;
+    _marketsCacheTime = 0;
+    static CACHE_TTL = 30_000;
     constructor(privateKey, testnet = false) {
         // Disable WebSocket in SDK — we use REST for all info calls and raw
         // fetch for /exchange. This avoids the false "Please install ws" warning
@@ -181,6 +183,8 @@ export class HyperliquidAdapter {
         throw new Error(`Unknown asset: ${symbol}`);
     }
     async getMarkets() {
+        if (this._marketsCache && Date.now() - this._marketsCacheTime < HyperliquidAdapter.CACHE_TTL)
+            return this._marketsCache;
         let universe;
         let ctxs;
         let mids = {};
@@ -207,7 +211,7 @@ export class HyperliquidAdapter {
                 this._assetMapReverse.set(i, sym);
             });
         }
-        return universe.map((asset, i) => {
+        const result = universe.map((asset, i) => {
             const ctx = (ctxs[i] ?? {});
             const sym = String(asset.name);
             return {
@@ -220,6 +224,9 @@ export class HyperliquidAdapter {
                 maxLeverage: Number(asset.maxLeverage ?? 50),
             };
         });
+        this._marketsCache = result;
+        this._marketsCacheTime = Date.now();
+        return result;
     }
     async getOrderbook(symbol) {
         let levels;
@@ -256,12 +263,12 @@ export class HyperliquidAdapter {
             throw new Error("No private key configured — account data unavailable. Run: perp setup");
         }
     }
-    /** Always fetches live clearinghouseState, writes result to shared cache for dashboard */
+    /** Read-through cached clearinghouseState — returns cached data if fresh */
     async _getClearinghouseState() {
         this.ensureAddress();
-        const { fetchAndCache, TTL_ACCOUNT } = await import("../cache.js");
+        const { withCache, TTL_ACCOUNT } = await import("../cache.js");
         const key = this._dex ? `acct:hl:chs:${this._address}:${this._dex}` : `acct:hl:chs:${this._address}`;
-        return fetchAndCache(key, TTL_ACCOUNT, async () => {
+        return withCache(key, TTL_ACCOUNT, async () => {
             const state = this._dex
                 ? await this._infoPost({ type: "clearinghouseState", user: this._address, dex: this._dex })
                 : await this.sdk.info.perpetuals.getClearinghouseState(this._address);

package/dist/exchanges/lighter.d.ts

@@ -20,6 +20,9 @@ export declare class LighterAdapter implements ExchangeAdapter {
     private _testnet;
     private _readOnly;
     private _evmSigner?;
+    private _marketsCache;
+    private _marketsCacheTime;
+    private static readonly CACHE_TTL;
     /**
      * @param evmKey    EVM private key (0x-prefixed, 32 bytes) — for deposits & key registration
      * @param testnet   Use testnet (chain ID 300) instead of mainnet (chain ID 304)

package/dist/exchanges/lighter.js

@@ -18,7 +18,9 @@ export class LighterAdapter {
     _testnet;
     _readOnly;
     _evmSigner;
-    // In-memory cache removed — using file-based cache (src/cache.ts) for cross-process dedup
+    _marketsCache = null;
+    _marketsCacheTime = 0;
+    static CACHE_TTL = 30_000;
     /**
      * @param evmKey    EVM private key (0x-prefixed, 32 bytes) — for deposits & key registration
      * @param testnet   Use testnet (chain ID 300) instead of mainnet (chain ID 304)
@@ -260,6 +262,8 @@ export class LighterAdapter {
         return { baseAmount, priceTicks };
     }
     async getMarkets() {
+        if (this._marketsCache && Date.now() - this._marketsCacheTime < LighterAdapter.CACHE_TTL)
+            return this._marketsCache;
         const markets = [];
         try {
             const res = await this.restGet("/orderBookDetails", {});
@@ -281,13 +285,15 @@ export class LighterAdapter {
             }
         }
         catch { /* non-critical */ }
+        this._marketsCache = markets;
+        this._marketsCacheTime = Date.now();
         return markets;
     }
     async fetchAccount() {
         if (!this._address)
             return null;
-        const { fetchAndCache, TTL_ACCOUNT } = await import("../cache.js");
-        return fetchAndCache(`acct:lt:account:${this._address}`, TTL_ACCOUNT, async () => {
+        const { withCache, TTL_ACCOUNT } = await import("../cache.js");
+        return withCache(`acct:lt:account:${this._address}`, TTL_ACCOUNT, async () => {
             const res = await this.restGet("/account", {
                 by: "l1_address",
                 value: this._address,

package/dist/exchanges/pacifica.d.ts

@@ -11,6 +11,9 @@ export declare class PacificaAdapter implements ExchangeAdapter {
     private _hasRealKey;
     private account;
     private signMessage;
+    private _marketsCache;
+    private _marketsCacheTime;
+    private static readonly CACHE_TTL;
     constructor(keypair: Keypair, network?: Network, builderCode?: string, hasRealKey?: boolean);
     private ensureSigner;
     /** Inject an external Solana signer. */

package/dist/exchanges/pacifica.js

@@ -9,7 +9,9 @@ export class PacificaAdapter {
     _hasRealKey;
     account;
     signMessage;
-    // In-memory caches removed — using file-based cache (src/cache.ts) for cross-process dedup
+    _marketsCache = null;
+    _marketsCacheTime = 0;
+    static CACHE_TTL = 30_000;
     constructor(keypair, network = "mainnet", builderCode, hasRealKey = true) {
         this._solanaSigner = new LocalSolanaSigner(keypair);
         this._hasRealKey = hasRealKey;
@@ -36,12 +38,12 @@ export class PacificaAdapter {
         throw new Error("keypair not available with external signer");
     }
     async _getPrices() {
-        const { fetchAndCache, TTL_ACCOUNT } = await import("../cache.js");
-        return fetchAndCache(`acct:pac:prices:${this.account.slice(0, 8)}`, TTL_ACCOUNT, () => this.client.getPrices());
+        const { withCache, TTL_ACCOUNT } = await import("../cache.js");
+        return withCache(`acct:pac:prices:${this.account.slice(0, 8)}`, TTL_ACCOUNT, () => this.client.getPrices());
     }
     async _getPositions() {
-        const { fetchAndCache, TTL_ACCOUNT } = await import("../cache.js");
-        return fetchAndCache(`acct:pac:positions:${this.account.slice(0, 8)}`, TTL_ACCOUNT, () => this.client.getPositions(this.account));
+        const { withCache, TTL_ACCOUNT } = await import("../cache.js");
+        return withCache(`acct:pac:positions:${this.account.slice(0, 8)}`, TTL_ACCOUNT, () => this.client.getPositions(this.account));
     }
     get publicKey() {
         return this.account;
@@ -53,12 +55,14 @@ export class PacificaAdapter {
         return this.signMessage;
     }
     async getMarkets() {
+        if (this._marketsCache && Date.now() - this._marketsCacheTime < PacificaAdapter.CACHE_TTL)
+            return this._marketsCache;
         const [markets, prices] = await Promise.all([
             this.client.getInfo(),
             this._getPrices(),
         ]);
         const priceMap = new Map(prices.map((p) => [p.symbol, p]));
-        return markets.map((m) => {
+        const result = markets.map((m) => {
             const p = priceMap.get(m.symbol);
             return {
                 symbol: m.symbol,
@@ -70,6 +74,9 @@ export class PacificaAdapter {
                 maxLeverage: m.max_leverage,
             };
         });
+        this._marketsCache = result;
+        this._marketsCacheTime = Date.now();
+        return result;
     }
     async getOrderbook(symbol) {
         const book = await this.client.getBook(symbol);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perp-cli",
-  "version": "0.7.12",
+  "version": "0.7.15",
   "description": "Multi-DEX Perpetual Futures CLI - Pacifica, Hyperliquid, Lighter, Aster",
   "bin": {
     "perp": "dist/index.js",