minara 0.1.5 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Minara
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -18,15 +18,10 @@
 
 ## Features
 
-- **Multi-method Login** — Email verification code, Google OAuth, or Apple ID
-- **Deposit & Withdraw** — View deposit addresses across chains, withdraw to external wallets
-- **Asset Management** — View wallet balances across all supported chains
-- **AI Chat** — Stream conversations with Minara AI, with thinking and deep-research modes
-- **Spot Trading** — Cross-chain token swaps with dry-run simulation
-- **Perpetual Futures** — Deposit, withdraw, place/cancel orders, manage leverage (Hyperliquid)
-- **Limit Orders** — Create, list, and cancel price-triggered orders
-- **Copy Trading** — Follow wallet addresses with configurable bots
-- **Market Discovery** — Trending tokens, Fear & Greed Index, Bitcoin metrics
+- **AI Chat** — Crypto-native AI for on-chain analysis, market research, and DeFi due diligence. Interactive REPL & single-shot queries with `fast` / `quality` / `thinking` modes
+- **Wallet & Balance** — Unified balance view, spot holdings with PnL, perps account overview, deposits and withdrawals
+- **Chain-Abstracted Trading** — Cross-chain swaps with automatic chain detection, perpetual futures, and limit orders. Accepts `$TICKER`, token name, or contract address
+- **Market Discovery** — Trending tokens, Fear & Greed Index, on-chain metrics, and token / stock search
 
 ## Installation
 
@@ -54,11 +49,14 @@ minara account
 # View deposit addresses
 minara deposit
 
-# Chat with Minara AI
+# Chat with Minara AI (interactive REPL)
+minara chat
+
+# Or send a single question
 minara chat "What's the best DeFi yield right now?"
 
-# Swap tokens
-minara swap
+# Swap tokens (chain auto-detected from token)
+minara swap -t '$BONK' -s buy -a 100
 
 # View trending tokens
 minara discover trending
@@ -68,10 +66,10 @@ minara discover trending
 
 ### Auth & Account
 
-| Command | Description |
-|---------|-------------|
-| `minara login` | Login via email, Google, or Apple ID |
-| `minara logout` | Logout and clear local credentials |
+| Command          | Description                                 |
+| ---------------- | ------------------------------------------- |
+| `minara login`   | Login via email, Google, or Apple ID        |
+| `minara logout`  | Logout and clear local credentials          |
 | `minara account` | View your account info and wallet addresses |
 
 ```bash
@@ -83,43 +81,57 @@ minara login --apple          # Apple ID (opens browser)
 
 ### Wallet & Funds
 
-| Command | Description |
-|---------|-------------|
-| `minara assets` | View wallet balances across all chains |
-| `minara deposit` | Show deposit addresses and supported networks |
-| `minara withdraw` | Withdraw tokens to an external wallet |
+| Command               | Description                                     |
+| --------------------- | ----------------------------------------------- |
+| `minara balance`      | Combined USDC/USDT balance across spot and perps |
+| `minara assets`       | Full overview: spot holdings + perps account     |
+| `minara assets spot`  | Spot wallet: portfolio value, cost, PnL, holdings |
+| `minara assets perps` | Perps account: equity, margin, positions         |
+| `minara deposit`      | Deposit to spot (view addresses) or perps (direct / from spot) |
+| `minara withdraw`     | Withdraw tokens to an external wallet            |
 
 ```bash
-minara deposit
-minara withdraw -c solana -t <token> -a 10 --to <address>
-minara withdraw   # Interactive mode
+minara balance                    # Quick total: Spot + Perps available balance
+minara assets                     # Full overview (spot + perps)
+minara assets spot                # Spot wallet with PnL breakdown
+minara assets perps               # Perps equity, margin, positions
+minara deposit                    # Interactive: Spot (addresses) or Perps (address / transfer)
+minara deposit spot               # Show spot wallet deposit addresses (EVM + Solana)
+minara deposit perps              # Perps: show Arbitrum deposit address, or transfer from Spot → Perps
+minara withdraw -c solana -t '$SOL' -a 10 --to <address>
+minara withdraw                   # Interactive mode (accepts ticker or address)
 ```
 
 ### Spot Trading
 
-| Command | Description |
-|---------|-------------|
-| `minara swap` | Swap tokens (cross-chain) |
+| Command           | Description                        |
+| ----------------- | ---------------------------------- |
+| `minara swap`     | Swap tokens (chain auto-detected)  |
 | `minara transfer` | Transfer tokens to another address |
 
 ```bash
