openbroker 1.0.45 → 1.0.48

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to Open Broker will be documented in this file.
 
+## [1.0.48] - 2026-03-09
+
+### Fixed
+- **HIP-3 Perp Trading**: All trading commands now work with HIP-3 assets using `dex:COIN` syntax (e.g., `--coin xyz:CL`)
+  - `getMetaAndAssetCtxs()` loads HIP-3 dex assets into asset/szDecimals maps (asset index = `10000 * dexIdx + assetIdx`)
+  - `getAllMids()` fetches and merges mid prices from all HIP-3 dexes
+  - Market, limit, trigger, bracket, TWAP, scale, chase orders all work with HIP-3 assets
+- **HIP-3 Info Commands**: `funding`, `funding-history`, `candles`, `trades` now return data for HIP-3 assets (previously returned "No data" / null)
+- **API Name Format**: Hyperliquid API returns HIP-3 names already prefixed (e.g., `xyz:CL`); fixed double-prefixing bug that caused all HIP-3 lookups to fail
+- **Case Normalization**: Added `normalizeCoin()` helper — keeps dex prefix lowercase, uppercases asset (`xyz:cl` → `xyz:CL`). Fixes `toUpperCase()` mangling HIP-3 tickers to `XYZ:CL`
+- **Better Error Messages**: When a bare coin name (e.g., `CL`) matches HIP-3 assets, the error now suggests the prefixed ticker (e.g., `xyz:CL`)
+
+### Added
+- **Funding Rate Scanner**: New `funding-scan` command for cross-dex funding rate scanning
+  - Scans all dexes (main + HIP-3) for high funding opportunities
+  - `--pairs` flag identifies opposing funding pairs for delta-neutral strategies
+  - `--watch --interval N` for periodic re-scanning
+  - `--json` output for piping to alerting systems
+  - `--main-only` / `--hip3-only` scope filters
+- **HIP-3 Funding Rates**: `funding` and `markets` commands now support `--include-hip3` flag
+- **HIP-3 Funding Arb**: `funding-arb` strategy now works with HIP-3 assets (monitoring loop correctly resolves HIP-3 funding data)
+- **Plugin**: New `ob_funding_scan` agent tool for cross-dex funding scanning with pairs support
+- **Plugin**: `ob_search` now searches HIP-3 perps in addition to main perps and spot
+- **Client**: Added `getCoinDex()`, `getCoinLocalName()`, `isHip3()`, `getAllAssetNames()`, `getHip3AssetNames()`, `invalidateMetaCache()` methods
+- **Client**: `getPerpDexs()` results are now cached to reduce redundant API calls
+
 ## [1.0.44] - 2026-02-25
 
 ### Added

package/README.md

@@ -31,10 +31,15 @@ openbroker setup                # One-command setup (wallet + config + builder a
 ```
 
 The setup command handles everything automatically:
-- Generates a new wallet or accepts your existing private key
+- Generates a fresh trading wallet (recommended for agents) or accepts your existing private key
 - Saves configuration to `~/.openbroker/.env` (permissions `0600`)
 - Approves the builder fee (required for trading)
 
+Setup offers three modes:
+1. **Generate fresh wallet** (recommended for agents) — cleanest option, no browser steps
+2. **Import existing key** — use a key you already have
+3. **Generate API wallet** — restricted wallet requiring browser approval from a master wallet
+
 ---
 
 ### Info Commands
@@ -636,16 +641,24 @@ export HYPERLIQUID_NETWORK=mainnet       # Optional: mainnet (default) or testne
 export HYPERLIQUID_ACCOUNT_ADDRESS=0x... # Optional: for API wallets
 ```
 
-### API Wallet Setup
+### Fresh Wallet Setup (Recommended for Agents)
+
+The simplest setup for agents — generates a dedicated wallet, auto-approves the builder fee, and is ready to trade after funding:
+
+```bash
+openbroker setup    # Choose option 1, fund with USDC, start trading
+```
+
+### API Wallet Setup (Alternative)
 
