openbroker 1.0.56 → 1.0.57

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 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

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.56", "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.56",
+  "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.56",
+  "version": "1.0.57",
   "description": "Hyperliquid trading CLI - execute orders, manage positions, and run trading strategies",
   "type": "module",
   "bin": {

package/scripts/core/client.ts

@@ -656,14 +656,17 @@ export class HyperliquidClient {
         }),
       });
       const data = await response.json();
-      this.log('userAbstraction response:', data);
+      this.log('userAbstraction response:', JSON.stringify(data));
 
-      // API returns: "default" | "disabled" | "dexAbstraction" | "unifiedAccount" | "portfolioMargin"
-      if (data === 'unifiedAccount') {
+      // 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 (data === 'portfolioMargin') {
+      } else if (modeLower.includes('portfolio')) {
         this.accountMode = 'portfolio';
-      } else if (data === 'dexAbstraction') {
+      } else if (modeLower.includes('dex')) {
         this.accountMode = 'dexAbstraction';
       } else {
         // "default" or "disabled" both mean standard mode
@@ -1173,7 +1176,12 @@ export class HyperliquidClient {
     if (unified) {
       try {
         const spotState = await this.getSpotBalances(user);
-        const usdcBalance = spotState.balances.find(b => b.coin === 'USDC');
+        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;
@@ -1200,6 +1208,8 @@ export class HyperliquidClient {
           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));

package/scripts/info/account.ts

@@ -6,37 +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'}`);
+  if (args.verbose) {
+    client.verbose = true;
+  }
 
   const accountMode = await client.getAccountMode();
-  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('');
 
   try {
     const state = await client.getUserStateAll();
@@ -47,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)}`);
@@ -62,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,