-minara swap                        # Interactive
-minara swap -c solana -s buy -t <token> -a 100
+minara swap                        # Interactive: side → token → amount
+minara swap -s buy -t '$BONK' -a 100              # Buy by ticker (chain auto-detected)
+minara swap -s sell -t '$NVDAx' -a all             # Sell entire balance
 minara swap --dry-run              # Simulate without executing
 ```
 
+> **Chain abstraction:** The chain is automatically detected from the token. If a token exists on multiple chains (e.g. USDC), you'll be prompted to pick one, sorted by gas cost (lowest first). Sell mode supports `all` to sell full balance, and caps amounts exceeding your balance.
+>
+> **Token input:** All token fields (`-t`) accept a `$TICKER` (e.g. `$BONK`), a token name, or a contract address.
+
 ### Perpetual Futures
 
-| Command | Description |
-|---------|-------------|
-| `minara perps deposit` | Deposit USDC to Hyperliquid perps account |
-| `minara perps withdraw` | Withdraw USDC from perps account |
-| `minara perps positions` | View all open positions |
-| `minara perps order` | Place an order (interactive builder) |
-| `minara perps cancel` | Cancel open orders |
-| `minara perps leverage` | Update leverage for a symbol |
-| `minara perps trades` | View completed trade history |
-| `minara perps fund-records` | View fund deposit/withdrawal records |
+| Command                     | Description                               |
+| --------------------------- | ----------------------------------------- |
+| `minara perps deposit`      | Deposit USDC to perps (or use `minara deposit perps`) |
+| `minara perps withdraw`     | Withdraw USDC from perps account          |
+| `minara perps positions`    | View all open positions                   |
+| `minara perps order`        | Place an order (interactive builder)      |
+| `minara perps cancel`       | Cancel open orders                        |
+| `minara perps leverage`     | Update leverage for a symbol              |
+| `minara perps trades`       | View completed trade history              |
+| `minara perps fund-records` | View fund deposit/withdrawal records      |
 
 ```bash
 minara perps deposit -a 100        # Deposit 100 USDC to perps
@@ -131,11 +143,11 @@ minara perps leverage              # Interactive: set leverage for a trading pai
 
 ### Limit Orders
 
-| Command | Description |
-|---------|-------------|
-| `minara limit-order create` | Create a price-triggered limit order |
-| `minara limit-order list` | List all your limit orders |
-| `minara limit-order cancel <id>` | Cancel a specific order by ID |
+| Command                          | Description                          |
+| -------------------------------- | ------------------------------------ |
+| `minara limit-order create`      | Create a price-triggered limit order |
+| `minara limit-order list`        | List all your limit orders           |
+| `minara limit-order cancel <id>` | Cancel a specific order by ID        |
 
 ```bash
 minara limit-order create          # Interactive: token, price, side, amount, expiry
@@ -143,48 +155,54 @@ minara limit-order list            # Show all orders with status
 minara limit-order cancel abc123   # Cancel order by ID
 ```
 
-### Copy Trading
-
-| Command | Description |
-|---------|-------------|
-| `minara copy-trade create` | Create a new copy-trade bot |
-| `minara copy-trade list` | List all copy-trade bots |
-| `minara copy-trade start <id>` | Start a paused bot |
-| `minara copy-trade stop <id>` | Pause a running bot |
-| `minara copy-trade delete <id>` | Delete a bot permanently |
-
-```bash
-minara copy-trade create           # Interactive: target wallet, chain, amount, options
-minara copy-trade list             # Show all bots with status
-minara copy-trade start abc123     # Resume a paused bot
-minara copy-trade stop abc123      # Pause a running bot
-```
-
 ### AI Chat
 
