openbroker 1.0.55 → 1.0.57

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 All notable changes to Open Broker will be documented in this file.
 
+## [1.0.57] - 2026-03-10
+
+### Fixed
+- **Unified Account $0 Equity**: Made account mode detection more robust — handles wrapped API responses, case-insensitive matching. Added debug logging for spot balance lookup to diagnose edge cases. Plugin `ob_account` now returns `accountMode` field.
+
+### Added
+- **`--json` Flag**: Info commands now support `--json` for machine-readable output
+  - `account --json` — full account state as JSON
+  - `positions --json` — positions array with mark prices and liquidation distances
+  - `funding --json` — funding rate data
+  - `fills --json` — trade fill history
+  - `orders --json` — order history
+  - `markets --json` — market data
+
+## [1.0.56] - 2026-03-10
+
+### Added
+- **Unified Account Support**: Detects and handles Hyperliquid's account abstraction modes (standard, unified, portfolio margin, dex abstraction)
+  - `getAccountMode()` / `isUnifiedAccount()` — queries `userAbstraction` API to detect mode
+  - **Unified accounts**: equity comes from `spotClearinghouseState` (single USDC balance shared across all dexes); skips `sendAsset` transfers for HIP-3 trading
+  - **Standard accounts**: keeps existing behavior (per-dex margin aggregation + USDC transfers)
+  - `account` command now displays the account abstraction mode
+- Prepares for deprecation of DEX abstraction mode per Hyperliquid docs
+
 ## [1.0.55] - 2026-03-09
 
 ### Added

package/SKILL.md

@@ -4,7 +4,7 @@ description: Hyperliquid trading plugin with background position monitoring. Exe
 license: MIT
 compatibility: Requires Node.js 22+, network access to api.hyperliquid.xyz
 homepage: https://www.npmjs.com/package/openbroker
-metadata: {"author": "monemetrics", "version": "1.0.55", "openclaw": {"requires": {"bins": ["openbroker"], "env": ["HYPERLIQUID_PRIVATE_KEY"]}, "primaryEnv": "HYPERLIQUID_PRIVATE_KEY", "install": [{"id": "node", "kind": "node", "package": "openbroker", "bins": ["openbroker"], "label": "Install openbroker (npm)"}]}}
+metadata: {"author": "monemetrics", "version": "1.0.57", "openclaw": {"requires": {"bins": ["openbroker"], "env": ["HYPERLIQUID_PRIVATE_KEY"]}, "primaryEnv": "HYPERLIQUID_PRIVATE_KEY", "install": [{"id": "node", "kind": "node", "package": "openbroker", "bins": ["openbroker"], "label": "Install openbroker (npm)"}]}}
 allowed-tools: ob_account ob_positions ob_funding ob_markets ob_search ob_spot ob_fills ob_orders ob_order_status ob_fees ob_candles ob_funding_history ob_trades ob_rate_limit ob_funding_scan ob_buy ob_sell ob_limit ob_trigger ob_tpsl ob_cancel ob_twap ob_bracket ob_chase ob_watcher_status Bash(openbroker:*)
 ---
 

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openbroker",
   "name": "OpenBroker — Hyperliquid Trading",
