openbroker 1.0.65 → 1.0.67

package/README.md

@@ -172,10 +172,12 @@ openbroker fills --coin BTC --side buy --top 50
 
 #### `orders` — Order History
 
-View all historical orders including filled, canceled, and rejected.
+View all historical orders including filled, canceled, and rejected. Use `--open` to show only currently open orders.
 
 ```bash
 openbroker orders                         # Recent orders
+openbroker orders --open                  # Currently open orders only
+openbroker orders --open --coin ETH       # Open orders for a specific coin
 openbroker orders --coin ETH --status filled
 openbroker orders --top 50
 ```
@@ -184,6 +186,7 @@ openbroker orders --top 50
 |------|-------------|---------|
 | `--coin` | Filter by coin symbol | — |
 | `--status` | Filter by status (filled, canceled, open, triggered, etc.) | — |
+| `--open` | Show only currently open orders | — |
 | `--top` | Number of recent orders to show | `20` |
 
 #### `order-status` — Check Order Status

package/SKILL.md

@@ -4,7 +4,7 @@ description: Hyperliquid trading plugin with background position monitoring and
 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.65", "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.67", "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 ob_auto_run ob_auto_stop ob_auto_list Bash(openbroker:*)
 ---
 
@@ -100,7 +100,7 @@ The simplest setup for agents. A fresh wallet is generated, the builder fee is a
 **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/
+3. Fund the wallet by sending USDC from your Hyperliquid account to the agent's wallet address using the **Send** feature on https://app.hyperliquid.xyz/. **Funding should be done on Hyperliquid L1 only.**
 4. Start trading
 
 ### API Wallet Setup (Alternative)
@@ -177,6 +177,8 @@ openbroker fills --coin BTC --side buy --top 50
 ### Order History
 ```bash
 openbroker orders                         # Recent orders (all statuses)
+openbroker orders --open                  # Currently open orders only
+openbroker orders --open --coin ETH       # Open orders for a specific coin
 openbroker orders --coin ETH --status filled
 openbroker orders --top 50
 ```
@@ -912,15 +914,32 @@ openbroker auto status                      # Show running automations
 | `--id <name>` | Custom automation ID | filename |
 | `--poll <ms>` | Poll interval in milliseconds | 10000 |
 
-**Important notes for agents writing automations:**
-- Always test with `--dry` first before live trading
-- Use `api.state` to track position state across restarts
-- Use `api.onStop()` to clean up — close positions, cancel orders
-- Use `api.publish()` to send alerts/events back to the OpenClaw agent — do NOT manually construct webhook requests
-- The runtime catches errors per handler — one failing handler won't crash others
-- Scripts are loaded from `~/.openbroker/automations/` by name, or from any absolute path
-- All trading commands support HIP-3 assets (`api.client.marketOrder('xyz:CL', true, 1)`)
-- Automations persist across gateway restarts — they are automatically restarted when the gateway comes back up
+**Guidelines for agents writing automations:**
+
+**Risk & Safety (mandatory):**
+- Always attach a liquidation monitoring automation to every open position. Subscribe to `margin_warning` and `pnl_threshold` events so the user is never blindsided by liquidation risk. If no margin/liquidation automation is already running, create one before placing trades.
+- Use `api.publish()` to notify the user of important events — position opens/closes, TP/SL triggers, large PnL swings, margin warnings, errors, and any situation that requires human attention. Do NOT silently handle critical events.
+- Always register an `api.onStop()` handler to clean up — cancel open orders and close positions (or at minimum alert the user) on shutdown. Never leave orphaned orders or unmanaged positions.
+- Do NOT use `--dry` unless the user explicitly asks for it. Automations should run live by default.
+- Never place trades without validating that sufficient margin is available. Check account state before sizing orders.
+- Cap position sizes relative to account equity. Do not risk more than a reasonable percentage of equity on a single trade unless the user explicitly specifies the size.
+- Always set TP/SL on new positions — either within the automation or by confirming the user has them set. Unprotected positions are a liability.
+
+**State & Reliability:**
+- Use `api.state` to track position state, entry prices, and flags across restarts. Never rely on in-memory variables alone — automations persist across gateway restarts and are automatically restarted.
+- Use idempotency guards (`api.state.get`/`set`) to prevent duplicate orders. Events can fire multiple times for the same condition across polls — always check state before placing orders.
+- The runtime catches errors per handler — one failing handler won't crash others, but always handle expected errors (e.g. order rejection, insufficient margin) gracefully within handlers.
+
+**Communication:**
+- Use `api.publish()` to send alerts/events back to the OpenClaw agent — do NOT manually construct webhook requests.
+- Publish on: position opened/closed, TP/SL triggered, PnL threshold exceeded, margin warning, automation errors, and any automated trade execution. The user should always know what the automation did and why.
+- Include actionable context in publish messages — coin, price, size, PnL, and what happened — so the user can make informed decisions without checking the terminal.
+
+**General:**
+- Scripts are loaded from `~/.openbroker/automations/` by name, or from any absolute path.
+- All trading commands support HIP-3 assets (`api.client.marketOrder('xyz:CL', true, 1)`).
+- Automations persist across gateway restarts — they are automatically restarted when the gateway comes back up.
+- Prefer `api.every(ms, fn)` over `tick` for periodic tasks with intervals longer than the poll cycle.
 
 ## Risk Warning
 