-| Command | Description |
-|---------|-------------|
-| `minara chat [message]` | Send a message (or enter interactive mode) |
-| `minara chat --list` | List all your conversations |
-| `minara chat --history <chatId>` | View messages in a conversation |
+| Command                          | Description                                   |
+| -------------------------------- | --------------------------------------------- |
+| `minara chat`                    | Enter interactive REPL (Python/Node.js-style) |
+| `minara chat [message]`          | Send a single message and exit                |
+| `minara chat --list`             | List all your conversations                   |
+| `minara chat --history <chatId>` | View messages in a conversation               |
+| `minara chat -c <chatId>`        | Continue an existing conversation             |
 
 ```bash
-minara chat "What is the current BTC price?"   # Single question, streamed answer
 minara chat                                    # Enter interactive REPL mode
+minara chat "What is the current BTC price?"   # Single question, streamed answer
+minara chat --quality "Analyze ETH outlook"     # Quality mode (default: fast)
 minara chat --thinking "Analyze ETH outlook"   # Enable reasoning mode
-minara chat --deep-research "DeFi yield trends"# Deep research mode
+minara chat -c <chatId>                        # Continue a specific chat in REPL
 minara chat --list                             # List past conversations
 minara chat --history <chatId>                 # Replay a specific conversation
 ```
 
+**Interactive REPL mode** — When launched without a message argument, the chat enters an interactive session:
+
+```
+Minara AI Chat session:a1b2c3d4
+──────────────────────────────────────────────────
+Type a message to chat. /help for commands, Ctrl+C to exit.
+
+>>> What's the price of BTC?
+Minara: Bitcoin is currently trading at $95,432...
+
+>>> /help
+
+  Commands:
+  /new        Start a new conversation
+  /continue   Continue an existing conversation
+  /list       List all historical chats
+  /id         Show current chat ID
+  exit        Quit the chat
+```
+
 ### Market Discovery
 
-| Command | Description |
-|---------|-------------|
-| `minara discover trending` | View currently trending tokens |
-| `minara discover search <keyword>` | Search for tokens or stocks by name |
-| `minara discover fear-greed` | View the crypto Fear & Greed Index |
-| `minara discover btc-metrics` | View Bitcoin on-chain and market metrics |
+| Command                            | Description                              |
+| ---------------------------------- | ---------------------------------------- |
+| `minara discover trending`         | View currently trending tokens           |
+| `minara discover search <keyword>` | Search for tokens or stocks by name      |
+| `minara discover fear-greed`       | View the crypto Fear & Greed Index       |
+| `minara discover btc-metrics`      | View Bitcoin on-chain and market metrics |
 
 ```bash
 minara discover trending           # Top trending tokens right now
@@ -193,11 +211,89 @@ minara discover fear-greed         # Current market sentiment index
 minara discover btc-metrics        # Bitcoin hashrate, supply, dominance, etc.
 ```
 
+### Premium & Subscription
+
+| Command                      | Description                                     |
+| ---------------------------- | ----------------------------------------------- |
+| `minara premium plans`       | View all subscription plans and credit packages |
+| `minara premium status`      | View your current subscription status           |
+| `minara premium subscribe`   | Subscribe or change plan (upgrade / downgrade)  |
+| `minara premium buy-credits` | Buy a one-time credit package                   |
+| `minara premium cancel`      | Cancel your current subscription                |
+
+```bash
+minara premium plans              # Compare Free, Lite, Starter, Pro, Partner plans
+minara premium status             # Check your current plan and billing info
+minara premium subscribe          # Interactive: select plan → Stripe or Crypto payment
+minara premium buy-credits        # Buy additional credits (one-time purchase)
+minara premium cancel             # Cancel subscription (keeps access until period ends)
+```
+
+### Output Format
+
+By default, all commands display data using formatted tables, colored text, and human-friendly numbers (e.g. `$1.23M`, `+3.46%`). To get raw JSON output for scripting or piping, add the `--json` flag to any command:
+
+```bash
+minara discover trending --json    # Raw JSON array of trending tokens
+minara discover btc-metrics --json # Full BTC metrics with OHLCV data
+minara assets spot --json          # Raw JSON asset list
+```
+
 ### Configuration
 