-For automated trading, use an API wallet:
+For delegated trading without moving funds, use an API wallet:
 
 ```bash
 export HYPERLIQUID_PRIVATE_KEY="0x..."        # API wallet private key
 export HYPERLIQUID_ACCOUNT_ADDRESS="0x..."    # Main account address
 ```
 
-**Note:** Builder fee must be approved with the main wallet first. Sub-accounts cannot approve builder fees. After approval, you can switch to using the API wallet for trading.
+**Note:** API wallets require browser approval from the master wallet. The master wallet signs `ApproveAgent` and `ApproveBuilderFee` transactions via the approval URL provided during setup.
 
 ## Builder Fee
 

package/SKILL.md

@@ -4,8 +4,8 @@ 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.45", "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_buy ob_sell ob_limit ob_trigger ob_tpsl ob_cancel ob_twap ob_bracket ob_chase ob_watcher_status Bash(openbroker:*)
+metadata: {"author": "monemetrics", "version": "1.0.48", "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:*)
 ---
 
 # Open Broker - Hyperliquid Trading CLI
@@ -40,16 +40,26 @@ openbroker approve-builder --check  # Check builder fee status (for troubleshoot
 ```
 
 The `setup` command offers three modes:
-1. **Import existing key** — use a private key you already have (master wallet)
-2. **Generate new wallet** — create a fresh master wallet
-3. **Generate API wallet** (recommended for agents) — creates a restricted wallet that can trade but cannot withdraw
+1. **Generate fresh wallet** (recommended for agents) — creates a dedicated trading wallet with builder fee auto-approved. No browser steps needed — just fund with USDC and start trading.
+2. **Import existing key** — use a private key you already have
+3. **Generate API wallet** — creates a restricted wallet that can trade but cannot withdraw. Requires browser approval from a master wallet.
 
 For options 1 and 2, setup saves config and approves the builder fee automatically.
 For option 3 (API wallet), see the API Wallet Setup section below.
 
-### API Wallet Setup (Recommended for Agents)
+### Fresh Wallet Setup (Recommended for Agents)
 
-API wallets can place trades on behalf of a master account but **cannot withdraw funds**. This is the safest option for automated agents.
+The simplest setup for agents. A fresh wallet is generated, the builder fee is auto-approved, and the agent is ready to trade immediately after funding.
+
+**Flow:**
+1. Run `openbroker setup` and choose option 1 ("Generate a fresh wallet")
+2. The CLI generates a wallet, saves the config, and approves the builder fee automatically
+3. Fund the wallet with USDC on Arbitrum, then deposit at https://app.hyperliquid.xyz/
+4. Start trading
+
+### API Wallet Setup (Alternative)
+
+API wallets can place trades on behalf of a master account but **cannot withdraw funds**. Use this if you prefer to keep funds in your existing wallet and only delegate trading access.
 
 **Flow:**
 1. Run `openbroker setup` and choose option 3 ("Generate API wallet")
@@ -160,8 +170,25 @@ openbroker trades --coin BTC --top 50     # Last 50 trades
 openbroker rate-limit                     # API usage and capacity
 ```
 
+### Funding Rate Scanner (Cross-Dex)
+```bash
+openbroker funding-scan                          # Scan all dexes, >25% threshold
+openbroker funding-scan --threshold 50 --pairs   # Show opposing funding pairs
+openbroker funding-scan --hip3-only --top 20     # HIP-3 only
+openbroker funding-scan --watch --interval 120   # Re-scan every 2 minutes
+```
+
 ## Trading Commands
 
+### HIP-3 Perp Trading
+All trading commands support HIP-3 assets using `dex:COIN` syntax:
+```bash
+openbroker buy --coin xyz:CL --size 1              # Buy crude oil on xyz dex
+openbroker sell --coin xyz:BRENTOIL --size 1        # Sell brent oil
+openbroker limit --coin xyz:GOLD --side buy --size 0.1 --price 2500
+openbroker funding-arb --coin xyz:CL --size 5000    # Funding arb on HIP-3
+```
+
 ### Market Orders (Quick)
 ```bash
 openbroker buy --coin ETH --size 0.1

package/bin/cli.ts

@@ -31,6 +31,7 @@ const commands: Record<string, { script: string; description: string }> = {
   'funding-history': { script: 'info/funding-history.ts', description: 'View historical funding rates' },
   'trades': { script: 'info/trades.ts', description: 'View recent trades for an asset' },
   'rate-limit': { script: 'info/rate-limit.ts', description: 'View API rate limit status' },
+  'funding-scan': { script: 'info/funding-scan.ts', description: 'Scan funding rates across all dexes' },
 
   // Operations
   'buy': { script: 'operations/market-order.ts', description: 'Market buy order' },
@@ -78,6 +79,7 @@ Info Commands:
   search               Search for assets across all providers
   spot                 View spot markets and balances
   rate-limit           View API rate limit status
+  funding-scan         Scan funding rates across all dexes (main + HIP-3)
 
 Trading Commands:
   buy                  Market buy order

package/openclaw.plugin.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openbroker",
-  "version": "1.0.45",
+  "version": "1.0.48",
   "description": "Hyperliquid trading CLI - execute orders, manage positions, and run trading strategies",
   "type": "module",
   "bin": {
@@ -38,6 +38,7 @@
     "scale": "tsx scripts/operations/scale.ts",
     "bracket": "tsx scripts/operations/bracket.ts",
     "chase": "tsx scripts/operations/chase.ts",
+    "funding-scan": "tsx scripts/info/funding-scan.ts",
     "funding-arb": "tsx scripts/strategies/funding-arb.ts",
     "grid": "tsx scripts/strategies/grid.ts",
     "dca": "tsx scripts/strategies/dca.ts",

package/scripts/core/client.ts

@@ -25,6 +25,12 @@ export class HyperliquidClient {
   private meta: MetaAndAssetCtxs | null = null;
   private assetMap: Map<string, number> = new Map();
   private szDecimalsMap: Map<string, number> = new Map();
+  /** Maps coin name → dex info for HIP-3 assets. Main dex assets have dexName=null */
+  private coinDexMap: Map<string, { dexName: string | null; dexIdx: number; localName: string }> = new Map();
+  /** Cache of perpDexs list */
+  private perpDexsCache: Array<{ name: string; fullName: string; deployer: string } | null> | null = null;
+  /** Whether HIP-3 assets have been loaded into maps */
+  private hip3Loaded: boolean = false;
   public verbose: boolean = false;
 
   constructor(config?: OpenBrokerConfig) {
@@ -106,18 +112,106 @@ export class HyperliquidClient {
       assetCtxs: response[1],
     };
 
-    // Build lookup maps
+    // Build lookup maps for main dex
     this.meta.meta.universe.forEach((asset, index) => {
       this.assetMap.set(asset.name, index);
       this.szDecimalsMap.set(asset.name, asset.szDecimals);
+      this.coinDexMap.set(asset.name, { dexName: null, dexIdx: 0, localName: asset.name });
     });
 
+    // Load HIP-3 dex assets (only once - maps persist across meta cache invalidation)
+    if (!this.hip3Loaded) {
+      await this.loadHip3Assets();
+      this.hip3Loaded = true;
+    }
+
     return this.meta;
   }
 
+  /**
+   * Load HIP-3 perp dex assets into the asset/szDecimals maps.
+   * Asset index formula: 10000 * dexIdx + assetIdx
+   * Coins are keyed as "dexName:COIN" (e.g., "xyz:CL")
+   */
+  private async loadHip3Assets(): Promise<void> {
+    try {
+      const dexs = await this.getPerpDexs();
+      const baseUrl = isMainnet()
+        ? 'https://api.hyperliquid.xyz'
+        : 'https://api.hyperliquid-testnet.xyz';
+
+      for (let dexIdx = 1; dexIdx < dexs.length; dexIdx++) {
+        const dex = dexs[dexIdx];
+        if (!dex) continue;
+
+        try {
+          const dexResponse = await fetch(baseUrl + '/info', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ type: 'metaAndAssetCtxs', dex: dex.name }),
+          });
+          const dexData = await dexResponse.json();
+
+          if (dexData && dexData[0]?.universe) {
+            const universe = dexData[0].universe as Array<{ name: string; szDecimals: number; maxLeverage: number; onlyIsolated?: boolean }>;
+            this.log(`Loading HIP-3 dex: ${dex.name} with ${universe.length} markets`);
+
+            universe.forEach((asset, assetIdx) => {
+              // API returns names already prefixed (e.g., "xyz:CL"), use as-is
+              const coinName = asset.name;
+              // Extract local name by stripping dex prefix if present
+              const localName = coinName.startsWith(dex.name + ':') ? coinName.slice(dex.name.length + 1) : coinName;
+              const globalIndex = 10000 * dexIdx + assetIdx;
+
+              this.assetMap.set(coinName, globalIndex);
+              this.szDecimalsMap.set(coinName, asset.szDecimals);
+              this.coinDexMap.set(coinName, { dexName: dex.name, dexIdx, localName });
+            });
+          }
+        } catch (e) {
+          this.log(`Failed to load HIP-3 dex ${dex.name}:`, e);
+        }
+      }
+    } catch (e) {
+      this.log('Failed to load HIP-3 assets:', e);
+    }
+  }
+
   async getAllMids(): Promise<Record<string, string>> {
     this.log('Fetching allMids...');
-    const response = await this.info.allMids();
+    const response = await this.info.allMids() as Record<string, string>;
+
+    // Also fetch HIP-3 dex mids
+    try {
+      const dexs = await this.getPerpDexs();
+      const baseUrl = isMainnet()
+        ? 'https://api.hyperliquid.xyz'
+        : 'https://api.hyperliquid-testnet.xyz';
+
+      for (let i = 1; i < dexs.length; i++) {
+        const dex = dexs[i];
+        if (!dex) continue;
+
+        try {
+          const dexResponse = await fetch(baseUrl + '/info', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ type: 'allMids', dex: dex.name }),
+          });
+          const dexMids = await dexResponse.json() as Record<string, string>;
+
+          // Merge directly — API already returns prefixed keys (e.g., "xyz:CL")
+          for (const [coin, mid] of Object.entries(dexMids)) {
+            response[coin] = mid;
+          }
+        } catch (e) {
+          this.log(`Failed to fetch mids for HIP-3 dex ${dex.name}:`, e);
+        }
+      }
+    } catch (e) {
+      this.log('Failed to fetch HIP-3 mids:', e);
+    }
+
     return response;
   }
 
@@ -130,6 +224,8 @@ export class HyperliquidClient {
     fullName: string;
     deployer: string;
   } | null>> {
+    if (this.perpDexsCache) return this.perpDexsCache;
+
     this.log('Fetching perpDexs...');
     const baseUrl = isMainnet()
       ? 'https://api.hyperliquid.xyz'
@@ -142,6 +238,7 @@ export class HyperliquidClient {
     });
     const data = await response.json();
     this.log('perpDexs response:', JSON.stringify(data).slice(0, 500));
+    this.perpDexsCache = data;
     return data;
   }
 
@@ -412,6 +509,7 @@ export class HyperliquidClient {
     spreadBps: number;
   }> {
     this.log('Fetching l2Book for:', coin);
+    // API accepts prefixed names directly (e.g., "xyz:CL")
     const response = await this.info.l2Book({ coin });
 
     const bids = response.levels[0] as Array<{ px: string; sz: string; n: number }>;
@@ -437,6 +535,15 @@ export class HyperliquidClient {
   getAssetIndex(coin: string): number {
     const index = this.assetMap.get(coin);
     if (index === undefined) {
+      // Check if bare name exists in HIP-3 dexes and suggest prefixed version
+      const hip3Matches = this.findHip3Matches(coin);
+      if (hip3Matches.length > 0) {
+        const suggestions = hip3Matches.map(m => `${m}`).join(', ');
+        throw new Error(
+          `Unknown asset: ${coin}. Did you mean one of these HIP-3 assets? ${suggestions}\n` +
+          `Use "openbroker search --query ${coin}" to find the full ticker.`
+        );
+      }
       throw new Error(`Unknown asset: ${coin}. Available: ${Array.from(this.assetMap.keys()).slice(0, 10).join(', ')}...`);
     }
     return index;
@@ -445,11 +552,78 @@ export class HyperliquidClient {
   getSzDecimals(coin: string): number {
     const decimals = this.szDecimalsMap.get(coin);
     if (decimals === undefined) {
+      const hip3Matches = this.findHip3Matches(coin);
+      if (hip3Matches.length > 0) {
+        throw new Error(
+          `Unknown asset: ${coin}. Did you mean: ${hip3Matches.join(', ')}?`
+        );
+      }
       throw new Error(`Unknown asset: ${coin}`);
     }
     return decimals;
   }
 
+  /**
+   * Find HIP-3 assets matching a bare coin name (without dex prefix)
+   */
+  private findHip3Matches(bareName: string): string[] {
+    const matches: string[] = [];
+    const upperName = bareName.toUpperCase();
+    for (const [key, info] of this.coinDexMap.entries()) {
+      if (info.dexName && info.localName.toUpperCase() === upperName) {
+        matches.push(key);
+      }
+    }
+    return matches;
+  }
+
+  /**
+   * Get the dex name for a coin (null for main dex assets)
+   */
+  getCoinDex(coin: string): string | null {
+    return this.coinDexMap.get(coin)?.dexName ?? null;
+  }
+
+  /**
+   * Get the local (unprefixed) coin name for API calls that need it
+   * e.g., "xyz:CL" → "CL", "ETH" → "ETH"
+   */
+  getCoinLocalName(coin: string): string {
+    return this.coinDexMap.get(coin)?.localName ?? coin;
+  }
+
+  /**
+   * Check if a coin is a HIP-3 asset
+   */
+  isHip3(coin: string): boolean {
+    return this.coinDexMap.get(coin)?.dexName != null;
+  }
+
+  /**
+   * Invalidate cached metadata so next call fetches fresh data.
+   * Useful for long-running strategies that need updated funding rates.
+   */
+  invalidateMetaCache(): void {
+    this.meta = null;
+    // Keep the asset/szDecimals/coinDex maps - they don't change
+  }
+
+  /**
+   * Get all loaded asset names (main + HIP-3)
+   */
+  getAllAssetNames(): string[] {
+    return Array.from(this.assetMap.keys());
+  }
+
+  /**
+   * Get all HIP-3 asset names
+   */
+  getHip3AssetNames(): string[] {
+    return Array.from(this.coinDexMap.entries())
+      .filter(([_, info]) => info.dexName !== null)
+      .map(([name]) => name);
+  }
+
   // ============ Account Info ============
 
   /**
@@ -783,6 +957,7 @@ export class HyperliquidClient {
       ? 'https://api.hyperliquid.xyz'
       : 'https://api.hyperliquid-testnet.xyz';
 
+    // API accepts prefixed names directly (e.g., "xyz:CL")
     const req: Record<string, unknown> = { coin, interval, startTime };
     if (endTime !== undefined) req.endTime = endTime;
 
@@ -814,6 +989,7 @@ export class HyperliquidClient {
       ? 'https://api.hyperliquid.xyz'
       : 'https://api.hyperliquid-testnet.xyz';
 
+    // API accepts prefixed names directly (e.g., "xyz:CL")
     const body: Record<string, unknown> = { type: 'fundingHistory', coin, startTime };
     if (endTime !== undefined) body.endTime = endTime;
 
@@ -844,10 +1020,13 @@ export class HyperliquidClient {
       ? 'https://api.hyperliquid.xyz'
       : 'https://api.hyperliquid-testnet.xyz';
 
+    // API accepts prefixed names directly (e.g., "xyz:CL")
+    const body: Record<string, unknown> = { type: 'recentTrades', coin };
+
     const response = await fetch(baseUrl + '/info', {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ type: 'recentTrades', coin }),
+      body: JSON.stringify(body),
     });
     const data = await response.json();
     this.log('recentTrades response length:', data?.length);

package/scripts/core/utils.ts

@@ -119,6 +119,18 @@ export function parseArgs(args: string[]): Record<string, string | boolean> {
   return result;
 }
 
+/**
+ * Normalize a coin name: uppercase the asset, keep dex prefix lowercase.
+ * "eth" → "ETH", "xyz:cl" → "xyz:CL", "xyz:CL" → "xyz:CL"
+ */
+export function normalizeCoin(coin: string): string {
+  const colonIdx = coin.indexOf(':');
+  if (colonIdx >= 0) {
+    return coin.slice(0, colonIdx).toLowerCase() + ':' + coin.slice(colonIdx + 1).toUpperCase();
+  }
+  return coin.toUpperCase();
+}
+
 /**
  * Sleep for specified milliseconds
  */

package/scripts/info/candles.ts

@@ -2,7 +2,7 @@
 // View OHLCV candle data from Hyperliquid
 
 import { getClient } from '../core/client.js';
-import { formatUsd, parseArgs } from '../core/utils.js';
+import { formatUsd, parseArgs, normalizeCoin } from '../core/utils.js';
 
 const VALID_INTERVALS = ['1m', '3m', '5m', '15m', '30m', '1h', '2h', '4h', '8h', '12h', '1d', '3d', '1w', '1M'];
 
@@ -61,13 +61,16 @@ async function main() {
   const bars = parseInt(args.bars as string) || 24;
   const client = getClient();
 
-  console.log(`Open Broker - ${coin.toUpperCase()} Candles (${interval})`);
+  console.log(`Open Broker - ${normalizeCoin(coin)} Candles (${interval})`);
   console.log('='.repeat(40) + '\n');
 
   try {
+    // Load metadata (needed for HIP-3 coin resolution)
+    await client.getMetaAndAssetCtxs();
+
     const now = Date.now();
     const startTime = now - (bars * (INTERVAL_MS[interval] || 3_600_000));
-    const candles = await client.getCandleSnapshot(coin.toUpperCase(), interval, startTime);
+    const candles = await client.getCandleSnapshot(normalizeCoin(coin), interval, startTime);
 
     if (candles.length === 0) {
       console.log('No candle data found');

package/scripts/info/fills.ts

@@ -2,7 +2,7 @@
 // View trade fill history from Hyperliquid
 
 import { getClient } from '../core/client.js';
-import { formatUsd, parseArgs } from '../core/utils.js';
+import { formatUsd, parseArgs, normalizeCoin } from '../core/utils.js';
 
 function printUsage() {
   console.log(`
@@ -41,7 +41,7 @@ async function main() {
     let fills = await client.getUserFills();
 
     if (filterCoin) {
-      fills = fills.filter(f => f.coin === filterCoin.toUpperCase());
+      fills = fills.filter(f => f.coin === normalizeCoin(filterCoin));
     }
     if (filterSide) {
       const sideCode = filterSide.toLowerCase() === 'buy' ? 'B' : 'A';

package/scripts/info/funding-history.ts

@@ -2,7 +2,7 @@
 // View historical funding rates for an asset on Hyperliquid
 
 import { getClient } from '../core/client.js';
-import { formatPercent, annualizeFundingRate, parseArgs } from '../core/utils.js';
+import { formatPercent, annualizeFundingRate, parseArgs, normalizeCoin } from '../core/utils.js';
 
 function printUsage() {
   console.log(`
@@ -37,13 +37,16 @@ async function main() {
   const hours = parseInt(args.hours as string) || 24;
   const client = getClient();
 
-  console.log(`Open Broker - ${coin.toUpperCase()} Funding History (${hours}h)`);
+  console.log(`Open Broker - ${normalizeCoin(coin)} Funding History (${hours}h)`);
   console.log('='.repeat(40) + '\n');
 
   try {
+    // Load metadata (needed for HIP-3 coin resolution)
+    await client.getMetaAndAssetCtxs();
+
     const now = Date.now();
     const startTime = now - (hours * 3_600_000);
-    const history = await client.getFundingHistory(coin.toUpperCase(), startTime);
+    const history = await client.getFundingHistory(normalizeCoin(coin), startTime);
 
     if (history.length === 0) {
       console.log('No funding history found');