package/openclaw.plugin.json

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

package/package.json

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

package/scripts/core/client.ts

@@ -1221,8 +1221,28 @@ export class HyperliquidClient {
 
   async getOpenOrders(user?: string): Promise<OpenOrder[]> {
     this.log('Fetching openOrders for:', user ?? this.address);
-    const response = await this.info.openOrders({ user: user ?? this.address });
-    return response as OpenOrder[];
+    await this.getMetaAndAssetCtxs(); // Ensure HIP-3 dex list is loaded
+
+    // Fetch main dex orders
+    const orders = await this.info.openOrders({ user: user ?? this.address }) as OpenOrder[];
+
+    // Fetch HIP-3 dex orders
+    const dexs = await this.getPerpDexs();
+    for (let i = 1; i < dexs.length; i++) {
+      const dex = dexs[i];
+      if (!dex) continue;
+      try {
+        const dexOrders = await this.info.openOrders({ user: user ?? this.address, dex: dex.name }) as OpenOrder[];
+        if (dexOrders.length > 0) {
+          this.log(`Found ${dexOrders.length} open orders on HIP-3 dex ${dex.name}`);
+          orders.push(...dexOrders);
+        }
+      } catch (err) {
+        this.log(`Failed to fetch open orders for dex ${dex.name}:`, err instanceof Error ? err.message : String(err));
+      }
+    }
+
+    return orders;
   }
 
   // ============ Trading ============

package/scripts/info/orders.ts

@@ -11,11 +11,14 @@ Usage: openbroker orders [options]
 Options:
   --coin <symbol>     Filter by coin (e.g. ETH, BTC)
   --status <status>   Filter by status (filled, canceled, open, triggered, rejected, etc.)
+  --open              Show only currently open orders
   --top <n>           Show last N orders (default: 20)
   --help, -h          Show this help
 
 Examples:
   openbroker orders
+  openbroker orders --open
+  openbroker orders --open --coin ETH
   openbroker orders --coin ETH --status filled
   openbroker orders --top 50
 `);
@@ -31,11 +34,78 @@ async function main() {
 
   const filterCoin = args.coin as string | undefined;
   const filterStatus = args.status as string | undefined;
+  const openOnly = args.open as boolean;
   const top = parseInt(args.top as string) || 20;
   const jsonOutput = args.json as boolean;
   const client = getClient();
 
   try {
+    if (openOnly) {
+      // Use the dedicated open orders endpoint
+      let openOrders = await client.getOpenOrders();
+
+      if (filterCoin) {
+        openOrders = openOrders.filter(o => o.coin === normalizeCoin(filterCoin));
+      }
+
+      openOrders.sort((a, b) => b.timestamp - a.timestamp);
+      openOrders = openOrders.slice(0, top);
+
+      if (jsonOutput) {
+        console.log(JSON.stringify(openOrders.map(o => ({
+          time: new Date(o.timestamp).toISOString(),
+          coin: o.coin,
+          side: o.side === 'B' ? 'buy' : 'sell',
+          orderType: o.orderType,
+          size: o.sz,
+          origSize: o.origSz,
+          price: o.limitPx,
+          status: 'open',
+          oid: o.oid,
+        })), null, 2));
+        return;
+      }
+
+      console.log('Open Broker - Open Orders');
+      console.log('=========================\n');
+
+      if (openOrders.length === 0) {
+        console.log('No open orders found');
+        return;
+      }
+
+      // Table header
+      console.log(
+        'Time'.padEnd(20) +
+        'Coin'.padEnd(10) +
+        'Side'.padEnd(6) +
+        'Type'.padEnd(14) +
+        'Size'.padEnd(12) +
+        'Price'.padEnd(14) +
+        'OID'
+      );
+      console.log('─'.repeat(90));
+
+      for (const o of openOrders) {
+        const time = new Date(o.timestamp).toLocaleString();
+        const side = o.side === 'B' ? 'BUY' : 'SELL';
+
+        console.log(
+          time.padEnd(20) +
+          o.coin.padEnd(10) +
+          side.padEnd(6) +
+          o.orderType.padEnd(14) +
+          o.sz.padEnd(12) +
+          formatUsd(parseFloat(o.limitPx)).padEnd(14) +
+          String(o.oid)
+        );
+      }
+
+      console.log('─'.repeat(90));
+      console.log(`Showing ${openOrders.length} open orders`);
+      return;
+    }
+
     let orders = await client.getHistoricalOrders();
 
     if (filterCoin) {

package/scripts/plugin/tools.ts

@@ -491,18 +491,48 @@ export function createTools(watcherOrCtx: PositionWatcher | null | ToolsContext)
 
     {
       name: 'ob_orders',
-      description: 'View order history with status (filled, canceled, open, etc.)',
+      description: 'View order history with status (filled, canceled, open, etc.). Use open_only to get currently open orders.',
       parameters: {
         type: 'object',
         properties: {
           coin: { type: 'string', description: 'Filter by coin symbol' },
           status: { type: 'string', description: 'Filter by status (filled, canceled, open, etc.)' },
+          open_only: { type: 'boolean', description: 'If true, return only currently open orders (uses dedicated endpoint)' },
           top: { type: 'number', description: 'Number of recent orders (default: 20)' },
         },
       },
       async execute(_id, params) {
         const { getClient } = await import('../core/client.js');
         const client = getClient();
+        const top = (params.top as number) || 20;
+
+        if (params.open_only) {
+          let openOrders = await client.getOpenOrders();
+
+          if (params.coin) {
+            const coin = normalizeCoin(params.coin as string);
+            openOrders = openOrders.filter(o => o.coin === coin);
+          }
+
+          openOrders.sort((a, b) => b.timestamp - a.timestamp);
+          openOrders = openOrders.slice(0, top);
+
+          return json({
+            address: client.address,
+            orders: openOrders.map(o => ({
+              coin: o.coin,
+              side: o.side === 'B' ? 'buy' : 'sell',
+              size: o.sz,
+              origSize: o.origSz,
+              price: o.limitPx,
+              orderType: o.orderType,
+              oid: o.oid,
+              status: 'open',
+              timestamp: o.timestamp,
+            })),
+          });
+        }
+
         let orders = await client.getHistoricalOrders();
 
         if (params.coin) {
@@ -515,7 +545,6 @@ export function createTools(watcherOrCtx: PositionWatcher | null | ToolsContext)
         }
 
         orders.sort((a, b) => b.order.timestamp - a.order.timestamp);
-        const top = (params.top as number) || 20;
         orders = orders.slice(0, top);
 
         return json({