-| Command | Description |
-|---------|-------------|
-| `minara config` | View or update CLI settings (e.g. API base URL) |
+| Command         | Description                                                            |
+| --------------- | ---------------------------------------------------------------------- |
+| `minara config` | View or update CLI settings (base URL, Touch ID, transaction confirm…) |
+
+```bash
+minara config                     # Interactive settings menu
+```
+
+Available settings:
+
+| Setting                  | Default | Description                                          |
+| ------------------------ | ------- | ---------------------------------------------------- |
+| Base URL                 | —       | API endpoint                                         |
+| Touch ID                 | Off     | Biometric verification for fund operations (macOS)   |
+| Transaction Confirmation | **On**  | Mandatory second confirmation before fund operations |
+
+### Transaction Safety
+
+All fund-related operations go through a multi-layer safety flow:
+
+```
+1. First confirmation      (skippable with -y flag)
+2. Transaction confirmation (mandatory — configurable in minara config)
+3. Touch ID verification   (optional — macOS only)
+4. Execute
+```
+
+The **transaction confirmation** shows chain, token, address, side, amount, and operation details before asking for final approval:
+
+```
+⚠ Transaction confirmation
+  Chain    : solana
+  Token    : $BONK — Bonk
+  Address  : DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
+  Side     : BUY
+  Amount   : 100 USD
+  Action   : BUY swap · 100 USD · solana
+? Are you sure you want to proceed? (y/N)
+```
+
+This step is independent of the `-y` flag and Touch ID — it serves as an extra safety net. Disable it via `minara config` if not needed.
+
+### Touch ID (macOS)
+
+Minara CLI supports macOS Touch ID to protect all fund-related operations. When enabled, transfers, withdrawals, swaps, orders, and other financial actions require fingerprint verification before execution.
+
+```bash
+minara config                     # Select "Touch ID" to enable / disable
+```
+
+**Protected operations:** `withdraw`, `transfer`, `swap`, `deposit` (Spot→Perps transfer), `perps deposit`, `perps withdraw`, `perps order`, `limit-order create`
+
+> **Note:** Touch ID requires macOS with Touch ID hardware. The `--yes` flag skips the initial confirmation prompt but does **not** bypass transaction confirmation or Touch ID.
 
 ## Supported Chains
 
@@ -235,6 +331,9 @@ npm run test:coverage   # With coverage report
 
 ## Security
 
+- **Transaction Confirmation** — Mandatory second confirmation before all fund operations, showing full token details and contract addresses (default: enabled, configurable)
+- **Touch ID** — Optional biometric protection for all fund operations (macOS only). A native Swift helper binary is compiled on first use and cached in `~/.minara/`
+- **Token Verification** — Token ticker, name, and full contract address are always displayed before any transaction to prevent wrong-token mistakes
 - Credentials are stored in `~/.minara/credentials.json` with `0600` file permissions
 - The `~/.minara/` directory is created with `0700` permissions
 - Tokens are never logged or printed to the console

package/dist/api/payment.d.ts

