perp-cli 0.7.1 → 0.7.3

package/dist/commands/bot.js

@@ -1,6 +1,6 @@
 import chalk from "chalk";
 import { printJson, jsonOk } from "../utils.js";
-import { loadBotConfig, quickGridConfig, quickDCAConfig, runBot, PRESETS, getPreset, getPresetsByStrategy } from "../bot/index.js";
+import { loadBotConfig, parseStrategy, quickGridConfig, quickDCAConfig, runBot, PRESETS, getPreset, getPresetsByStrategy } from "../bot/index.js";
 import { updateJobState } from "../jobs.js";
 import { runTWAP, runFundingArb, runGrid, runDCA, runTrailingStop } from "../strategies/index.js";
 export function registerBotCommands(program, getAdapter, getAdapterFor, isJson) {
@@ -88,7 +88,7 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
     // ── bot quick dca ──
     bot
         .command("quick-dca <symbol> <side> <amount> <interval>")
-        .description("Quick-start a DCA bot")
+        .description("Quick-start a DCA bot (interval: seconds between orders)")
         .option("--orders <n>", "Total orders (0 = unlimited)", "0")
         .option("--price-limit <price>", "Don't buy above / sell below this price")
         .option("--trigger-drop <pct>", "Only buy when price drops X% from recent high")
@@ -140,7 +140,7 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         .option("--close-spread <pct>", "Close when spread drops below (%)", "5")
         .option("--size <usd>", "Position size per leg ($)", "50")
         .option("--max-positions <n>", "Max simultaneous positions", "3")
-        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter")
+        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter,aster")
         .option("--interval <sec>", "Check interval in seconds", "60")
         .option("--max-drawdown <usd>", "Stop if drawdown exceeds ($)", "200")
         .option("--background", "Run in background (tmux)")
@@ -343,6 +343,8 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         .option("--max-slots <n>", "Max concurrent positions", "3")
         .option("--daily-limit <usd>", "Daily loss limit in USD", "250")
         .option("--headless", "Run without TUI dashboard")
+        .option("--background", "Run in background (tmux)")
+        .option("--job-id <id>", "Job ID")
         .action(async (symbol, opts) => {
         const adapter = await getAdapter();
         const sym = (symbol ?? "ETH").toUpperCase();
@@ -366,9 +368,27 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
             },
             monitor_interval_sec: 10,
         };
+        if (opts.background) {
+            const { startJob } = await import("../jobs.js");
+            const cliArgs = [
+                `-e`, adapter.name, `apex`, sym,
+                `--preset`, opts.preset, `--max-slots`, opts.maxSlots,
+                `--daily-limit`, opts.dailyLimit,
+            ];
+            const job = startJob({
+                strategy: `bot:apex`,
+                exchange: adapter.name,
+                params: { symbol: sym, ...opts },
+                cliArgs,
+            });
+            if (isJson())
+                return printJson(jsonOk(job));
+            printBotJobStarted(config.name, job.id);
+            return;
+        }
         const mode = resolveOutputMode(isJson, opts.headless);
         const log = makeLog();
-        await runBot(adapter, config, undefined, log, undefined, mode);
+        await runBot(adapter, config, opts.jobId, log, undefined, mode);
     });
     // ── bot reflect ──
     bot
@@ -411,12 +431,24 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
     // ── bot run <strategy> <symbol> ──
     bot
         .command("run <strategy> [symbol]")
