openbroker 1.3.1 → 1.3.2

package/SKILL.md

@@ -4,7 +4,7 @@ description: Hyperliquid trading CLI skill for agents. Use when an agent needs t
 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.3.1"}
+metadata: {"author": "monemetrics", "version": "1.3.2"}
 allowed-tools: Bash(openbroker:*)
 ---
 
@@ -52,12 +52,15 @@ Common globals:
 openbroker search --query GOLD --json
 openbroker search --query BTC --type perp --json
 openbroker all-markets --type hip3 --json
+openbroker all-markets --type outcome --json
 openbroker outcomes --query BTC --json
 ```
 
 - HIP-3 perps use `dex:COIN`, e.g. `xyz:CL`, not bare `CL`.
 - `assetId` is the canonical identifier for comparisons and persisted agent state; order placement still uses `--coin`.
-- HIP-4 outcome orders use `--outcome <id|#encoding|+encoding>` plus `--outcome-side yes|no` when the reference is a plain ID.
+- For HIP-4 discovery, use `outcomes --json` for grouped market metadata and `all-markets --type outcome --json` for flattened side rows.
+- HIP-4 outcome orders use `--outcome <id|#encoding|+encoding>` plus `--outcome-side yes|no` when the reference is a plain ID. Encoded sides use `encoding = 10 * outcomeId + side`, where side `0` is the first side and side `1` is the second side.
+- HIP-4 order books use `#<encoding>` coins; spot balances may show `+<encoding>` token names.
 - On testnet, HIP-3 metadata may need an explicit prefixed coin such as `dex:COIN`.
 
 ## CLI command map
@@ -72,7 +75,7 @@ Most info commands accept `--json`. Use `--coin`, `--top`, and `--address` where
 | `positions` | Open perp positions and liquidation distance | `--coin`, `--address` |
 | `funding` | Funding rates | `--coin`, `--top`, `--sort annualized|hourly|oi`, `--all`, `--include-hip3` |
 | `markets` | Perp market data | `--coin`, `--top`, `--sort volume|oi|change`, `--include-hip3` |
-| `all-markets` | Browse every venue type | `--type perp|hip3|spot|outcome|all`, `--top` |
+| `all-markets` | Browse every venue type | `--type perp|hip3|spot|outcome|all`, `--top`, `--json` |
 | `search` | Find markets across providers | `--query`, `--type` |
 | `spot` | Spot markets or balances | `--coin`, `--balances`, `--address`, `--top` |
 | `fills` | Recent fills | `--coin`, `--side buy|sell`, `--top`, `--address` |
@@ -84,7 +87,7 @@ Most info commands accept `--json`. Use `--coin`, `--top`, and `--address` where
 | `trades` | Recent tape | `--coin`, `--top` |
 | `rate-limit` | API usage | — |
 | `funding-scan` | Cross-dex scan | `--threshold`, `--main-only`, `--hip3-only`, `--pairs`, `--watch`, `--interval`, `--top` |
-| `outcomes` | HIP-4 discovery/balances | `--query`, `--outcome`, `--side`, `--balances`, `--top` |
+| `outcomes` | HIP-4 discovery/balances | `--query`, `--outcome`, `--side`, `--balances`, `--top`, `--json` |
 
 ### Perp trading
 

package/package.json

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

package/scripts/core/client.ts

@@ -668,9 +668,19 @@ export class HyperliquidClient {
   private parseOutcomeDescription(description: string): Record<string, string> {
     const parsed: Record<string, string> = {};
     for (const part of description.split('|')) {
-      const idx = part.indexOf(':');
-      if (idx <= 0) continue;
-      parsed[part.slice(0, idx)] = part.slice(idx + 1);
+      const rawSegment = part.trim();
+      const metadataIdx = rawSegment.indexOf('metadata=');
+      const segments = metadataIdx >= 0
+        ? [rawSegment, rawSegment.slice(metadataIdx + 'metadata='.length)]
+        : [rawSegment];
+
+      for (const segment of segments) {
+        const idx = segment.indexOf(':');
+        if (idx <= 0) continue;
+        const key = segment.slice(0, idx).trim();
+        if (!/^[A-Za-z][A-Za-z0-9_]*$/.test(key)) continue;
+        parsed[key] = segment.slice(idx + 1).trim();
+      }
     }
     return parsed;
   }

package/scripts/info/all-markets.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env tsx
-// All Markets - View all available markets across perps, spot, and HIP-3 dexs
+// All Markets - View all available markets across perps, HIP-3, spot, and HIP-4 outcomes
 
 import { getClient } from '../core/client.js';
 
@@ -88,9 +88,22 @@ interface MarketRow {
   maxLeverage?: number;
   outcome?: number;
   outcomeSide?: string;
+  outcomeName?: string;
+  tokenName?: string;
+  parsedDescription?: Record<string, string>;
   description?: string;
 }
 
+function handleMarketFetchError(kind: NonNullable<Args['type']>, error: unknown, requestedType: Args['type'], verbose?: boolean): void {
+  const message = error instanceof Error ? error.message : String(error);
+  if (requestedType === kind) {
+    throw new Error(`Failed to fetch ${kind} markets: ${message}`);
+  }
+  if (verbose) {
+    console.error(`Failed to fetch ${kind} markets:`, error);
+  }
+}
+
 async function main() {
   const args = parseArgs();
   const client = getClient();
@@ -202,12 +215,15 @@ async function main() {
             volume24h: parseFloat(side.dayNtlVlm || '0'),
             outcome: market.outcome,
             outcomeSide: side.name,
+            outcomeName: market.name,
+            tokenName: side.tokenName,
+            parsedDescription: market.parsedDescription,
             description: market.description,
           });
         }
       }
     } catch (e) {
-      if (args.verbose) console.error('Failed to fetch HIP-4 outcomes:', e);
+      handleMarketFetchError('outcome', e, args.type, args.verbose);
     }
   }
 

package/scripts/info/search-markets.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env tsx
-// Search Markets - Find specific assets across all providers (perps, HIP-3, spot)
+// Search Markets - Find specific assets across all providers (perps, HIP-3, spot, HIP-4)
 
 import { getClient } from '../core/client.js';
 
@@ -85,6 +85,16 @@ function formatFunding(rate: string): string {
   return `${sign}${annualized.toFixed(2)}%`;
 }
 
+function handleMarketFetchError(kind: NonNullable<Args['type']>, error: unknown, requestedType: Args['type'], verbose?: boolean): void {
+  const message = error instanceof Error ? error.message : String(error);
+  if (requestedType === kind) {
+    throw new Error(`Failed to fetch ${kind} markets: ${message}`);
+  }
+  if (verbose) {
+    console.error(`Failed to fetch ${kind} markets:`, error);
+  }
+}
+
 async function main() {
   const args = parseArgs();
   const client = getClient();
@@ -107,6 +117,9 @@ async function main() {
     openInterest?: string;
     outcome?: number;
     outcomeSide?: string;
+    outcomeName?: string;
+    tokenName?: string;
+    parsedDescription?: Record<string, string>;
     description?: string;
   }
 
@@ -247,12 +260,15 @@ async function main() {
             volume24h: parseFloat(side.dayNtlVlm || '0'),
             outcome: market.outcome,
             outcomeSide: side.name,
+            outcomeName: market.name,
+            tokenName: side.tokenName,
+            parsedDescription: market.parsedDescription,
             description: market.description,
           });
         }
       }
     } catch (e) {
-      if (args.verbose) console.error('Failed to fetch HIP-4 outcomes:', e);
+      handleMarketFetchError('outcome', e, args.type, args.verbose);
     }
   }