perp-cli 0.7.1 → 0.7.3

package/dist/bot/strategies/grid-strategy.js

@@ -25,6 +25,8 @@ export class GridStrategy {
     async init(ctx, snapshot) {
         this._config = ctx.config;
         const params = this.params;
+        if (params.grids < 2)
+            throw new Error("Grid strategy requires at least 2 grid lines");
         // Determine price range
         if (params.range_mode === "auto") {
             const pct = params.range_pct ?? 3;
@@ -40,12 +42,12 @@ export class GridStrategy {
             ctx.state.set("gridUpper", params.upper);
             ctx.state.set("gridLower", params.lower);
         }
-        ctx.state.set("gridOrders", new Map());
+        ctx.state.set("gridLevels", []);
+        ctx.state.set("gridInitialized", false);
     }
     async onTick(ctx, snapshot) {
         const params = this.params;
         const actions = [];
-        const gridOrders = ctx.state.get("gridOrders");
         const gridUpper = ctx.state.get("gridUpper");
         const gridLower = ctx.state.get("gridLower");
         // First tick: set leverage + place initial grid
@@ -53,59 +55,62 @@ export class GridStrategy {
             if (params.leverage) {
                 actions.push({ type: "set_leverage", leverage: params.leverage });
             }
-            return [...actions, ...this.buildGridOrders(ctx, snapshot.price)];
+            const gridActions = this.buildGridOrders(ctx, snapshot.price);
+            ctx.state.set("gridInitialized", true);
+            return [...actions, ...gridActions];
+        }
+        // Wait one tick after init/rebalance for orders to settle on exchange
+        if (!ctx.state.get("gridInitialized")) {
+            ctx.state.set("gridInitialized", true);
+            return [];
         }
         if (params.grids < 2)
             throw new Error("Grid requires at least 2 grid lines");
         const step = (gridUpper - gridLower) / (params.grids - 1);
         const sizePerGrid = params.size / params.grids;
-        // Check for fills
+        // Price tolerance for matching: half a grid step
+        const tolerance = step * 0.5;
+        const gridLevels = ctx.state.get("gridLevels");
+        // Check for fills by comparing expected grid levels against actual open orders
         try {
             const openOrders = await ctx.adapter.getOpenOrders();
-            const openIds = new Set(openOrders.filter(o => o.symbol.toUpperCase() === ctx.symbol.toUpperCase()).map(o => o.orderId));
-            // Build filled order IDs from order history for accurate fill detection
-            let filledIds = null;
-            try {
-                const history = await ctx.adapter.getOrderHistory(100);
-                filledIds = new Set(history.filter(o => o.status === "filled").map(o => o.orderId));
-            }
-            catch { /* non-critical -- fall back to assuming fills */ }
-            let newFills = 0;
-            for (const [idx, orderId] of gridOrders.entries()) {
-                if (!openIds.has(orderId)) {
-                    // Verify the order was actually filled (not just cancelled)
-                    if (filledIds && !filledIds.has(orderId)) {
-                        ctx.log(`  [GRID] Order ${orderId} missing -- likely cancelled, skipping`);
-                        gridOrders.delete(idx);
-                        continue;
-                    }
-                    // Order filled -- place opposite order
-                    newFills++;
-                    // Determine new side and price
-                    const oldPrice = gridLower + step * idx;
-                    const wasBuy = oldPrice < snapshot.price;
-                    const newSide = wasBuy ? "sell" : "buy";
-                    const newPrice = wasBuy ? oldPrice + step : oldPrice - step;
-                    if (newPrice >= gridLower && newPrice <= gridUpper) {
-                        actions.push({
-                            type: "place_order",
-                            side: newSide,
-                            price: newPrice.toFixed(2),
-                            size: String(sizePerGrid),
-                            orderType: "limit",
-                        });
-                        // We'll update gridOrders when the action is executed
-                        // For now mark this index as pending -- use a sentinel
-                        gridOrders.set(idx, `pending-${idx}`);
-                    }
-                    else {
-                        gridOrders.delete(idx);
-                    }
+            const symbolOrders = openOrders.filter(o => o.symbol.toUpperCase() === ctx.symbol.toUpperCase());
+            // For each grid level, check if a matching open order exists (by price proximity)
+            const unmatchedLevels = [];
+            const matchedLevels = [];
+            for (const level of gridLevels) {
+                const hasMatch = symbolOrders.some(o => {
+                    const orderPrice = parseFloat(o.price);
+                    return Math.abs(orderPrice - level.price) < tolerance && o.side === level.side;
+                });
+                if (hasMatch) {
+                    matchedLevels.push(level);
                 }
+                else {
+                    unmatchedLevels.push(level);
+                }
+            }
+            if (unmatchedLevels.length > 0) {
+                ctx.log(`  [GRID] ${unmatchedLevels.length} fill(s) detected`);
             }
-            if (newFills > 0) {
-                ctx.log(`  [GRID] ${newFills} fill(s) detected`);
+            // For each filled level, place the opposite (counter) order
+            const newLevels = [...matchedLevels];
+            for (const filled of unmatchedLevels) {
+                const wasBuy = filled.side === "buy";
+                const newSide = wasBuy ? "sell" : "buy";
+                const newPrice = wasBuy ? filled.price + step : filled.price - step;
+                if (newPrice >= gridLower && newPrice <= gridUpper) {
+                    actions.push({
+                        type: "place_order",
+                        side: newSide,
+                        price: newPrice.toFixed(2),
+                        size: String(sizePerGrid),
+                        orderType: "limit",
+                    });
+                    newLevels.push({ price: newPrice, side: newSide });
+                }
             }
+            ctx.state.set("gridLevels", newLevels);
         }
         catch { /* retry next loop */ }
         // Auto-rebalance if price exits range
@@ -120,12 +125,12 @@ export class GridStrategy {
                 ctx.state.set("gridUpper", newUpper);
                 ctx.state.set("gridLower", newLower);
                 ctx.state.set("lastRebalance", Date.now());
+                ctx.state.set("gridInitialized", false);
                 const rebalanceCount = (ctx.state.get("rebalanceCount") ?? 0) + 1;
                 ctx.state.set("rebalanceCount", rebalanceCount);
                 ctx.log(`  [GRID] Rebalance #${rebalanceCount}: price $${snapshot.price.toFixed(2)} outside range -> new $${newLower.toFixed(2)} - $${newUpper.toFixed(2)}`);
                 // Cancel all and rebuild
                 actions.push({ type: "cancel_all" });
-                gridOrders.clear();
                 return [...actions, ...this.buildGridOrders(ctx, snapshot.price)];
             }
         }
@@ -144,11 +149,11 @@ export class GridStrategy {
         const step = (gridUpper - gridLower) / (params.grids - 1);
         const sizePerGrid = params.size / params.grids;
         const actions = [];
+        const gridLevels = [];
         // Cancel existing orders first
-        const gridOrders = ctx.state.get("gridOrders");
-        if (gridOrders.size > 0) {
+        const existingLevels = ctx.state.get("gridLevels");
+        if (existingLevels && existingLevels.length > 0) {
             actions.push({ type: "cancel_all" });
-            gridOrders.clear();
         }
         for (let i = 0; i < params.grids; i++) {
             const price = gridLower + step * i;
@@ -166,9 +171,9 @@ export class GridStrategy {
                 size: String(sizePerGrid),
                 orderType: "limit",
             });
-            // Mark grid index with pending sentinel -- engine updates after execution
-            gridOrders.set(i, `pending-${i}`);
+            gridLevels.push({ price, side });
         }
+        ctx.state.set("gridLevels", gridLevels);
         ctx.log(`  [GRID] Placing ${params.grids} orders (step: $${step.toFixed(2)}, size: ${sizePerGrid.toFixed(6)})`);
         return actions;
     }

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

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

package/dist/bot/tui/BotDashboard.js

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

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

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

package/dist/cli-spec.js

@@ -38,7 +38,7 @@ export function getCliSpec(program) {
         description: "Multi-DEX Perpetual Futures CLI (Pacifica, Hyperliquid, Lighter)",
         globalOptions,
         commands,
-        exchanges: ["pacifica", "hyperliquid", "lighter"],
+        exchanges: ["pacifica", "hyperliquid", "lighter", "aster"],
         envelope: {
             success: "{ ok: true, data: T, meta: { timestamp } }",
             error: "{ ok: false, error: { code, message, retryable?, retryAfterMs? }, meta: { timestamp } }",

package/dist/commands/account.js

@@ -2,7 +2,7 @@ import { makeTable, formatUsd, formatPnl, printJson, jsonOk, jsonError, symbolMa
 import chalk from "chalk";
 import { assessRisk } from "../risk.js";
 import { hasPacificaSdk, isDexCapable } from "../exchanges/capabilities.js";
-const EXCHANGES = ["pacifica", "hyperliquid", "lighter"];
+const EXCHANGES = ["pacifica", "hyperliquid", "lighter", "aster"];
 async function fetchExchangeSnapshot(name, getAdapter) {
     try {
         const adapter = await getAdapter(name);

package/dist/commands/arb/index.js

@@ -26,11 +26,12 @@ function formatDuration(ms) {
 }
 async function fetchFundingRatesMap() {
     const rateMap = new Map();
-    const [pacAssets, hlAssets, ltDetails, ltFunding] = await Promise.all([
+    const [pacAssets, hlAssets, ltDetails, ltFunding, asterPremiums] = await Promise.all([
         fetchPacificaPrices(),
         fetchHyperliquidMeta(),
         fetchLighterOrderBookDetails(),
         fetchLighterFundingRates(),
+        fetch("https://fapi.asterdex.com/fapi/v1/premiumIndex").then(r => r.json()).catch(() => []),
     ]);
     const addRate = (sym, exchange, rate, markPrice) => {
         if (!sym)
@@ -51,6 +52,13 @@ async function fetchFundingRatesMap() {
         const mp = fr.markPrice || ltPriceMap.get(fr.marketId) || 0;
         addRate(sym, "lighter", fr.rate, mp);
     }
+    // Aster: premiumIndex
+    for (const p of asterPremiums ?? []) {
+        const rawSym = String(p.symbol ?? "");
+        if (!rawSym.endsWith("USDT"))
+            continue;
+        addRate(rawSym.replace(/USDT$/, ""), "aster", Number(p.lastFundingRate ?? 0), Number(p.markPrice ?? 0));
+    }
     return rateMap;
 }
 function findArbEntryForPair(symbol, longExchange, shortExchange) {
@@ -454,7 +462,7 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         // ── Spot-Perp detailed view ──
         if (spotPerpPositions.length > 0) {
             for (const sp of spotPerpPositions) {
-                const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : "LT";
+                const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
                 const spreadStr = sp.currentSpread !== null ? `${sp.currentSpread.toFixed(1)}%` : "-";
                 const spotPriceEach = sp.spotAmount > 0 ? sp.spotValueUsd / sp.spotAmount : 0;
                 const spotPnl = sp.spotValueUsd - (sp.perpEntryPrice * sp.spotAmount); // spot value vs entry
@@ -1272,8 +1280,8 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         const snapshots = await fetchAllBalances(adapters);
         const totalEquity = snapshots.reduce((s, e) => s + e.equity, 0);
         const totalAvailable = snapshots.reduce((s, e) => s + e.available, 0);
-        const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e.toUpperCase();
-        const exChain = (e) => e === "pacifica" ? "Solana" : e === "hyperliquid" ? "Hyperliquid" : e === "lighter" ? "Arbitrum" : "unknown";
+        const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
+        const exChain = (e) => e === "pacifica" ? "Solana" : e === "hyperliquid" ? "Hyperliquid" : e === "lighter" ? "Arbitrum" : e === "aster" ? "BNB" : "unknown";
         if (opts.check) {
             // Show current balance distribution
             if (isJson()) {

package/dist/commands/arb-auto.d.ts

@@ -5,6 +5,7 @@ interface FundingSnapshot {
     pacRate: number;
     hlRate: number;
     ltRate: number;
+    astRate: number;
     spread: number;
     longExch: string;
     shortExch: string;
@@ -12,6 +13,7 @@ interface FundingSnapshot {
     pacMarkPrice: number;
     hlMarkPrice: number;
     ltMarkPrice: number;
+    astMarkPrice: number;
 }
 /**
  * Compute the estimated round-trip cost as a percentage of notional.

package/dist/commands/arb-auto.js

@@ -98,28 +98,41 @@ export function isNearSettlement(longExchange, shortExchange, bufferMinutes = 5,
  * meaning we're now paying on both sides instead of collecting.
  */
 export function isSpreadReversed(longExchange, shortExchange, snapshot) {
-    const rateFor = (e) => e === "pacifica" ? snapshot.pacRate : e === "hyperliquid" ? snapshot.hlRate : snapshot.ltRate;
+    const rateFor = (e) => e === "pacifica" ? snapshot.pacRate : e === "hyperliquid" ? snapshot.hlRate : e === "aster" ? snapshot.astRate : snapshot.ltRate;
     const longHourly = toHourlyRate(rateFor(longExchange), longExchange);
     const shortHourly = toHourlyRate(rateFor(shortExchange), shortExchange);
     // Reversed if the long side rate exceeds the short side rate
     return longHourly > shortHourly;
 }
 async function fetchFundingSpreads() {
-    const [pacRes, hlRes, ltDetailsRes, ltFundingRes] = await Promise.all([
+    const [pacRes, hlRes, ltDetailsRes, ltFundingRes, astPremiums] = await Promise.all([
         fetchPacificaPricesRaw(),
         fetchHyperliquidMetaRaw(),
         fetchLighterOrderBookDetailsRaw(),
         fetchLighterFundingRatesRaw(),
+        fetch("https://fapi.asterdex.com/fapi/v1/premiumIndex").then(r => r.json()).catch(() => []),
     ]);
     const { rates: pacRates, prices: pacPrices } = parsePacificaRaw(pacRes);
     const { rates: hlRates, prices: hlPrices } = parseHyperliquidMetaRaw(hlRes);
     const { rates: ltRates, prices: ltPrices } = parseLighterRaw(ltDetailsRes, ltFundingRes);
+    // Aster: parse premiumIndex
+    const astRates = new Map();
+    const astPrices = new Map();
+    for (const p of astPremiums ?? []) {
+        const rawSym = String(p.symbol ?? "");
+        if (!rawSym.endsWith("USDT"))
+            continue;
+        const sym = rawSym.replace(/USDT$/, "");
+        astRates.set(sym, Number(p.lastFundingRate ?? 0));
+        astPrices.set(sym, Number(p.markPrice ?? 0));
+    }
     const snapshots = [];
-    const allSymbols = new Set([...pacRates.keys(), ...hlRates.keys(), ...ltRates.keys()]);
+    const allSymbols = new Set([...pacRates.keys(), ...hlRates.keys(), ...ltRates.keys(), ...astRates.keys()]);
     for (const sym of allSymbols) {
         const pac = pacRates.get(sym);
         const hl = hlRates.get(sym);
         const lt = ltRates.get(sym);
+        const ast = astRates.get(sym);
         // Need at least 2 exchanges
         const available = [];
         if (pac !== undefined)
@@ -128,6 +141,8 @@ async function fetchFundingSpreads() {
             available.push({ exchange: "hyperliquid", rate: hl });
         if (lt !== undefined)
             available.push({ exchange: "lighter", rate: lt });
+        if (ast !== undefined)
+            available.push({ exchange: "aster", rate: ast });
         if (available.length < 2)
             continue;
         const norm = (r) => toHourlyRate(r.rate, r.exchange);
@@ -135,13 +150,14 @@ async function fetchFundingSpreads() {
         const lowest = available[0];
         const highest = available[available.length - 1];
         const spread = computeAnnualSpread(highest.rate, highest.exchange, lowest.rate, lowest.exchange);
-        // Use best available mark price (prefer HL as most liquid, then PAC, then LT)
-        const markPrice = hlPrices.get(sym) ?? pacPrices.get(sym) ?? ltPrices.get(sym) ?? 0;
+        // Use best available mark price (prefer HL as most liquid, then PAC, then LT, then AST)
+        const markPrice = hlPrices.get(sym) ?? pacPrices.get(sym) ?? ltPrices.get(sym) ?? astPrices.get(sym) ?? 0;
         snapshots.push({
             symbol: sym,
             pacRate: pac ?? 0,
             hlRate: hl ?? 0,
             ltRate: lt ?? 0,
+            astRate: ast ?? 0,
             spread,
             longExch: lowest.exchange, // long where funding is lowest
             shortExch: highest.exchange, // short where funding is highest
@@ -149,6 +165,7 @@ async function fetchFundingSpreads() {
             pacMarkPrice: pacPrices.get(sym) ?? 0,
             hlMarkPrice: hlPrices.get(sym) ?? 0,
             ltMarkPrice: ltPrices.get(sym) ?? 0,
+            astMarkPrice: astPrices.get(sym) ?? 0,
         });
     }
     return snapshots.sort((a, b) => Math.abs(b.spread) - Math.abs(a.spread));
@@ -541,7 +558,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                 // Log next settlement times and funding estimation
                 if (!isJson() && settleStrategy !== "off") {
                     const nowDate = new Date();
-                    const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : "LT";
+                    const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
                     const nextHL = getNextSettlement("hyperliquid", nowDate);
                     const nextPAC = getNextSettlement("pacifica", nowDate);
                     const nextLT = getNextSettlement("lighter", nowDate);
@@ -553,7 +570,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                         const fSnap = filtered.find(s => s.symbol === fPos.symbol);
                         if (!fSnap)
                             continue;
-                        const fRateFor = (e) => e === "pacifica" ? fSnap.pacRate : e === "hyperliquid" ? fSnap.hlRate : fSnap.ltRate;
+                        const fRateFor = (e) => e === "pacifica" ? fSnap.pacRate : e === "hyperliquid" ? fSnap.hlRate : e === "aster" ? fSnap.astRate : fSnap.ltRate;
                         const fHlHourly = toHourlyRate(fRateFor("hyperliquid"), "hyperliquid");
                         const fPacHourly = toHourlyRate(fRateFor("pacifica"), "pacifica");
                         const fNotional = fPos.size * fSnap.markPrice;
@@ -679,7 +696,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                         const effectiveNetSpread = netSpread * settleBoostMultiplier;
                         if (effectiveNetSpread < minSpread)
                             continue;
-                        const rateForExch = (e) => e === "pacifica" ? snap.pacRate : e === "hyperliquid" ? snap.hlRate : snap.ltRate;
+                        const rateForExch = (e) => e === "pacifica" ? snap.pacRate : e === "hyperliquid" ? snap.hlRate : e === "aster" ? snap.astRate : snap.ltRate;
                         console.log(chalk.green(`  ${now} ENTER ${snap.symbol} — gross ${grossSpread.toFixed(1)}% net ${netSpread.toFixed(1)}%` +
                             ` | Long ${longExchange} (${(rateForExch(longExchange) * 100).toFixed(4)}%)` +
                             ` | Short ${shortExchange} (${(rateForExch(shortExchange) * 100).toFixed(4)}%)`));
@@ -885,7 +902,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                         const elapsedHours = (nowMs - pos.lastCheckTime) / (1000 * 60 * 60);
                         const notional = pos.size * current.markPrice;
                         // Estimate funding collected: normalize all rates to hourly before comparing
-                        const rateFor = (e) => e === "pacifica" ? current.pacRate : e === "hyperliquid" ? current.hlRate : current.ltRate;
+                        const rateFor = (e) => e === "pacifica" ? current.pacRate : e === "hyperliquid" ? current.hlRate : e === "aster" ? current.astRate : current.ltRate;
                         const longHourly = toHourlyRate(rateFor(pos.longExchange), pos.longExchange);
                         const shortHourly = toHourlyRate(rateFor(pos.shortExchange), pos.shortExchange);
                         // Income = short gets paid positive funding, long pays; net = (shortRate - longRate) * notional * hours
@@ -1074,7 +1091,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                     console.log(chalk.gray(`  Liquidity check: ON`));
                 console.log(chalk.gray(`  Press Ctrl+C to stop\n`));
             }
-            const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : "LT";
+            const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
             while (true) {
                 cycle++;
                 const ts = new Date().toLocaleTimeString();
@@ -1144,7 +1161,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
         if (opts.compare)
             return handleCompare(isJson, opts.compare);
         if (opts.rates)
-            return handleRates(isJson, { symbol: opts.symbol, symbols: opts.symbols, all: opts.all, minSpread: opts.min });
+            return handleRates(isJson, { symbol: opts.symbol, symbols: opts.symbols, all: opts.all, minSpread: opts.min, top: opts.top });
         if (opts.basis)
             return handleBasisScan(isJson, { minBasis: opts.min, symbol: typeof opts.basis === "string" ? opts.basis : opts.symbol });
         if (opts.hip3)
@@ -1191,7 +1208,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                     console.log(chalk.gray(`  No spot+perp opportunities above ${minSpread}%\n`));
                 }
                 else {
-                    const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : "LT";
+                    const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
                     const rows = spotSpreads.slice(0, parseInt(opts.top ?? "30")).map(s => {
                         const spotEx = s.spotExchanges[0] || "lighter";
                         const rtCost = computeRoundTripCostPct(spotEx, s.perpExchange);
@@ -1226,15 +1243,18 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
         if (!isJson())
             console.log(chalk.cyan("  Scanning perp-perp funding rate spreads...\n"));
         const spreads = await fetchFundingSpreads();
-        const filtered = spreads.filter(s => Math.abs(s.spread) >= minSpread);
+        let filtered = spreads.filter(s => Math.abs(s.spread) >= minSpread);
+        if (opts.top)
+            filtered = filtered.slice(0, parseInt(opts.top));
         if (isJson()) {
             const perpPerp = filtered.map(s => {
                 const grossSpread = Math.abs(s.spread);
                 const rtCost = computeRoundTripCostPct(s.longExch, s.shortExch);
                 const net = computeNetSpread(grossSpread, holdDays, rtCost, bridgeCostUsd, sizeUsd);
                 // Compute price gap between long and short exchanges
-                const longPrice = s.longExch === "pacifica" ? s.pacMarkPrice : s.longExch === "hyperliquid" ? s.hlMarkPrice : s.ltMarkPrice;
-                const shortPrice = s.shortExch === "pacifica" ? s.pacMarkPrice : s.shortExch === "hyperliquid" ? s.hlMarkPrice : s.ltMarkPrice;
+                const pFor = (ex) => ex === "pacifica" ? s.pacMarkPrice : ex === "hyperliquid" ? s.hlMarkPrice : ex === "lighter" ? s.ltMarkPrice : s.astMarkPrice;
+                const longPrice = pFor(s.longExch);
+                const shortPrice = pFor(s.shortExch);
                 const mid = (longPrice + shortPrice) / 2;
                 const priceGapPct = mid > 0 ? Math.abs(longPrice - shortPrice) / mid * 100 : 0;
                 return { mode: "perp-perp", symbol: s.symbol, longExch: s.longExch, shortExch: s.shortExch, markPrice: s.markPrice, grossSpread, netSpread: net, estFeesPct: rtCost, priceGapPct: Math.round(priceGapPct * 10000) / 10000 };
@@ -1262,7 +1282,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
             console.log(chalk.gray(`  No perp-perp spreads above ${minSpread}%\n`));
             return;
         }
-        const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : "LT";
+        const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
         const rows = filtered.map(s => {
             const direction = `${exAbbr(s.shortExch)}>${exAbbr(s.longExch)}`;
             const grossSpread = Math.abs(s.spread);
@@ -1270,8 +1290,9 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
             const netSpread = computeNetSpread(grossSpread, holdDays, rtCost, bridgeCostUsd, sizeUsd);
             const grossColor = grossSpread >= 50 ? chalk.green.bold : grossSpread >= 30 ? chalk.green : chalk.yellow;
             const netColor = netSpread >= 20 ? chalk.green : netSpread >= 0 ? chalk.yellow : chalk.red;
-            const longPrice = s.longExch === "pacifica" ? s.pacMarkPrice : s.longExch === "hyperliquid" ? s.hlMarkPrice : s.ltMarkPrice;
-            const shortPrice = s.shortExch === "pacifica" ? s.pacMarkPrice : s.shortExch === "hyperliquid" ? s.hlMarkPrice : s.ltMarkPrice;
+            const priceFor = (ex) => ex === "pacifica" ? s.pacMarkPrice : ex === "hyperliquid" ? s.hlMarkPrice : ex === "lighter" ? s.ltMarkPrice : s.astMarkPrice;
+            const longPrice = priceFor(s.longExch);
+            const shortPrice = priceFor(s.shortExch);
             const mid = (longPrice + shortPrice) / 2;
             const priceGapPct = mid > 0 ? Math.abs(longPrice - shortPrice) / mid * 100 : 0;
             const gapColor = priceGapPct >= 0.5 ? chalk.red : priceGapPct >= 0.1 ? chalk.yellow : chalk.gray;
@@ -1282,6 +1303,8 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                 rates.push(`HL:${(s.hlRate * 100).toFixed(4)}%`);
             if (s.ltRate)
                 rates.push(`LT:${(s.ltRate * 100).toFixed(4)}%`);
+            if (s.astRate)
+                rates.push(`AST:${(s.astRate * 100).toFixed(4)}%`);
             return [
                 chalk.white.bold(s.symbol),
                 grossColor(`${grossSpread.toFixed(1)}%`),

package/dist/commands/arb.d.ts

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

package/dist/commands/arb.js

@@ -24,6 +24,23 @@ async function fetchHyperliquidRates() {
         markPrice: a.markPx,
     }));
 }
+async function fetchAsterRates() {
+    try {
+        const premiums = await fetch("https://fapi.asterdex.com/fapi/v1/premiumIndex").then(r => r.json());
+        return (premiums ?? [])
+            .filter(p => String(p.symbol ?? "").endsWith("USDT"))
+            .map(p => ({
+            exchange: "aster",
+            symbol: String(p.symbol ?? "").replace(/USDT$/, ""),
+            fundingRate: Number(p.lastFundingRate ?? 0),
+            markPrice: Number(p.markPrice ?? 0),
+            nextFunding: Number(p.nextFundingTime ?? 0),
+        }));
+    }
+    catch {
+        return [];
+    }
+}
 async function fetchLighterRates() {
     try {
         const [details, funding] = await Promise.all([
@@ -222,18 +239,20 @@ function printSnapshotTable(snapshot) {
         const pacRate = s.rates.find(r => r.exchange === "pacifica");
         const hlRate = s.rates.find(r => r.exchange === "hyperliquid");
         const ltRate = s.rates.find(r => r.exchange === "lighter");
+        const astRate = s.rates.find(r => r.exchange === "aster");
         const spreadColor = s.maxSpreadAnnual >= 30 ? chalk.green : s.maxSpreadAnnual >= 10 ? chalk.yellow : chalk.white;
-        const bestRate = hlRate ?? pacRate ?? ltRate;
+        const bestRate = hlRate ?? pacRate ?? ltRate ?? astRate;
         const trend = trendMap.get(s.symbol) ?? chalk.gray("-");
         return [
             chalk.white.bold(s.symbol), pacRate ? formatPercent(pacRate.fundingRate) : chalk.gray("-"),
             hlRate ? formatPercent(hlRate.fundingRate) : chalk.gray("-"), ltRate ? formatPercent(ltRate.fundingRate) : chalk.gray("-"),
+            astRate ? formatPercent(astRate.fundingRate) : chalk.gray("-"),
             spreadColor(`${s.maxSpreadAnnual.toFixed(1)}%`), trend,
             s.maxSpreadAnnual >= 5 ? `${exAbbr(s.shortExchange)}>${exAbbr(s.longExchange)}` : chalk.gray("-"),
             formatAvgRate(bestRate?.historicalAvg?.avg8h), formatAvgRate(bestRate?.historicalAvg?.avg24h), formatAvgRate(bestRate?.historicalAvg?.avg7d),
         ];
     });
-    console.log(makeTable(["Symbol", "Pacifica", "Hyperliquid", "Lighter", "Spread", "24h", "Direction", "Avg 8h", "Avg 24h", "Avg 7d"], rows));
+    console.log(makeTable(["Symbol", "Pacifica", "Hyperliquid", "Lighter", "Aster", "Spread", "24h", "Direction", "Avg 8h", "Avg 24h", "Avg 7d"], rows));
     console.log(chalk.gray(`\n  ${snapshot.symbols.length} symbols compared across exchanges.\n`));
 }
 function printFundingExchangeStatus(snapshot) {
@@ -278,6 +297,8 @@ export async function handleRates(isJson, opts) {
             saveFundingSnapshot(allRates);
     }
     catch { /* non-critical */ }
+    if (opts.top)
+        snapshot.symbols = snapshot.symbols.slice(0, parseInt(opts.top));
     if (isJson()) {
         // Enrich with 24h rate history for each symbol
         const now = new Date();
@@ -299,10 +320,10 @@ export async function handleRates(isJson, opts) {
 export async function handleBasisScan(isJson, opts) {
     if (!isJson())
         console.log(chalk.cyan("  Fetching prices for basis calculation...\n"));
-    const [pacRates, hlRates, ltRates] = await Promise.all([fetchPacificaRates(), fetchHyperliquidRates(), fetchLighterRates()]);
+    const [pacRates, hlRates, ltRates, astRates] = await Promise.all([fetchPacificaRates(), fetchHyperliquidRates(), fetchLighterRates(), fetchAsterRates()]);
     const exchangePrices = new Map();
     const filterSymbol = opts.symbol?.toUpperCase();
-    for (const r of [...pacRates, ...hlRates, ...ltRates]) {
+    for (const r of [...pacRates, ...hlRates, ...ltRates, ...astRates]) {
         if (r.markPrice <= 0)
             continue;
         if (filterSymbol && r.symbol.toUpperCase() !== filterSymbol)
@@ -506,7 +527,7 @@ export async function handleFundingPositions(isJson, getAdapterForExchange, opts
         const tA = results.reduce((s, r) => s + r.actualNet24h, 0);
         if (isJson())
             return printJson(jsonOk({ positions: results.map(r => ({ exchange: r.exchange, symbol: r.symbol, side: r.side, size: r.size, notionalUsd: +r.notionalUsd.toFixed(2), fundingRate: r.fundingRate, annualPct: +r.annualPct.toFixed(2), predicted: { hourly: +r.hourlyPayment.toFixed(6), daily: +r.dailyPayment.toFixed(4) }, actual24h: { received: +r.actualReceived24h.toFixed(6), paid: +r.actualPaid24h.toFixed(6), net: +r.actualNet24h.toFixed(6) }, unrealizedPnl: r.unrealizedPnl })), totals: { predicted: { hourly: +tH.toFixed(6), daily: +tD.toFixed(4) }, actual24h: { net: +tA.toFixed(6) }, notionalUsd: +tN.toFixed(2) }, errors: Object.keys(exchangeErrors).length > 0 ? exchangeErrors : undefined }));
-        const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e.toUpperCase();
+        const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
         console.log(chalk.cyan.bold("  Position Funding Impact\n"));
         const rows = results.map(r => { const sc = r.side === "long" ? chalk.green : chalk.red; const rc = r.fundingRate > 0 ? chalk.red : r.fundingRate < 0 ? chalk.green : chalk.white; const as = r.actualNet24h !== 0 ? (r.actualNet24h > 0 ? chalk.green : chalk.red)(`${r.actualNet24h > 0 ? "+" : ""}$${r.actualNet24h.toFixed(4)}`) : chalk.gray("-"); return [chalk.white.bold(exAbbr(r.exchange)), chalk.white.bold(r.symbol), sc(r.side.toUpperCase()), `$${formatUsd(r.notionalUsd)}`, rc(formatPercent(r.fundingRate)), rc(`${r.annualPct.toFixed(1)}%`), as, formatPnl(r.unrealizedPnl)]; });
         console.log(makeTable(["Ex", "Symbol", "Side", "Notional", "Rate(now)", "Annual(now)", "Actual 24h", "uPnL"], rows));