@@ -0,0 +1,17 @@
+import type { PlansResponse, CheckoutSession, CryptoCheckout } from '../types.js';
+/** Get all subscription plans and credit packages */
+export declare function getPlans(): Promise<import("../types.js").ApiResponse<PlansResponse>>;
+/** Create a Stripe checkout session for a subscription plan */
+export declare function checkoutPlan(token: string, planId: string, successUrl: string, cancelUrl: string): Promise<import("../types.js").ApiResponse<CheckoutSession>>;
+/** Create a crypto checkout for a subscription plan */
+export declare function cryptoCheckoutPlan(token: string, planId: string): Promise<import("../types.js").ApiResponse<CryptoCheckout>>;
+/** Get crypto checkout pay amount for a plan */
+export declare function getCryptoPayAmount(token: string, planId: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+/** Simulate crypto checkout for a plan */
+export declare function simulateCryptoCheckout(token: string, planId: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+/** Create a Stripe checkout session for a credit package */
+export declare function checkoutPackage(token: string, packageId: string, successUrl: string, cancelUrl: string): Promise<import("../types.js").ApiResponse<CheckoutSession>>;
+/** Create a crypto checkout for a credit package */
+export declare function cryptoCheckoutPackage(token: string, packageId: string): Promise<import("../types.js").ApiResponse<CryptoCheckout>>;
+/** Cancel current subscription */
+export declare function cancelSubscription(token: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;

package/dist/api/payment.js

@@ -0,0 +1,39 @@
+import { get, del } from './client.js';
+/** Get all subscription plans and credit packages */
+export function getPlans() {
+    return get('/payment/plans');
+}
+/** Create a Stripe checkout session for a subscription plan */
+export function checkoutPlan(token, planId, successUrl, cancelUrl) {
+    return get(`/payment/plans/${planId}/checkout`, {
+        token,
+        query: { successUrl, cancelUrl },
+    });
+}
+/** Create a crypto checkout for a subscription plan */
+export function cryptoCheckoutPlan(token, planId) {
+    return get(`/payment/plans/${planId}/crypto-checkout`, { token });
+}
+/** Get crypto checkout pay amount for a plan */
+export function getCryptoPayAmount(token, planId) {
+    return get(`/payment/plans/${planId}/crypto-checkout/payAmount`, { token });
+}
+/** Simulate crypto checkout for a plan */
+export function simulateCryptoCheckout(token, planId) {
+    return get(`/payment/plans/${planId}/crypto-checkout/simulate`, { token });
+}
+/** Create a Stripe checkout session for a credit package */
+export function checkoutPackage(token, packageId, successUrl, cancelUrl) {
+    return get(`/payment/packages/${packageId}/checkout`, {
+        token,
+        query: { successUrl, cancelUrl },
+    });
+}
+/** Create a crypto checkout for a credit package */
+export function cryptoCheckoutPackage(token, packageId) {
+    return get(`/payment/packages/${packageId}/crypto-checkout`, { token });
+}
+/** Cancel current subscription */
+export function cancelSubscription(token) {
+    return del('/payment/subscription', { token });
+}

package/dist/api/perps.d.ts

@@ -21,6 +21,8 @@ export declare function getTokenPrices(token: string): Promise<import("../types.
 export declare function getFundRecords(token: string, page: number, limit: number): Promise<import("../types.js").ApiResponse<Record<string, unknown>[]>>;
 /** Get equity history chart */
 export declare function getEquityHistory(token: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+/** Get perps account summary (balance, equity, positions, PnL) */
+export declare function getAccountSummary(token: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
 /** Get all decisions */
 export declare function getDecisions(token: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>[]>>;
 /** Claim rewards */

package/dist/api/perps.js

@@ -43,6 +43,10 @@ export function getFundRecords(token, page, limit) {
 export function getEquityHistory(token) {
     return get('/v1/tx/perps/equity-history-chart/all', { token });
 }
+/** Get perps account summary (balance, equity, positions, PnL) */
+export function getAccountSummary(token) {
+    return get('/v1/fully-managed/account-summary', { token });
+}
 /** Get all decisions */
 export function getDecisions(token) {
     return get('/v1/tx/perps/decisions/all', { token });

package/dist/api/tokens.d.ts

@@ -19,3 +19,7 @@ export declare function getEvents(page: string, pageSize: string, version: strin
 export declare function getFearGreedIndex(): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
 /** Get bitcoin metrics */
 export declare function getBitcoinMetrics(): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+/** Get ethereum metrics */
+export declare function getEthereumMetrics(): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+/** Get solana metrics */
+export declare function getSolanaMetrics(): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;

package/dist/api/tokens.js

@@ -39,3 +39,11 @@ export function getFearGreedIndex() {
 export function getBitcoinMetrics() {
     return get('/discover/bitcoin-metrics');
 }
+/** Get ethereum metrics */
+export function getEthereumMetrics() {
+    return get('/discover/ethereum-metrics');
+}
+/** Get solana metrics */
+export function getSolanaMetrics() {
+    return get('/discover/solana-metrics');
+}

package/dist/commands/assets.js

@@ -1,22 +1,126 @@
 import { Command } from 'commander';
 import chalk from 'chalk';
-import { getAssets } from '../api/crosschain.js';
+import * as perpsApi from '../api/perps.js';
+import { get } from '../api/client.js';
 import { requireAuth } from '../config.js';
-import { spinner, unwrapApi, wrapAction } from '../utils.js';
-export const assetsCommand = new Command('assets')
-    .description('View your wallet assets across chains')
+import { spinner, wrapAction } from '../utils.js';
+import { printTable, SPOT_COLUMNS, POSITION_COLUMNS } from '../formatters.js';
+// ─── spot ────────────────────────────────────────────────────────────────
+const spotCmd = new Command('spot')
+    .description('View spot wallet assets across chains')
+    .action(wrapAction(async () => {
+    const creds = requireAuth();
+    await showSpotAssets(creds.accessToken);
+}));
+const MIN_DISPLAY_VALUE = 0.01;
+async function showSpotAssets(token) {
+    const spin = spinner('Fetching spot assets…');
+    const res = await get('/users/pnls/all', { token });
+    spin.stop();
+    if (!res.success || !res.data) {
+        console.log('');
+        console.log(chalk.bold('Spot Wallet Assets:'));
+        console.log(chalk.dim('  Could not fetch spot assets.'));
+        if (res.error?.message)
+            console.log(chalk.dim(`  ${res.error.message}`));
+        console.log('');
+        return;
+    }
+    const all = res.data;
+    const holdings = [];
+    let totalValue = 0;
+    let totalRealizedPnl = 0;
+    let totalUnrealizedPnl = 0;
+    let hasUnrealizedPnl = false;
+    for (const t of all) {
+        const bal = Number(t.balance ?? 0);
+        const price = Number(t.marketPrice ?? 0);
+        const apiVal = Number(t.portfolioValue ?? 0);
+        const value = apiVal > 0 ? apiVal : bal * price;
+        const uPnl = Number(t.unrealizedPnl ?? 0);
+        const rPnl = Number(t.realizedPnl ?? 0);
+        totalValue += value;
+        totalRealizedPnl += rPnl;
+        if (uPnl !== 0) {
+            totalUnrealizedPnl += uPnl;
+            hasUnrealizedPnl = true;
+        }
+        if (bal > 0 && value >= MIN_DISPLAY_VALUE) {
+            holdings.push({ ...t, _value: value });
+        }
+    }
+    const fmt = (n) => `$${n.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+    const pnlFmt = (n) => {
+        if (n === 0)
+            return chalk.dim('$0.00');
+        const color = n >= 0 ? chalk.green : chalk.red;
+        return color(`${n >= 0 ? '+' : ''}${fmt(n)}`);
+    };
+    console.log('');
+    console.log(chalk.bold('Spot Wallet:'));
+    console.log(`  Portfolio Value : ${fmt(totalValue)}`);
+    console.log(`  Unrealized PnL  : ${pnlFmt(totalUnrealizedPnl)}`);
+    console.log(`  Realized PnL    : ${pnlFmt(totalRealizedPnl)}`);
+    console.log('');
+    console.log(chalk.bold(`Holdings (${holdings.length}):`));
+    if (holdings.length === 0) {
+        console.log(chalk.dim('  No spot assets with balance.'));
+    }
+    else {
+        printTable(holdings, SPOT_COLUMNS);
+    }
+    console.log('');
+}
+// ─── perps ───────────────────────────────────────────────────────────────
+const perpsCmd = new Command('perps')
+    .description('View perps account balance and positions')
     .action(wrapAction(async () => {
     const creds = requireAuth();
-    const spin = spinner('Fetching assets…');
-    const res = await getAssets(creds.accessToken);
+    await showPerpsAssets(creds.accessToken);
+}));
+async function showPerpsAssets(token) {
+    const spin = spinner('Fetching perps account…');
+    const res = await perpsApi.getAccountSummary(token);
     spin.stop();
-    const data = unwrapApi(res, 'Failed to fetch assets');
-    if (Array.isArray(data) && data.length === 0) {
-        console.log(chalk.dim('No assets found.'));
+    if (!res.success || !res.data) {
+        console.log(chalk.dim('  Could not fetch perps account.'));
+        if (res.error?.message)
+            console.log(chalk.dim(`  ${res.error.message}`));
         return;
     }
+    const d = res.data;
+    const fmt = (n) => `$${n.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+    const pnlFmt = (n) => {
+        const color = n >= 0 ? chalk.green : chalk.red;
+        return color(`${n >= 0 ? '+' : ''}${fmt(n)}`);
+    };
+    // ── Account overview ───────────────────────────────────────────────
+    console.log('');
+    console.log(chalk.bold('Perps Account:'));
+    console.log(`  Equity        : ${fmt(Number(d.equityValue ?? 0))}`);
+    console.log(`  Available     : ${fmt(Number(d.dispatchableValue ?? 0))}`);
+    console.log(`  Margin Used   : ${fmt(Number(d.totalMarginUsed ?? 0))}`);
+    console.log(`  Unrealized PnL: ${pnlFmt(Number(d.totalUnrealizedPnl ?? 0))}`);
+    console.log(`  Withdrawable  : ${fmt(Number(d.withdrawableValue ?? 0))}`);
+    // ── Positions ───────────────────────────────────────────────────────
+    const positions = Array.isArray(d.positions) ? d.positions : [];
     console.log('');
-    console.log(chalk.bold('Your Assets:'));
-    console.log(JSON.stringify(data, null, 2));
+    console.log(chalk.bold(`Open Positions (${positions.length}):`));
+    if (positions.length === 0) {
+        console.log(chalk.dim('  No open positions.'));
+    }
+    else {
+        printTable(positions, POSITION_COLUMNS);
+    }
     console.log('');
+}
+// ─── parent ──────────────────────────────────────────────────────────────
+export const assetsCommand = new Command('assets')
+    .description('View your wallet assets (spot & perps)')
+    .addCommand(spotCmd)
+    .addCommand(perpsCmd)
+    .action(wrapAction(async () => {
+    const creds = requireAuth();
+    await showSpotAssets(creds.accessToken);
+    await showPerpsAssets(creds.accessToken);
 }));

package/dist/commands/balance.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const balanceCommand: Command;

package/dist/commands/balance.js

@@ -0,0 +1,43 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { get } from '../api/client.js';
+import * as perpsApi from '../api/perps.js';
+import { requireAuth } from '../config.js';
+import { spinner, wrapAction } from '../utils.js';
+const STABLES = new Set(['usdc', 'usdt']);
+export const balanceCommand = new Command('balance')
+    .description('Show combined USDC / USDT balance across spot and perps')
+    .action(wrapAction(async () => {
+    const creds = requireAuth();
+    const spin = spinner('Fetching balances…');
+    const [spotRes, perpsRes] = await Promise.all([
+        get('/users/pnls/all', { token: creds.accessToken }),
+        perpsApi.getAccountSummary(creds.accessToken),
+    ]);
+    spin.stop();
+    const fmt = (n) => `$${n.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+    let spotStable = 0;
+    if (spotRes.success && Array.isArray(spotRes.data)) {
+        for (const t of spotRes.data) {
+            const sym = String(t.tokenSymbol ?? '').toLowerCase();
+            if (STABLES.has(sym)) {
+                const bal = Number(t.balance ?? 0);
+                const price = Number(t.marketPrice ?? 1);
+                spotStable += bal * price;
+            }
+        }
+    }
+    let perpsAvailable = 0;
+    if (perpsRes.success && perpsRes.data) {
+        const d = perpsRes.data;
+        perpsAvailable = Number(d.dispatchableValue ?? 0);
+    }
+    const total = spotStable + perpsAvailable;
+    console.log('');
+    console.log(chalk.bold('Balance:'));
+    console.log(`  Spot  (USDC/USDT) : ${fmt(spotStable)}`);
+    console.log(`  Perps (available) : ${fmt(perpsAvailable)}`);
+    console.log(`  ${'─'.repeat(30)}`);
+    console.log(`  Total             : ${chalk.bold(fmt(total))}`);
+    console.log('');
+}));