perp-cli 0.12.13 → 0.12.14

package/dist/mcp-server.js

@@ -530,11 +530,11 @@ server.tool("suggest_command", "Given a natural language trading goal, suggest t
             steps.push({ step: 1, command: "perp strategy plan example", description: "Show example execution plan format" }, { step: 2, command: "perp --json strategy plan validate <file>", description: "Validate plan file" }, { step: 3, command: "perp --json strategy plan execute <file> --dry-run", description: "Dry-run the plan", dangerous: true });
         }
         else if (g.includes("status") || g.includes("check") || g.includes("overview") || g.includes("portfolio")) {
-            steps.push({ step: 1, command: `perp -e ${ex} --json status`, description: "Full account overview" }, { step: 2, command: `perp -e ${ex} --json account positions`, description: "Detailed positions" }, { step: 3, command: `perp -e ${ex} --json account orders`, description: "Open orders" }, { step: 4, command: "perp --json portfolio", description: "Cross-exchange portfolio summary" });
+            steps.push({ step: 1, command: `perp -e ${ex} --json portfolio`, description: "Single-exchange portfolio overview" }, { step: 2, command: `perp -e ${ex} --json account positions`, description: "Detailed positions" }, { step: 3, command: `perp -e ${ex} --json account orders`, description: "Open orders" }, { step: 4, command: "perp --json portfolio --arb", description: "Cross-exchange portfolio + top arb opportunities" });
         }
         else if (g.includes("deposit")) {
             const amount = extractNumber(g) || "<amount>";
-            steps.push({ step: 1, command: "perp --json wallet balance", description: "Check wallet balance" }, { step: 2, command: `perp --json funds deposit ${ex} ${amount}`, description: `Deposit $${amount} to ${ex}`, dangerous: true }, { step: 3, command: `perp -e ${ex} --json account balance`, description: "Verify deposit arrived" });
+            steps.push({ step: 1, command: "perp --json wallet balance", description: "Check wallet balance" }, { step: 2, command: `perp --json funds deposit ${ex} ${amount}`, description: `Deposit $${amount} to ${ex}`, dangerous: true }, { step: 3, command: `perp -e ${ex} --json portfolio`, description: "Verify deposit arrived" });
         }
         else if (g.includes("withdraw")) {
             const amount = extractNumber(g) || "<amount>";
@@ -567,7 +567,7 @@ server.tool("suggest_command", "Given a natural language trading goal, suggest t
             steps.push({ step: 1, command: "perp settings show", description: "Show current settings" }, { step: 2, command: "perp settings referrals on", description: "Enable referral codes (no extra fees, just volume tracking)" });
         }
         else {
-            steps.push({ step: 1, command: `perp -e ${ex} --json status`, description: "Check account status" }, { step: 2, command: `perp -e ${ex} --json account balance`, description: "Check exchange connectivity via balance fetch" });
+            steps.push({ step: 1, command: `perp -e ${ex} --json portfolio`, description: "Check account overview" }, { step: 2, command: `perp --json portfolio --health --exchanges ${ex}`, description: "Check exchange connectivity" });
         }
         return {
             content: [{
@@ -1055,10 +1055,10 @@ server.resource("cli_schema", "perp://schema", { mimeType: "application/json", d
     const schema = {
         schemaVersion: "2.0",
         name: "perp",
-        description: "Multi-DEX Perpetual Futures CLI (Pacifica, Hyperliquid, Lighter)",
-        exchanges: ["pacifica", "hyperliquid", "lighter"],
+        description: "Multi-DEX Perpetual Futures CLI (Pacifica, Hyperliquid, Lighter, Aster)",
+        exchanges: ["pacifica", "hyperliquid", "lighter", "aster"],
         globalFlags: [
-            { flag: "-e, --exchange <name>", description: "Exchange to use (pacifica, hyperliquid, lighter)", default: "pacifica" },
+            { flag: "-e, --exchange <name>", description: "Exchange to use (pacifica, hyperliquid, lighter, aster)", default: "pacifica" },
             { flag: "--json", description: "Output as JSON for structured parsing" },
             { flag: "-n, --network <net>", description: "Network: mainnet or testnet", default: "mainnet" },
             { flag: "--dry-run", description: "Simulate without executing (for trade commands)" },
@@ -1080,7 +1080,7 @@ server.resource("cli_schema", "perp://schema", { mimeType: "application/json", d
             account: {
                 description: "Account data (read-only)",
                 subcommands: {
-                    info: { usage: "perp account balance", description: "Balance, equity, margin, PnL" },
+                    info: { usage: "perp portfolio -e <exchange>", description: "Single-exchange balance, equity, margin, PnL" },
                     positions: { usage: "perp account positions", description: "Open positions" },
                     orders: { usage: "perp account orders", description: "Open/pending orders" },
                     history: { usage: "perp account history", description: "Order history" },
@@ -1240,7 +1240,7 @@ server.resource("cli_schema", "perp://schema", { mimeType: "application/json", d
             },
             portfolio: { usage: "perp portfolio", description: "Cross-exchange portfolio summary" },
             status: { usage: "perp portfolio", description: "Full account overview" },
-            health: { usage: "perp account balance --json", description: "Exchange connectivity check via balance fetch" },
+            health: { usage: "perp portfolio --health", description: "Exchange connectivity check" },
             settings: {
                 description: "CLI settings",
                 subcommands: {
@@ -1418,7 +1418,7 @@ server.tool("get_funding_analysis", "Analyze funding income across exchanges —
     symbol: z.string().optional().describe("Filter by symbol"),
 }, async ({ period, exchange: exFilter, symbol: symFilter }) => {
     try {
-        const exchanges = exFilter ? [exFilter] : ["pacifica", "hyperliquid", "lighter"];
+        const exchanges = exFilter ? [exFilter] : ["pacifica", "hyperliquid", "lighter", "aster"];
         const periodMatch = period.match(/^(\d+)(d|w|m)$/);
         const sinceMs = periodMatch
             ? Date.now() - parseInt(periodMatch[1]) * ({ d: 86400000, w: 604800000, m: 2592000000 }[periodMatch[2]] ?? 86400000)
@@ -1488,7 +1488,7 @@ server.tool("get_pnl_analysis", "P&L analysis combining trading fees and funding
     exchange: z.string().optional().describe("Filter by exchange"),
 }, async ({ period, exchange: exFilter }) => {
     try {
-        const exchanges = exFilter ? [exFilter] : ["pacifica", "hyperliquid", "lighter"];
+        const exchanges = exFilter ? [exFilter] : ["pacifica", "hyperliquid", "lighter", "aster"];
         const periodMatch = period.match(/^(\d+)(d|w|m)$/);
         const sinceMs = periodMatch
             ? Date.now() - parseInt(periodMatch[1]) * ({ d: 86400000, w: 604800000, m: 2592000000 }[periodMatch[2]] ?? 86400000)
@@ -1602,7 +1602,7 @@ server.tool("get_arb_compare", "Compare active arbitrage positions side by side
 // ============================================================
 server.resource("market_prices", "market://prices", { mimeType: "application/json", description: "Live cross-exchange prices for all perpetual futures markets" }, async () => {
     const prices = {};
-    await Promise.allSettled(["pacifica", "hyperliquid", "lighter"].map(async (ex) => {
+    await Promise.allSettled(["pacifica", "hyperliquid", "lighter", "aster"].map(async (ex) => {
         try {
             const adapter = await getOrCreateAdapter(ex);
             const markets = await adapter.getMarkets();
@@ -1669,7 +1669,8 @@ server.prompt("trading-guide", "Step-by-step guide for trading with perp-cli via
 ## Supported Exchanges
 - **pacifica** (Solana) — SOL-based perpetual futures
 - **hyperliquid** (HyperEVM) — Low-fee perpetuals with HIP-3 DEXes
-- **lighter** (Ethereum) — Ethereum-based perpetual futures`,
+- **lighter** (Ethereum) — Ethereum-based perpetual futures
+- **aster** (BNB Chain) — BNB Chain perpetual futures`,
             },
         }],
 }));

package/dist/trade-validator.js

@@ -10,21 +10,20 @@ export async function validateTrade(adapter, params) {
     const checks = [];
     const warnings = [];
     const sym = params.symbol.toUpperCase();
-    // Fetch market data, balance, positions, orderbook in parallel.
+    // Fetch market list, balance, and positions in parallel.
+    // Defer the orderbook call until symbol membership is confirmed so invalid
+    // symbols return a structured symbol_valid failure instead of a venue error.
     // SSOT rule #2: errors must propagate, never silently substitute defaults.
     // getMarkets retains a tracked-error wrapper so the failed-load case surfaces
     // a structured symbol_valid check (not a generic exception).
     let marketsError = null;
-    const [markets, balance, positions, orderbook] = await Promise.all([
+    const [markets, balance, positions] = await Promise.all([
         adapter.getMarkets().catch((e) => {
             marketsError = e instanceof Error ? e.message : String(e);
             return [];
         }),
         adapter.getBalance(),
         adapter.getPositions(),
-        params.type !== "limit"
-            ? adapter.getOrderbook(sym)
-            : Promise.resolve({ bids: [], asks: [] }),
     ]);
     if (markets.length === 0 && marketsError) {
         checks.push({ check: "symbol_valid", passed: false, message: `Failed to load markets from ${adapter.name}: ${marketsError}` });
@@ -42,6 +41,9 @@ export async function validateTrade(adapter, params) {
         checks.push({ check: "symbol_valid", passed: false, message: `${sym} not found on ${adapter.name}` });
         return { valid: false, checks, warnings, timestamp: new Date().toISOString() };
     }
+    const orderbook = params.type !== "limit"
+        ? await adapter.getOrderbook(sym)
+        : { bids: [], asks: [] };
     const markPrice = Number(market.markPrice);
     if (params.type === "limit" && (params.price === undefined || !Number.isFinite(params.price))) {
         throw new Error(`Limit order requires explicit price (received ${params.price}); refusing silent mark-price substitution.`);

package/package.json

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

package/skills/perp-cli/SKILL.md

@@ -5,7 +5,7 @@ allowed-tools: "Bash(perp:*), Bash(npx perp-cli:*), Bash(npx -y perp-cli:*)"
 license: MIT
 metadata:
   author: hypurrquant
-  version: "0.12.13"
+  version: "0.12.14"
 ---
 
 # perp-cli Agent Guide
@@ -41,7 +41,7 @@ Multi-DEX perpetual futures CLI + MCP server — Pacifica (Solana), Hyperliquid
 ## Install
 
 ```bash
-perp --version 2>/dev/null  # check if exists (must be >= 0.12.13)
+perp --version 2>/dev/null  # check if exists (must be >= 0.12.14)
 npm install -g perp-cli@latest 2>/dev/null || npx -y perp-cli@latest --json --version
 ```