-        .description("Run any registered strategy (symbol optional for multi-symbol strategies like funding-auto)")
+        .description("Run a strategy (use 'perp bot list-strategies' to see all). Symbol optional for multi-symbol strategies.")
         .option("--config <path>", "YAML/JSON config file")
         .option("--headless", "Run without TUI dashboard")
         .option("--param <key=value>", "Strategy parameter (repeatable)", (val, acc) => [...acc, val], [])
         .action(async (strategyName, symbol, opts) => {
         const sym = symbol?.toUpperCase() || "ALL";
+        // Strategies that require an explicit symbol
+        const symbolRequiredStrategies = [
+            "grid", "dca", "simple-mm", "engine-mm", "avellaneda-mm",
+            "momentum-breakout", "mean-reversion", "aggressive-taker",
+            "grid-mm", "liquidation-mm", "regime-mm",
+        ];
+        if (sym === "ALL" && symbolRequiredStrategies.includes(strategyName)) {
+            console.error(chalk.red(`\n  Error: The '${strategyName}' strategy requires a <symbol> argument.`));
+            console.error(chalk.gray(`  Usage: perp bot run ${strategyName} <symbol>\n`));
+            process.exitCode = 1;
+            return;
+        }
         // Load or build config
         let config;
         if (opts.config) {
@@ -445,11 +477,12 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
                     params[key] = raw;
             }
             const adapter = await getAdapter();
+            const strategy = parseStrategy(strategyName, params);
             config = {
                 name: `${strategyName}-${sym.toLowerCase()}-${Date.now().toString(36)}`,
                 exchange: adapter.name,
                 symbol: sym,
-                strategy: params,
+                strategy,
                 entry_conditions: [{ type: "always", value: 0 }],
                 exit_conditions: [],
                 risk: {
@@ -464,10 +497,14 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         }
         // Verify strategy is registered
         await import("../bot/engine.js");
-        const { getStrategy } = await import("../bot/strategy-registry.js");
+        const { getStrategy, listStrategies: listStrats } = await import("../bot/strategy-registry.js");
         if (!getStrategy(strategyName)) {
+            const available = listStrats();
             console.error(chalk.red(`\n  Unknown strategy: "${strategyName}"`));
-            console.error(chalk.gray(`  Run 'perp bot list-strategies' to see available strategies.\n`));
+            console.error(chalk.gray(`\n  Available strategies:`));
+            for (const s of available)
+                console.error(chalk.gray(`    - ${s}`));
+            console.error();
             return;
         }
         const adapter = await getAdapter();
@@ -479,7 +516,7 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         const multiExchangeStrategies = ["funding-auto", "funding-arb", "funding-arb-v2", "basis-arb", "hedge-agent"];
         if (multiExchangeStrategies.includes(strategyName) && getAdapterFor) {
             extraAdapters = new Map();
-            for (const ex of ["pacifica", "hyperliquid", "lighter"]) {
+            for (const ex of ["pacifica", "hyperliquid", "lighter", "aster"]) {
                 if (ex === adapter.name)
                     continue;
                 try {
@@ -647,7 +684,7 @@ function registerRunSubcommands(parent, getAdapter, getAdapterFor, isJson) {
         .option("--interval <sec>", "Check interval in seconds", "60")
         .option("--auto-execute", "Actually place trades (default: monitor only)")
         .option("--max-positions <n>", "Max simultaneous positions", "3")
-        .option("--exchanges <list>", "Comma-separated exchanges to use", "pacifica,hyperliquid,lighter")
+        .option("--exchanges <list>", "Comma-separated exchanges to use", "pacifica,hyperliquid,lighter,aster")
         .option("--auto-rebalance", "Trigger rebalance alerts when exchange balance is low")
         .option("--rebalance-threshold <usd>", "Rebalance when available < this ($)", "100")
         .option("--max-drawdown <usd>", "Close all positions if total uPnL exceeds this loss ($)")

package/dist/commands/bridge.js

@@ -3,7 +3,7 @@ import { formatUsd, makeTable, printJson, jsonOk } from "../utils.js";
 import { logExecution } from "../execution-log.js";
 import { executeBestBridge, getAllQuotes, checkDebridgeStatus, checkBridgeGasBalance, CHAIN_IDS, USDC_ADDRESSES, EXCHANGE_TO_CHAIN, } from "../bridge-engine.js";
 export function registerBridgeCommands(program, isJson) {
-    const bridge = program.command("bridge").description("Cross-chain USDC bridge (deBridge DLN)");
+    const bridge = program.command("bridge").description("Cross-chain USDC bridge (deBridge DLN). See also: perp funds bridge (CCTP V2)");
     // ── bridge chains ──
     bridge
         .command("chains")

package/dist/commands/dashboard.js

@@ -50,7 +50,7 @@ export function registerDashboardCommands(program, getAdapterForExchange, isJson
         .description("Launch live web dashboard for real-time portfolio monitoring")
         .option("-p, --port <port>", "Port to serve dashboard on (auto-finds free port)", "3456")
         .option("--interval <ms>", "Poll interval in milliseconds", "5000")
-        .option("--exchanges <list>", "Comma-separated exchanges to monitor", "pacifica,hyperliquid,lighter")
+        .option("--exchanges <list>", "Comma-separated exchanges to monitor", "pacifica,hyperliquid,lighter,aster")
         .option("--dex <list>", "Comma-separated HIP-3 dexes to monitor (e.g. xyz,flx,hyna)")
         .option("--no-auto-dex", "Disable auto-detection of HIP-3 dexes with active positions")
         .action(async (opts) => {

package/dist/commands/funds.js

@@ -628,7 +628,7 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork) {
     // ═══════════════════════════════════════════════════════
     funds
         .command("bridge")
-        .description("Bridge USDC between chains via CCTP V2")
+        .description("Bridge USDC between chains via CCTP V2. See also: perp bridge (deBridge DLN)")
         .requiredOption("--from <chain>", "Source chain (arbitrum, ethereum)")
         .requiredOption("--to <chain>", "Destination chain (arbitrum, ethereum, solana)")
         .requiredOption("--amount <amount>", "USDC amount")

package/dist/commands/history.js

@@ -4,7 +4,7 @@ import { readExecutionLog, getExecutionStats, pruneExecutionLog } from "../execu
 import { loadArbState } from "../arb/index.js";
 import { readPositionHistory, getPositionStats } from "../position-history.js";
 import { saveEquitySnapshot, readEquityHistory, computePnlMetrics, computeDailyPnl, aggregateWeekly, } from "../equity-tracker.js";
-const EXCHANGES = ["pacifica", "hyperliquid", "lighter"];
+const EXCHANGES = ["pacifica", "hyperliquid", "lighter", "aster"];
 function parseSince(since) {
     if (!since)
         return undefined;
@@ -75,7 +75,11 @@ export function registerHistoryCommands(program, isJson, getAdapterForExchange)
                         : chalk.red;
                 const sideColor = r.side === "buy" || r.side === "long" ? chalk.green : chalk.red;
                 const time = new Date(r.timestamp).toLocaleString();
-                const notional = r.notional ? `$${formatUsd(r.notional)}` : r.price ? `$${formatUsd(Number(r.price) * Number(r.size))}` : "-";
+                const metaPrice = r.meta?.price ?? r.meta?.markPrice ?? r.meta?.entryPrice;
+                const effectivePrice = r.price ?? (typeof metaPrice === "number" || typeof metaPrice === "string" ? String(metaPrice) : undefined);
+                const sizeNum = Number(r.size);
+                const priceNum = effectivePrice ? Number(effectivePrice) : 0;
+                const notional = r.notional ? `$${formatUsd(r.notional)}` : (priceNum > 0 && sizeNum > 0) ? `$${formatUsd(priceNum * sizeNum)}` : "-";
                 return [
                     chalk.gray(time),
                     chalk.white(r.exchange),

package/dist/commands/init.d.ts

@@ -5,10 +5,10 @@ declare function loadEnvFile(): Record<string, string>;
 declare function setEnvVar(key: string, value: string): void;
 export declare const EXCHANGE_ENV_MAP: Record<string, {
     envKey: string;
-    chain: "solana" | "evm";
+    chain: "solana" | "evm" | "apikey";
     label: string;
 }>;
-export declare function validateKey(chain: "solana" | "evm", key: string): Promise<{
+export declare function validateKey(chain: "solana" | "evm" | "apikey", key: string): Promise<{
     valid: boolean;
     address: string;
 }>;

package/dist/commands/init.js

@@ -70,6 +70,7 @@ export const EXCHANGE_ENV_MAP = {
     pacifica: { envKey: "PACIFICA_PRIVATE_KEY", chain: "solana", label: "Pacifica (Solana)" },
     hyperliquid: { envKey: "HL_PRIVATE_KEY", chain: "evm", label: "Hyperliquid (EVM)" },
     lighter: { envKey: "LIGHTER_PRIVATE_KEY", chain: "evm", label: "Lighter (EVM)" },
+    aster: { envKey: "ASTER_API_KEY", chain: "apikey", label: "Aster (BNB Chain)" },
 };
 // ── Validate keys ─────────────────────────────────────────────
 export async function validateKey(chain, key) {
@@ -91,6 +92,10 @@ export async function validateKey(chain, key) {
             return { valid: false, address: "" };
         }
     }
+    else if (chain === "apikey") {
+        // API key validation: just check it's a non-empty hex-like string
+        return { valid: key.length >= 16, address: key.slice(0, 8) + "..." + key.slice(-4) };
+    }
     else {
         try {
             const { ethers } = await import("ethers");

package/dist/commands/market.js

@@ -1,7 +1,7 @@
 import { makeTable, formatUsd, formatPercent, printJson, jsonOk, jsonError, withJsonErrors } from "../utils.js";
 import chalk from "chalk";
 import { hasPacificaSdk, isDexCapable } from "../exchanges/capabilities.js";
-const EXCHANGES = ["pacifica", "hyperliquid", "lighter"];
+const EXCHANGES = ["pacifica", "hyperliquid", "lighter", "aster"];
 export function registerMarketCommands(program, getAdapter, isJson, getAdapterForExchange) {
     const market = program.command("market").description("Market data commands");
     market
@@ -163,7 +163,7 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
             if (isJson())
                 return printJson(jsonError("SYMBOL_NOT_FOUND", `Market ${sym} not found`));
             console.log(chalk.red(`\n  Market "${sym}" not found.\n`));
-            return;
+            return process.exit(1);
         }
         if (isJson())
             return printJson(jsonOk(m));
@@ -228,9 +228,10 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
     market
         .command("trades <symbol>")
         .description("Recent trades for a symbol")
-        .action(async (symbol) => {
+        .option("--limit <n>", "Number of recent trades to show", "20")
+        .action(async (symbol, opts) => {
         const adapter = await getAdapter();
-        const trades = await adapter.getRecentTrades(symbol.toUpperCase(), 20);
+        const trades = await adapter.getRecentTrades(symbol.toUpperCase(), parseInt(opts.limit));
         if (isJson())
             return printJson(jsonOk(trades));
         if (trades.length === 0) {
@@ -258,12 +259,20 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
             console.log(chalk.gray("\n  No funding history.\n"));
             return;
         }
-        const rows = history.map((h) => [
-            new Date(h.time).toLocaleString(),
-            formatPercent(h.rate),
-            h.price != null ? `$${formatUsd(h.price)}` : chalk.gray("n/a"),
-        ]);
-        console.log(makeTable(["Time", "Funding Rate", "Oracle"], rows));
+        const hasOracle = history.some((h) => h.price != null && h.price !== "0" && h.price !== "");
+        const rows = history.map((h) => {
+            const base = [
+                new Date(h.time).toLocaleString(),
+                formatPercent(h.rate),
+            ];
+            if (hasOracle)
+                base.push(h.price != null ? `$${formatUsd(h.price)}` : chalk.gray("n/a"));
+            return base;
+        });
+        const headers = hasOracle ? ["Time", "Funding Rate", "Oracle"] : ["Time", "Funding Rate"];
+        console.log(makeTable(headers, rows));
+        if (!hasOracle)
+            console.log(chalk.gray("  Note: Oracle price not available for this exchange.\n"));
     });
     market
         .command("mid <symbol>")
@@ -367,7 +376,7 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
             console.log(chalk.cyan.bold("\n  HIP-3 Deployed Perp DEXes\n"));
             const rows = dexes.map(d => [
                 chalk.white.bold(d.name),
-                chalk.gray(d.deployer.slice(0, 10) + "..."),
+                chalk.gray(d.deployer ? d.deployer.slice(0, 6) + "..." + d.deployer.slice(-4) : "-"),
                 String(d.assets.length),
                 d.assets.slice(0, 5).join(", ") + (d.assets.length > 5 ? ` +${d.assets.length - 5}` : ""),
             ]);

package/dist/commands/rebalance.js

@@ -9,7 +9,7 @@ export function registerRebalanceCommands(program, getAdapterForExchange, isJson
     rebalance
         .command("check")
         .description("Show balances across all exchanges")
-        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter")
+        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter,aster")
         .action(async (opts) => {
         const exchangeNames = opts.exchanges.split(",").map((e) => e.trim());
         const adapters = new Map();
@@ -55,7 +55,7 @@ export function registerRebalanceCommands(program, getAdapterForExchange, isJson
     rebalance
         .command("plan")
         .description("Calculate optimal rebalancing moves")
-        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter")
+        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter,aster")
         .option("--min-move <usd>", "Minimum move amount ($)", "50")
         .option("--reserve <usd>", "Keep at least this much per exchange ($)", "20")
         .action(async (opts) => {
@@ -115,7 +115,7 @@ export function registerRebalanceCommands(program, getAdapterForExchange, isJson
     rebalance
         .command("execute")
         .description("Execute rebalancing (withdraw → bridge → deposit)")
-        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter")
+        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter,aster")
         .option("--min-move <usd>", "Minimum move amount ($)", "50")
         .option("--reserve <usd>", "Keep at least this much per exchange ($)", "20")
         .option("--dry-run", "Show what would happen without executing")

package/dist/commands/risk.js

@@ -47,7 +47,7 @@ export async function runHealthCheck(isJson) {
     const overall = allOk ? chalk.green("ALL HEALTHY") : chalk.red("ISSUES DETECTED");
     console.log(`\n  Overall: ${overall}\n`);
 }
-const EXCHANGES = ["pacifica", "hyperliquid", "lighter"];
+const EXCHANGES = ["pacifica", "hyperliquid", "lighter", "aster"];
 export function registerRiskCommands(program, getAdapterForExchange, isJson) {
     const risk = program.command("risk").description("Risk management and guardrails");
     // ── risk status ──

package/dist/commands/settings.js

@@ -15,7 +15,7 @@ function resolveEnvKey(nameOrKey) {
     if (info)
         return { envKey: info.envKey, chain: info.chain };
     // Common aliases
-    const aliases = { hl: "hyperliquid", pac: "pacifica", lt: "lighter" };
+    const aliases = { hl: "hyperliquid", pac: "pacifica", lt: "lighter", ast: "aster" };
     const aliased = aliases[nameOrKey.toLowerCase()];
     if (aliased)
         return resolveEnvKey(aliased);

package/dist/commands/trade.js

@@ -244,7 +244,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
     trade
         .command("limit <symbol> <side> <price> <size>")
         .description("Place a limit order")
-        .option("--tif <tif>", "Time in force: GTC, IOC, ALO, TOB", "GTC")
+        .option("--tif <tif>", "Time in force: GTC, IOC, ALO (HL only), TOB (HL only)", "GTC")
         .option("--reduce-only", "Reduce only order")
         .option("--client-id <id>", "Client order ID for idempotent tracking")
         .option("--auto-id", "Auto-generate a client order ID")
@@ -494,7 +494,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
     // === TP/SL — Pacifica + Hyperliquid ===
     trade
         .command("tpsl <symbol> <side>")
-        .description("Set take-profit / stop-loss on a position")
+        .description("Set take-profit / stop-loss on a position (side: the side to CLOSE — buy to close short, sell to close long)")
         .option("--tp <price>", "Take profit trigger price")
         .option("--tp-limit <price>", "Take profit limit price")
         .option("--sl <price>", "Stop loss trigger price")
@@ -558,7 +558,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
     trade
         .command("scale-tp <symbol>")
         .description("Place multiple take-profit limit orders at different price levels (분할익절)")
-        .requiredOption("--levels <levels>", "Comma-separated price:percent pairs (e.g., 72000:25,75000:25,80000:50)")
+        .requiredOption("--levels <levels>", "[required] Comma-separated price:percent pairs (e.g., 72000:25,75000:25,80000:50)")
         .option("--size <size>", "Override total position size (default: uses current position)")
         .action(async (symbol, opts) => {
         const sym = symbol.toUpperCase();

package/dist/commands/wallet.js

@@ -363,10 +363,10 @@ export function registerWalletCommands(program, isJson) {
         if (!info) {
             if (isJson()) {
                 const { jsonError } = await import("../utils.js");
-                return printJson(jsonError("INVALID_PARAMS", `Unknown exchange: ${exchange}. Use: pacifica, hyperliquid, lighter (or hl, pac, lt)`));
+                return printJson(jsonError("INVALID_PARAMS", `Unknown exchange: ${exchange}. Use: pacifica, hyperliquid, lighter, aster (or hl, pac, lt, ast)`));
             }
             console.error(chalk.red(`\n  Unknown exchange: ${exchange}`));
-            console.error(chalk.gray(`  Use: pacifica, hyperliquid, lighter (or hl, pac, lt)\n`));
+            console.error(chalk.gray(`  Use: pacifica, hyperliquid, lighter, aster (or hl, pac, lt, ast)\n`));
             process.exit(1);
         }
         const { valid, address } = await validateKey(info.chain, key);

package/dist/config.d.ts

@@ -1,5 +1,5 @@
 import { Keypair } from "@solana/web3.js";
-export type Exchange = "pacifica" | "hyperliquid" | "lighter";
+export type Exchange = "pacifica" | "hyperliquid" | "lighter" | "aster";
 /**
  * Try to load a private key without throwing if none is found.
  * Returns null if no key is configured.

package/dist/config.js

@@ -32,6 +32,7 @@ export async function loadPrivateKey(exchange, pkOverride, walletName) {
         pacifica: ["PACIFICA_PRIVATE_KEY", "pk"],
         hyperliquid: ["HYPERLIQUID_PRIVATE_KEY", "HL_PRIVATE_KEY"],
         lighter: ["LIGHTER_PRIVATE_KEY"],
+        aster: ["ASTER_API_KEY"],
     };
     for (const envVar of envMap[exchange]) {
         if (process.env[envVar])

package/dist/constants.js

@@ -7,6 +7,7 @@ export const TAKER_FEES = {
     hyperliquid: 0.00035,
     pacifica: 0.00035,
     lighter: 0,
+    aster: 0.0004, // 0.04% taker fee
 };
 /** Get taker fee for an exchange. Uses settings if available, falls back to defaults. */
 export function getTakerFee(exchange) {

package/dist/exchanges/aster.d.ts

@@ -14,6 +14,10 @@ export declare class AsterAdapter implements ExchangeAdapter {
     private _testnet;
     constructor(apiKey?: string, apiSecret?: string, testnet?: boolean);
     get isReadOnly(): boolean;
+    /** CLI symbol → Aster API symbol (ETH → ETHUSDT) */
+    private _toApi;
+    /** Aster API symbol → CLI symbol (ETHUSDT → ETH) */
+    private _fromApi;
     init(): Promise<void>;
     getMarkets(): Promise<ExchangeMarketInfo[]>;
     getOrderbook(symbol: string): Promise<{

package/dist/exchanges/aster.js

@@ -23,6 +23,17 @@ export class AsterAdapter {
     get isReadOnly() {
         return !this._apiKey || !this._apiSecret;
     }
+    /** CLI symbol → Aster API symbol (ETH → ETHUSDT) */
+    _toApi(symbol) {
+        const s = symbol.toUpperCase().replace(/-PERP$/, "");
+        if (s.endsWith("USDT") || s.endsWith("BUSD"))
+            return s;
+        return `${s}USDT`;
+    }
+    /** Aster API symbol → CLI symbol (ETHUSDT → ETH) */
+    _fromApi(symbol) {
+        return symbol.replace(/USDT$/, "").replace(/BUSD$/, "");
+    }
     async init() {
         // Verify connectivity by fetching server time
         await this._publicGet("/fapi/v1/time");
@@ -70,7 +81,7 @@ export class AsterAdapter {
             // Extract max leverage from leverage brackets if available
             const maxLev = Number(s.maxLeverage ?? 50);
             return {
-                symbol: sym,
+                symbol: this._fromApi(sym),
                 markPrice: String(premium?.markPrice ?? ticker?.lastPrice ?? "0"),
                 indexPrice: String(premium?.indexPrice ?? "0"),
                 fundingRate: String(premium?.lastFundingRate ?? "0"),
@@ -81,7 +92,7 @@ export class AsterAdapter {
         });
     }
     async getOrderbook(symbol) {
-        const res = await this._publicGet("/fapi/v1/depth", { symbol: symbol.toUpperCase(), limit: "50" });
+        const res = await this._publicGet("/fapi/v1/depth", { symbol: this._toApi(symbol), limit: "50" });
         return {
             bids: res?.bids ?? [],
             asks: res?.asks ?? [],
@@ -89,12 +100,12 @@ export class AsterAdapter {
     }
     async getRecentTrades(symbol, limit = 20) {
         const trades = await this._publicGet("/fapi/v1/trades", {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             limit: String(limit),
         });
         return (trades ?? []).map((t) => ({
             time: Number(t.time ?? 0),
-            symbol: symbol.toUpperCase(),
+            symbol: this._fromApi(String(t.symbol ?? symbol)),
             side: t.isBuyerMaker ? "sell" : "buy",
             price: String(t.price ?? "0"),
             size: String(t.qty ?? "0"),
@@ -103,7 +114,7 @@ export class AsterAdapter {
     }
     async getFundingHistory(symbol, limit = 10) {
         const data = await this._publicGet("/fapi/v1/fundingRate", {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             limit: String(limit),
         });
         return (data ?? []).map((d) => ({
@@ -114,7 +125,7 @@ export class AsterAdapter {
     }
     async getKlines(symbol, interval, startTime, endTime) {
         const data = await this._publicGet("/fapi/v1/klines", {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             interval,
             startTime: String(startTime),
             endTime: String(endTime),
@@ -151,7 +162,7 @@ export class AsterAdapter {
             .map((p) => {
             const amt = Number(p.positionAmt ?? 0);
             return {
-                symbol: String(p.symbol ?? ""),
+                symbol: this._fromApi(String(p.symbol ?? "")),
                 side: amt > 0 ? "long" : "short",
                 size: String(Math.abs(amt)),
                 entryPrice: String(p.entryPrice ?? "0"),
@@ -166,7 +177,7 @@ export class AsterAdapter {
         const orders = await this._signedGet("/fapi/v1/openOrders");
         return (orders ?? []).map((o) => ({
             orderId: String(o.orderId ?? ""),
-            symbol: String(o.symbol ?? ""),
+            symbol: this._fromApi(String(o.symbol ?? "")),
             side: String(o.side).toLowerCase(),
             price: String(o.price ?? "0"),
             size: String(o.origQty ?? "0"),
@@ -178,15 +189,15 @@ export class AsterAdapter {
     async getOrderHistory(limit = 30) {
         // allOrders requires symbol — get from positions or recent trades
         const positions = await this.getPositions();
-        const symbols = new Set(positions.map(p => p.symbol));
-        if (symbols.size === 0) {
+        const apiSymbols = new Set(positions.map(p => this._toApi(p.symbol)));
+        if (apiSymbols.size === 0) {
             // Fallback: query the most common perp symbols when no open positions exist
             for (const s of ["BTCUSDT", "ETHUSDT", "SOLUSDT", "BNBUSDT", "XRPUSDT"]) {
-                symbols.add(s);
+                apiSymbols.add(s);
             }
         }
         const allOrders = [];
-        for (const sym of symbols) {
+        for (const sym of apiSymbols) {
             try {
                 const orders = await this._signedGet("/fapi/v1/allOrders", {
                     symbol: sym,
@@ -195,7 +206,7 @@ export class AsterAdapter {
                 for (const o of orders ?? []) {
                     allOrders.push({
                         orderId: String(o.orderId ?? ""),
-                        symbol: String(o.symbol ?? ""),
+                        symbol: this._fromApi(String(o.symbol ?? "")),
                         side: String(o.side).toLowerCase(),
                         price: String(o.price ?? "0"),
                         size: String(o.origQty ?? "0"),
@@ -211,11 +222,11 @@ export class AsterAdapter {
     }
     async getTradeHistory(limit = 30) {
         const positions = await this.getPositions();
-        const symbols = new Set(positions.map(p => p.symbol));
-        if (symbols.size === 0)
-            symbols.add("BTCUSDT");
+        const apiSymbols = new Set(positions.map(p => this._toApi(p.symbol)));
+        if (apiSymbols.size === 0)
+            apiSymbols.add("BTCUSDT");
         const allTrades = [];
-        for (const sym of symbols) {
+        for (const sym of apiSymbols) {
             try {
                 const trades = await this._signedGet("/fapi/v1/userTrades", {
                     symbol: sym,
@@ -224,7 +235,7 @@ export class AsterAdapter {
                 for (const t of trades ?? []) {
                     allTrades.push({
                         time: Number(t.time ?? 0),
-                        symbol: String(t.symbol ?? ""),
+                        symbol: this._fromApi(String(t.symbol ?? "")),
                         side: t.buyer ? "buy" : "sell",
                         price: String(t.price ?? "0"),
                         size: String(t.qty ?? "0"),
@@ -243,14 +254,14 @@ export class AsterAdapter {
         });
         return (data ?? []).map((f) => ({
             time: Number(f.time ?? 0),
-            symbol: String(f.symbol ?? ""),
+            symbol: this._fromApi(String(f.symbol ?? "")),
             payment: String(f.income ?? "0"),
         }));
     }
     // ── Trading ──
     async marketOrder(symbol, side, size) {
         return this._signedPost("/fapi/v1/order", {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             side: side.toUpperCase(),
             type: "MARKET",
             quantity: size,
@@ -258,7 +269,7 @@ export class AsterAdapter {
     }
     async limitOrder(symbol, side, price, size, opts) {
         const params = {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             side: side.toUpperCase(),
             type: "LIMIT",
             price,
@@ -279,7 +290,7 @@ export class AsterAdapter {
     }
     async cancelOrder(symbol, orderId) {
         return this._signedDelete("/fapi/v1/order", {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             orderId,
         });
     }
@@ -287,14 +298,14 @@ export class AsterAdapter {
         if (!symbol) {
             // Cancel all for all symbols with open orders
             const orders = await this.getOpenOrders();
-            const symbols = new Set(orders.map(o => o.symbol));
+            const apiSymbols = new Set(orders.map(o => this._toApi(o.symbol)));
             const results = [];
-            for (const sym of symbols) {
+            for (const sym of apiSymbols) {
                 results.push(await this._signedDelete("/fapi/v1/allOpenOrders", { symbol: sym }));
             }
             return results;
         }
-        return this._signedDelete("/fapi/v1/allOpenOrders", { symbol: symbol.toUpperCase() });
+        return this._signedDelete("/fapi/v1/allOpenOrders", { symbol: this._toApi(symbol) });
     }
     // ── Risk ──
     async setLeverage(symbol, leverage, marginMode) {
@@ -302,7 +313,7 @@ export class AsterAdapter {
         if (marginMode) {
             try {
                 await this._signedPost("/fapi/v1/marginType", {
-                    symbol: symbol.toUpperCase(),
+                    symbol: this._toApi(symbol),
                     marginType: marginMode === "cross" ? "CROSSED" : "ISOLATED",
                 });
             }
@@ -311,13 +322,13 @@ export class AsterAdapter {
             }
         }
         return this._signedPost("/fapi/v1/leverage", {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             leverage: String(leverage),
         });
     }
     async stopOrder(symbol, side, size, triggerPrice, opts) {
         const params = {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             side: side.toUpperCase(),
             quantity: size,
             stopPrice: triggerPrice,