openbroker 1.0.87 → 1.0.88

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.87", "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.88", "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_spot_buy ob_spot_sell ob_twap ob_twap_cancel ob_twap_status ob_bracket ob_chase ob_watcher_status ob_auto_run ob_auto_stop ob_auto_list Bash(openbroker:*)
 ---
 

package/openclaw.plugin.json

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

package/package.json

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

package/scripts/auto/runtime.ts

@@ -597,18 +597,33 @@ export async function startAutomation(options: RuntimeOptions): Promise<RunningA
 
         // Emit order_filled with the authoritative fill delta + fee/pnl from
         // the userFills WS stream. Covers both partial and terminal fills.
+        // Fee is converted to USD using feeToken: for non-USDC fees (spot
+        // buys pay in the received asset), fee × price yields USD since the
+        // fee token is the base of the traded pair and `price` is quote/base.
         if (eventBus.has('order_filled')) {
           const size = parseFloat(fill.sz);
           const price = parseFloat(fill.px);
-          const fee = parseFloat(fill.fee);
+          const rawFee = parseFloat(fill.fee);
           const closedPnl = parseFloat(fill.closedPnl);
+          const feeToken = fill.feeToken;
+          let feeUsd: number | undefined;
+          if (Number.isFinite(rawFee)) {
+            if (feeToken === 'USDC' || !feeToken) {
+              feeUsd = rawFee;
+            } else if (Number.isFinite(price) && price > 0) {
+              feeUsd = rawFee * price;
+            } else {
+              feeUsd = undefined;
+            }
+          }
           void emitAutomationEvent('order_filled', {
             coin: fill.coin,
             oid: fill.oid,
             side: fill.side === 'B' ? 'buy' : 'sell',
             size,
             price,
-            fee: Number.isFinite(fee) ? fee : undefined,
+            fee: feeUsd,
+            feeToken,
             closedPnl: Number.isFinite(closedPnl) ? closedPnl : undefined,
             crossed: fill.crossed,
           }, 'ws');

package/scripts/auto/types.ts

@@ -49,9 +49,14 @@ export interface AutomationEventPayloads {
   /**
    * Fires on every trade fill — partial and terminal — sourced from the
    * Hyperliquid `userFills` WS stream. `size` is the fill delta (NOT remaining
-   * size of the order). `fee` and `closedPnl` are in USD; `crossed` is true
-   * when this side was the taker. Fee/pnl/crossed are optional so that older
-   * consumers that only read coin/oid/side/size/price keep working.
+   * size of the order). `fee` and `closedPnl` are in USD (converted from the
+   * raw fee denomination using `price` when `feeToken !== "USDC"`, which
+   * happens on spot buys where the fee is charged in the received asset).
+   * `feeToken` is the original denomination so consumers can identify legs
+   * that won't carry a builder fee (Hyperliquid only charges builder fees on
+   * USDC-denominated trades). `crossed` is true when this side was the taker.
+   * Fee/pnl/crossed/feeToken are optional so older consumers that only read
+   * coin/oid/side/size/price keep working.
    */
   order_filled: {
     coin: string;
@@ -60,6 +65,7 @@ export interface AutomationEventPayloads {
     size: number;
     price: number;
     fee?: number;
+    feeToken?: string;
     closedPnl?: number;
     crossed?: boolean;
   };

package/scripts/core/ws.ts

@@ -51,6 +51,8 @@ export interface WsEventMap {
     time: number;
     closedPnl: string;
     fee: string;
+    /** Token the fee is denominated in. Spot buys typically pay fee in the base asset (e.g. "HYPE") rather than "USDC"; consumers must convert using `px` to get a USD value. */
+    feeToken: string;
     oid: number;
     crossed: boolean;
   };
@@ -245,6 +247,7 @@ export class WebSocketManager {
           time: fill.time,
           closedPnl: fill.closedPnl,
           fee: fill.fee,
+          feeToken: fill.feeToken,
           oid: fill.oid,
           crossed: fill.crossed,
         });