-  "version": "1.0.55",
+  "version": "1.0.57",
   "description": "Trade on Hyperliquid DEX with background position monitoring",
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openbroker",
-  "version": "1.0.55",
+  "version": "1.0.57",
   "description": "Hyperliquid trading CLI - execute orders, manage positions, and run trading strategies",
   "type": "module",
   "bin": {

package/scripts/core/client.ts

@@ -35,6 +35,8 @@ export class HyperliquidClient {
   private hip3IsolatedSet: Set<string> = new Set();
   /** Cached maxLeverage for HIP-3 assets */
   private hip3MaxLeverageMap: Map<string, number> = new Map();
+  /** Cached account abstraction mode: 'standard' | 'unified' | 'portfolio' | 'dexAbstraction' */
+  private accountMode: string | null = null;
   public verbose: boolean = false;
 
   constructor(config?: OpenBrokerConfig) {
@@ -631,6 +633,60 @@ export class HyperliquidClient {
 
   // ============ Account Info ============
 
+  /**
+   * Get the account's abstraction mode.
+   * Returns: 'standard' | 'unified' | 'portfolio' | 'dexAbstraction'
+   * Unified accounts have a single USDC balance shared across all dexes.
+   * Standard accounts have separate balances per dex (need sendAsset transfers).
+   */
+  async getAccountMode(user?: string): Promise<string> {
+    if (this.accountMode) return this.accountMode;
+
+    const baseUrl = isMainnet()
+      ? 'https://api.hyperliquid.xyz'
+      : 'https://api.hyperliquid-testnet.xyz';
+
+    try {
+      const response = await fetch(baseUrl + '/info', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          type: 'userAbstraction',
+          user: user ?? this.address,
+        }),
+      });
+      const data = await response.json();
+      this.log('userAbstraction response:', JSON.stringify(data));
+
+      // API may return a bare string or an object. Normalize to string for matching.
+      const mode = typeof data === 'string' ? data : (data?.abstraction ?? data?.mode ?? String(data));
+      const modeLower = mode.toLowerCase();
+
+      if (modeLower.includes('unified')) {
+        this.accountMode = 'unified';
+      } else if (modeLower.includes('portfolio')) {
+        this.accountMode = 'portfolio';
+      } else if (modeLower.includes('dex')) {
+        this.accountMode = 'dexAbstraction';
+      } else {
+        // "default" or "disabled" both mean standard mode
+        this.accountMode = 'standard';
+      }
+    } catch (err) {
+      this.log('Failed to fetch account abstraction mode:', err instanceof Error ? err.message : String(err));
+      this.accountMode = 'standard'; // Safe fallback
+    }
+
+    this.log('Account mode:', this.accountMode);
+    return this.accountMode;
+  }
+
+  /** Whether the account uses unified balances (unified or portfolio margin) */
+  async isUnifiedAccount(user?: string): Promise<boolean> {
+    const mode = await this.getAccountMode(user);
+    return mode === 'unified' || mode === 'portfolio';
+  }
+
   /**
    * Check if an address has sub-accounts (is a master account)
    * Sub-accounts cannot approve builder fees - only master accounts can
@@ -1075,14 +1131,17 @@ export class HyperliquidClient {
 
   /**
    * Get user state across all dexes (main + HIP-3).
-   * Merges HIP-3 positions into assetPositions and aggregates margin summaries.
+   * For unified accounts: equity comes from spotClearinghouseState (single USDC balance).
+   * For standard accounts: aggregates margin summaries from each dex.
    */
   async getUserStateAll(user?: string): Promise<ClearinghouseState> {
     await this.getMetaAndAssetCtxs(); // Ensure HIP-3 dex list is loaded
 
+    const unified = await this.isUnifiedAccount(user);
     const mainState = await this.getUserState(user);
     const dexs = await this.getPerpDexs();
 
+    // Collect positions from all HIP-3 dexes
     for (let i = 1; i < dexs.length; i++) {
       const dex = dexs[i];
       if (!dex) continue;
@@ -1093,24 +1152,70 @@ export class HyperliquidClient {
           mainState.assetPositions.push(...dexState.assetPositions);
         }
 
-        // Aggregate margin summaries from HIP-3 dexes
-        const dexMargin = dexState.marginSummary;
-        if (dexMargin) {
-          const addToSummary = (summary: { accountValue: string; totalNtlPos: string; totalRawUsd: string; totalMarginUsed: string; withdrawable: string }) => {
-            summary.accountValue = String(parseFloat(summary.accountValue) + parseFloat(dexMargin.accountValue));
-            summary.totalNtlPos = String(parseFloat(summary.totalNtlPos) + parseFloat(dexMargin.totalNtlPos));
-            summary.totalRawUsd = String(parseFloat(summary.totalRawUsd) + parseFloat(dexMargin.totalRawUsd));
-            summary.totalMarginUsed = String(parseFloat(summary.totalMarginUsed) + parseFloat(dexMargin.totalMarginUsed));
-            summary.withdrawable = String(parseFloat(summary.withdrawable) + parseFloat(dexMargin.withdrawable));
-          };
-          addToSummary(mainState.marginSummary);
-          addToSummary(mainState.crossMarginSummary);
+        // For standard accounts, aggregate margin from each dex
+        if (!unified) {
+          const dexMargin = dexState.marginSummary;
+          if (dexMargin) {
+            const addToSummary = (summary: { accountValue: string; totalNtlPos: string; totalRawUsd: string; totalMarginUsed: string; withdrawable: string }) => {
+              summary.accountValue = String(parseFloat(summary.accountValue) + parseFloat(dexMargin.accountValue));
+              summary.totalNtlPos = String(parseFloat(summary.totalNtlPos) + parseFloat(dexMargin.totalNtlPos));
+              summary.totalRawUsd = String(parseFloat(summary.totalRawUsd) + parseFloat(dexMargin.totalRawUsd));
+              summary.totalMarginUsed = String(parseFloat(summary.totalMarginUsed) + parseFloat(dexMargin.totalMarginUsed));
+              summary.withdrawable = String(parseFloat(summary.withdrawable) + parseFloat(dexMargin.withdrawable));
+            };
+            addToSummary(mainState.marginSummary);
+            addToSummary(mainState.crossMarginSummary);
+          }
         }
       } catch (err) {
         this.log(`Failed to fetch state for dex ${dex.name}:`, err instanceof Error ? err.message : String(err));
       }
     }
 
+    // For unified accounts: equity is the USDC balance from spot clearinghouse
+    if (unified) {
+      try {
+        const spotState = await this.getSpotBalances(user);
+        this.log('Unified spot balances:', JSON.stringify(spotState));
+
+        // Find USDC balance (case-insensitive, handles variations)
+        const balances = spotState?.balances ?? [];
+        const usdcBalance = balances.find(b => b.coin?.toUpperCase() === 'USDC');
+
+        if (usdcBalance) {
+          const totalUsdc = usdcBalance.total;
+          const holdUsdc = usdcBalance.hold;
+          const withdrawable = String(parseFloat(totalUsdc) - parseFloat(holdUsdc));
+
+          // Compute total margin used and notional from all positions
+          let totalMarginUsed = 0;
+          let totalNtlPos = 0;
+          for (const ap of mainState.assetPositions) {
+            const pos = ap.position;
+            if (parseFloat(pos.szi) === 0) continue;
+            totalMarginUsed += parseFloat(pos.marginUsed);
+            totalNtlPos += Math.abs(parseFloat(pos.positionValue));
+          }
+
+          const summary = {
+            accountValue: totalUsdc,
+            totalNtlPos: String(totalNtlPos),
+            totalRawUsd: totalUsdc,
+            totalMarginUsed: String(totalMarginUsed),
+            withdrawable,
+          };
+          mainState.marginSummary = summary;
+          mainState.crossMarginSummary = { ...summary };
+
+          this.log(`Unified account: USDC balance $${parseFloat(totalUsdc).toFixed(2)}, margin used $${totalMarginUsed.toFixed(2)}`);
+        } else {
+          this.log('Unified account: no USDC balance found in spot state. Balances:', balances.map(b => b.coin));
+        }
+      } catch (err) {
+        this.log('Failed to fetch spot balances for unified account:', err instanceof Error ? err.message : String(err));
+      }
+    }
+
     return mainState;
   }
 
@@ -1123,9 +1228,10 @@ export class HyperliquidClient {
   // ============ Trading ============
 
   /**
-   * HIP-3 perps have independent margin per dex. Before ordering:
+   * HIP-3 perps: prepare for trading.
    * 1. Set isolated margin mode (required for HIP-3)
-   * 2. Transfer USDC from main perp to the HIP-3 dex (each dex has its own balance)
+   * 2. For standard accounts only: transfer USDC from main perp to HIP-3 dex
+   *    (unified accounts share USDC across all dexes automatically)
    */
   private async ensureHip3Ready(coin: string, notional: number, leverage?: number): Promise<void> {
     if (!this.isHip3(coin)) return;
@@ -1148,12 +1254,19 @@ export class HyperliquidClient {
       }
     }
 
-    // Transfer USDC to the HIP-3 dex to cover margin
+    // Unified accounts share USDC across all dexes — no transfer needed
+    const unified = await this.isUnifiedAccount();
+    if (unified) {
+      this.log(`Unified account — skipping USDC transfer for ${coin} (shared balance)`);
+      return;
+    }
+
+    // Standard accounts: transfer USDC to the HIP-3 dex to cover margin
     const requiredMargin = notional / effectiveLev;
     // Add 20% buffer for fees and slippage
     const transferAmount = Math.ceil(requiredMargin * 1.2 * 100) / 100;
 
-    this.log(`HIP-3 margin transfer: ${transferAmount} USDC from main → ${dexInfo.dexName} (notional: ${notional}, leverage: ${maxLev}x)`);
+    this.log(`HIP-3 margin transfer: ${transferAmount} USDC from main → ${dexInfo.dexName} (notional: ${notional}, leverage: ${effectiveLev}x)`);
     try {
       await this.exchange.sendAsset({
         destination: this.address as `0x${string}`,

package/scripts/info/account.ts

@@ -6,28 +6,14 @@ import { formatUsd, formatPercent, parseArgs } from '../core/utils.js';
 
 async function main() {
   const args = parseArgs(process.argv.slice(2));
+  const jsonOutput = args.json as boolean;
   const client = getClient();
 
-  console.log('Open Broker - Account Info');
-  console.log('==========================\n');
-
-  console.log('Wallet Configuration');
-  console.log('--------------------');
-  console.log(`Trading Account:  ${client.address}`);
-  console.log(`Signing Wallet:   ${client.walletAddress}`);
-  console.log(`Wallet Type:      ${client.isApiWallet ? 'API Wallet' : 'Main Wallet'}`);
-
-  // Check builder fee approval
-  const builderApproval = await client.getMaxBuilderFee();
-  console.log(`Builder Address:  ${client.builderAddress}`);
-  console.log(`Builder Fee:      ${client.builderFeeBps} bps`);
-  if (builderApproval) {
-    console.log(`Builder Approved: ✅ Yes (max: ${builderApproval})`);
-  } else {
-    console.log(`Builder Approved: ❌ No`);
-    console.log(`\n⚠️  Run: npx tsx scripts/setup/approve-builder.ts`);
+  if (args.verbose) {
+    client.verbose = true;
   }
-  console.log('');
+
+  const accountMode = await client.getAccountMode();
 
   try {
     const state = await client.getUserStateAll();
@@ -38,6 +24,93 @@ async function main() {
     const withdrawable = parseFloat(margin.withdrawable);
     const totalNotional = parseFloat(margin.totalNtlPos);
 
+    const positions = state.assetPositions
+      .filter(ap => Math.abs(parseFloat(ap.position.szi)) >= 0.0001)
+      .map(ap => {
+        const pos = ap.position;
+        const size = parseFloat(pos.szi);
+        const entryPx = parseFloat(pos.entryPx);
+        const notional = parseFloat(pos.positionValue);
+        const markPx = Math.abs(notional / size);
+        const pnl = parseFloat(pos.unrealizedPnl);
+        return {
+          coin: pos.coin,
+          side: size > 0 ? 'long' : 'short',
+          size: pos.szi,
+          entryPrice: pos.entryPx,
+          markPrice: markPx,
+          notional: Math.abs(notional),
+          unrealizedPnl: pnl,
+          leverage: `${pos.leverage.value}x ${pos.leverage.type}`,
+          liquidationPx: pos.liquidationPx,
+        };
+      });
+
+    const totalPnl = positions.reduce((sum, p) => sum + p.unrealizedPnl, 0);
+
+    // JSON output
+    if (jsonOutput) {
+      const result: Record<string, unknown> = {
+        address: client.address,
+        signingWallet: client.walletAddress,
+        walletType: client.isApiWallet ? 'api' : 'main',
+        accountMode,
+        equity: accountValue,
+        totalNotional,
+        totalMarginUsed,
+        withdrawable,
+        marginRatio: totalMarginUsed > 0 && accountValue > 0 ? totalMarginUsed / accountValue : 0,
+        totalUnrealizedPnl: totalPnl,
+        positions,
+      };
+
+      if (args.orders) {
+        const orders = await client.getOpenOrders();
+        result.openOrders = orders.map(o => ({
+          coin: o.coin,
+          oid: o.oid,
+          side: o.side === 'B' ? 'buy' : 'sell',
+          size: o.sz,
+          price: o.limitPx,
+          orderType: o.orderType,
+          timestamp: o.timestamp,
+        }));
+      }
+
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+
+    // Human-readable output
+    console.log('Open Broker - Account Info');
+    console.log('==========================\n');
+
+    console.log('Wallet Configuration');
+    console.log('--------------------');
+    console.log(`Trading Account:  ${client.address}`);
+    console.log(`Signing Wallet:   ${client.walletAddress}`);
+    console.log(`Wallet Type:      ${client.isApiWallet ? 'API Wallet' : 'Main Wallet'}`);
+
+    const modeLabel: Record<string, string> = {
+      standard: 'Standard (separate balances per dex)',
+      unified: 'Unified Account (shared USDC across all dexes)',
+      portfolio: 'Portfolio Margin',
+      dexAbstraction: 'DEX Abstraction (deprecated)',
+    };
+    console.log(`Account Mode:     ${modeLabel[accountMode] ?? accountMode}`);
+
+    // Check builder fee approval
+    const builderApproval = await client.getMaxBuilderFee();
+    console.log(`Builder Address:  ${client.builderAddress}`);
+    console.log(`Builder Fee:      ${client.builderFeeBps} bps`);
+    if (builderApproval) {
+      console.log(`Builder Approved: ✅ Yes (max: ${builderApproval})`);
+    } else {
+      console.log(`Builder Approved: ❌ No`);
+      console.log(`\n⚠️  Run: npx tsx scripts/setup/approve-builder.ts`);
+    }
+    console.log('');
+
     console.log('Margin Summary');
     console.log('--------------');
     console.log(`Account Value:    ${formatUsd(accountValue)}`);
@@ -53,33 +126,18 @@ async function main() {
     console.log('\nPositions Summary');
     console.log('-----------------');
 
-    if (state.assetPositions.length === 0) {
+    if (positions.length === 0) {
       console.log('No open positions');
     } else {
-      let totalPnl = 0;
       console.log('Coin     | Size       | Entry      | Mark       | PnL        | Leverage');
       console.log('---------|------------|------------|------------|------------|----------');
 
-      for (const ap of state.assetPositions) {
-        const pos = ap.position;
-        const size = parseFloat(pos.szi);
-        if (Math.abs(size) < 0.0001) continue;
-
-        const entryPx = parseFloat(pos.entryPx);
-        const pnl = parseFloat(pos.unrealizedPnl);
-        totalPnl += pnl;
-
-        // Get mark price from leverage calculation
-        const notional = parseFloat(pos.positionValue);
-        const markPx = Math.abs(notional / size);
-
-        const side = size > 0 ? 'L' : 'S';
-        const leverageStr = `${pos.leverage.value}x ${pos.leverage.type}`;
-
+      for (const p of positions) {
+        const side = p.side === 'long' ? 'L' : 'S';
         console.log(
-          `${pos.coin.padEnd(8)} | ${side} ${Math.abs(size).toFixed(4).padStart(8)} | ` +
-          `${formatUsd(entryPx).padStart(10)} | ${formatUsd(markPx).padStart(10)} | ` +
-          `${formatUsd(pnl).padStart(10)} | ${leverageStr}`
+          `${p.coin.padEnd(8)} | ${side} ${Math.abs(parseFloat(p.size)).toFixed(4).padStart(8)} | ` +
+          `${formatUsd(parseFloat(p.entryPrice)).padStart(10)} | ${formatUsd(p.markPrice).padStart(10)} | ` +
+          `${formatUsd(p.unrealizedPnl).padStart(10)} | ${p.leverage}`
         );
       }
 

package/scripts/info/fills.ts

@@ -32,11 +32,9 @@ async function main() {
   const filterCoin = args.coin as string | undefined;
   const filterSide = args.side as string | undefined;
   const top = parseInt(args.top as string) || 20;
+  const jsonOutput = args.json as boolean;
   const client = getClient();
 
-  console.log('Open Broker - Trade Fills');
-  console.log('========================\n');
-
   try {
     let fills = await client.getUserFills();
 
@@ -52,6 +50,22 @@ async function main() {
     fills.sort((a, b) => b.time - a.time);
     fills = fills.slice(0, top);
 
+    if (jsonOutput) {
+      console.log(JSON.stringify(fills.map(f => ({
+        time: new Date(f.time).toISOString(),
+        coin: f.coin,
+        side: f.side === 'B' ? 'buy' : 'sell',
+        size: f.sz,
+        price: f.px,
+        fee: f.fee,
+        closedPnl: f.closedPnl,
+      })), null, 2));
+      return;
+    }
+
+    console.log('Open Broker - Trade Fills');
+    console.log('========================\n');
+
     if (fills.length === 0) {
       console.log('No fills found');
       return;

package/scripts/info/funding.ts

@@ -19,9 +19,7 @@ async function main() {
   const filterCoin = args.coin as string | undefined;
   const sortBy = (args.sort as string) || 'annualized'; // annualized, hourly, oi
   const showAll = args.all as boolean;
-
-  console.log('Open Broker - Funding Rates');
-  console.log('===========================\n');
+  const jsonOutput = args.json as boolean;
 
   const client = getClient();
   const includeHip3 = args['include-hip3'] as boolean || args['hip3'] as boolean || (filterCoin?.includes(':') ?? false);
@@ -101,11 +99,19 @@ async function main() {
     // Limit
     const displayData = filterCoin ? fundingData : fundingData.slice(0, topN);
 
+    if (jsonOutput) {
+      console.log(JSON.stringify(displayData, null, 2));
+      return;
+    }
+
     if (displayData.length === 0) {
       console.log(filterCoin ? `No data for ${filterCoin}` : 'No funding data available');
       return;
     }
 
+    console.log('Open Broker - Funding Rates');
+    console.log('===========================\n');
+
     // Table header
     console.log('Coin     | Hourly Rate | Annualized |   Premium   | Open Interest |    Mark');
     console.log('---------|-------------|------------|-------------|---------------|----------');

package/scripts/info/markets.ts

@@ -21,9 +21,7 @@ async function main() {
   const filterCoin = args.coin as string | undefined;
   const topN = parseInt(args.top as string) || 30;
   const sortBy = (args.sort as string) || 'volume'; // volume, oi, change
-
-  console.log('Open Broker - Markets');
-  console.log('=====================\n');
+  const jsonOutput = args.json as boolean;
 
   const client = getClient();
   const includeHip3 = args['include-hip3'] as boolean || args['hip3'] as boolean || (filterCoin?.includes(':') ?? false);
@@ -109,6 +107,14 @@ async function main() {
     // Limit
     const displayData = filterCoin ? markets : markets.slice(0, topN);
 
+    if (jsonOutput) {
+      console.log(JSON.stringify(displayData, null, 2));
+      return;
+    }
+
+    console.log('Open Broker - Markets');
+    console.log('=====================\n');
+
     if (displayData.length === 0) {
       console.log(filterCoin ? `No data for ${filterCoin}` : 'No market data available');
       return;

package/scripts/info/orders.ts

@@ -32,11 +32,9 @@ async function main() {
   const filterCoin = args.coin as string | undefined;
   const filterStatus = args.status as string | undefined;
   const top = parseInt(args.top as string) || 20;
+  const jsonOutput = args.json as boolean;
   const client = getClient();
 
-  console.log('Open Broker - Order History');
-  console.log('==========================\n');
-
   try {
     let orders = await client.getHistoricalOrders();
 
@@ -52,6 +50,23 @@ async function main() {
     orders.sort((a, b) => b.order.timestamp - a.order.timestamp);
     orders = orders.slice(0, top);
 
+    if (jsonOutput) {
+      console.log(JSON.stringify(orders.map(entry => ({
+        time: new Date(entry.order.timestamp).toISOString(),
+        coin: entry.order.coin,
+        side: entry.order.side === 'B' ? 'buy' : 'sell',
+        orderType: entry.order.orderType,
+        size: entry.order.sz,
+        price: entry.order.limitPx,
+        status: entry.status,
+        oid: entry.order.oid,
+      })), null, 2));
+      return;
+    }
+
+    console.log('Open Broker - Order History');
+    console.log('==========================\n');
+
     if (orders.length === 0) {
       console.log('No orders found');
       return;

package/scripts/info/positions.ts

@@ -7,10 +7,12 @@ import { formatUsd, formatPercent, parseArgs } from '../core/utils.js';
 async function main() {
   const args = parseArgs(process.argv.slice(2));
   const filterCoin = args.coin as string | undefined;
+  const jsonOutput = args.json as boolean;
   const client = getClient();
 
-  console.log('Open Broker - Positions');
-  console.log('=======================\n');
+  if (args.verbose) {
+    client.verbose = true;
+  }
 
   try {
     const [state, mids, fundingHistory] = await Promise.all([
@@ -26,11 +28,6 @@ async function main() {
       return true;
     });
 
-    if (positions.length === 0) {
-      console.log(filterCoin ? `No position in ${filterCoin}` : 'No open positions');
-      return;
-    }
-
     // Sum cumulative funding per coin
     const fundingByCoin = new Map<string, number>();
     for (const entry of fundingHistory) {
@@ -39,6 +36,44 @@ async function main() {
       fundingByCoin.set(coin, (fundingByCoin.get(coin) ?? 0) + usdc);
     }
 
+    // JSON output
+    if (jsonOutput) {
+      const result = positions.map(ap => {
+        const pos = ap.position;
+        const size = parseFloat(pos.szi);
+        const markPx = parseFloat(mids[pos.coin] || '0');
+        const liqPx = pos.liquidationPx ? parseFloat(pos.liquidationPx) : null;
+        return {
+          coin: pos.coin,
+          side: size > 0 ? 'long' : 'short',
+          size: pos.szi,
+          entryPrice: pos.entryPx,
+          markPrice: markPx,
+          notional: Math.abs(parseFloat(pos.positionValue)),
+          unrealizedPnl: parseFloat(pos.unrealizedPnl),
+          returnOnEquity: parseFloat(pos.returnOnEquity),
+          cumulativeFunding: fundingByCoin.get(pos.coin) ?? 0,
+          marginUsed: parseFloat(pos.marginUsed),
+          leverage: `${pos.leverage.value}x`,
+          leverageType: pos.leverage.type,
+          liquidationPrice: liqPx,
+          liquidationDistance: liqPx && markPx ? Math.abs((markPx - liqPx) / markPx) : null,
+          maxLeverage: pos.maxLeverage,
+        };
+      });
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+
+    // Human-readable output
+    console.log('Open Broker - Positions');
+    console.log('=======================\n');
+
+    if (positions.length === 0) {
+      console.log(filterCoin ? `No position in ${filterCoin}` : 'No open positions');
+      return;
+    }
+
     for (const ap of positions) {
       const pos = ap.position;
       const size = parseFloat(pos.szi);

package/scripts/plugin/tools.ts

@@ -35,10 +35,12 @@ export function createTools(watcher: PositionWatcher | null): PluginTool[] {
         const { getClient } = await import('../core/client.js');
         const client = getClient();
         const state = await client.getUserStateAll();
+        const accountMode = await client.getAccountMode();
 
         const result: Record<string, unknown> = {
           address: client.address,
           isApiWallet: client.isApiWallet,
+          accountMode,
           equity: state.marginSummary.accountValue,
           totalNtlPos: state.marginSummary.totalNtlPos,
           totalMarginUsed: state.marginSummary.totalMarginUsed,