@0xarchive/sdk 0.9.2 → 1.3.0

package/dist/index.js

@@ -39,6 +39,8 @@ __export(index_exports, {
   InstrumentResponseSchema: () => InstrumentResponseSchema,
   InstrumentSchema: () => InstrumentSchema,
   InstrumentTypeSchema: () => InstrumentTypeSchema,
+  L2OrderBookResource: () => L2OrderBookResource,
+  L4OrderBookReconstructor: () => L4OrderBookReconstructor,
   LighterClient: () => LighterClient,
   LiquidationArrayResponseSchema: () => LiquidationArrayResponseSchema,
   LiquidationSchema: () => LiquidationSchema,
@@ -772,15 +774,15 @@ var OrderBookResource = class {
     this.coinTransform = coinTransform;
   }
   /**
-   * Get order book snapshot for a coin
+   * Get order book snapshot for a symbol
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @param params - Optional parameters
    * @returns Order book snapshot
    */
-  async get(coin, params) {
+  async get(symbol, params) {
     const response = await this.http.get(
-      `${this.basePath}/orderbook/${this.coinTransform(coin)}`,
+      `${this.basePath}/orderbook/${this.coinTransform(symbol)}`,
       params,
       this.http.validationEnabled ? OrderBookResponseSchema : void 0
     );
@@ -789,7 +791,7 @@ var OrderBookResource = class {
   /**
    * Get historical order book snapshots with cursor-based pagination
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @param params - Time range and cursor pagination parameters (start and end are required)
    * @returns CursorResponse with order book snapshots and nextCursor for pagination
    *
@@ -813,9 +815,9 @@ var OrderBookResource = class {
    * }
    * ```
    */
-  async history(coin, params) {
+  async history(symbol, params) {
     const response = await this.http.get(
-      `${this.basePath}/orderbook/${this.coinTransform(coin)}/history`,
+      `${this.basePath}/orderbook/${this.coinTransform(symbol)}/history`,
       params,
       this.http.validationEnabled ? OrderBookArrayResponseSchema : void 0
     );
@@ -833,7 +835,7 @@ var OrderBookResource = class {
    *
    * For automatic reconstruction, use `historyReconstructed()` instead.
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @param params - Time range parameters
    * @returns Tick data with checkpoint and deltas
    *
@@ -853,9 +855,9 @@ var OrderBookResource = class {
    * }
    * ```
    */
-  async historyTick(coin, params) {
+  async historyTick(symbol, params) {
     const response = await this.http.get(
-      `${this.basePath}/orderbook/${this.coinTransform(coin)}/history`,
+      `${this.basePath}/orderbook/${this.coinTransform(symbol)}/history`,
       {
         ...params,
         granularity: "tick"
@@ -880,7 +882,7 @@ var OrderBookResource = class {
    * For large time ranges, consider using `historyTick()` with the
    * `OrderBookReconstructor.iterate()` method for memory efficiency.
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @param params - Time range parameters
    * @param options - Reconstruction options
    * @returns Array of reconstructed orderbook snapshots
@@ -904,8 +906,8 @@ var OrderBookResource = class {
    * );
    * ```
    */
-  async historyReconstructed(coin, params, options = {}) {
-    const tickData = await this.historyTick(coin, params);
+  async historyReconstructed(symbol, params, options = {}) {
+    const tickData = await this.historyTick(symbol, params);
     const reconstructor = new OrderBookReconstructor();
     return reconstructor.reconstructAll(tickData.checkpoint, tickData.deltas, options);
   }
@@ -945,7 +947,7 @@ var OrderBookResource = class {
    * per API request and yielding reconstructed orderbook snapshots one at a time.
    * Memory-efficient for processing large time ranges.
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @param params - Time range parameters
    * @param depth - Maximum price levels to include in output snapshots
    * @yields Reconstructed orderbook snapshots
@@ -968,7 +970,7 @@ var OrderBookResource = class {
    * }
    * ```
    */
-  async *iterateTickHistory(coin, params, depth) {
+  async *iterateTickHistory(symbol, params, depth) {
     const startTs = typeof params.start === "string" ? new Date(params.start).getTime() : params.start;
     const endTs = typeof params.end === "string" ? new Date(params.end).getTime() : params.end;
     let cursor = startTs;
@@ -976,7 +978,7 @@ var OrderBookResource = class {
     const MAX_DELTAS_PER_PAGE = 1e3;
     let isFirstPage = true;
     while (cursor < endTs) {
-      const tickData = await this.historyTick(coin, {
+      const tickData = await this.historyTick(symbol, {
         start: cursor,
         end: endTs,
         depth: params.depth
@@ -1014,12 +1016,12 @@ var TradesResource = class {
     this.coinTransform = coinTransform;
   }
   /**
-   * Get trade history for a coin using cursor-based pagination
+   * Get trade history for a symbol using cursor-based pagination
    *
    * Uses cursor-based pagination by default, which is more efficient for large datasets.
    * Use the `nextCursor` from the response as the `cursor` parameter to get the next page.
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @param params - Time range and cursor pagination parameters (start and end are required)
    * @returns Object with trades array and nextCursor for pagination
    *
@@ -1043,9 +1045,9 @@ var TradesResource = class {
    * }
    * ```
    */
-  async list(coin, params) {
+  async list(symbol, params) {
     const response = await this.http.get(
-      `${this.basePath}/trades/${this.coinTransform(coin)}`,
+      `${this.basePath}/trades/${this.coinTransform(symbol)}`,
       params,
       this.http.validationEnabled ? TradeArrayResponseSchema : void 0
     );
@@ -1055,20 +1057,20 @@ var TradesResource = class {
     };
   }
   /**
-   * Get most recent trades for a coin.
+   * Get most recent trades for a symbol.
    *
    * Note: This method is available for Lighter (client.lighter.trades.recent())
    * and HIP-3 (client.hyperliquid.hip3.trades.recent()) which have real-time data
    * ingestion. Hyperliquid uses hourly backfill so this endpoint is not available
    * for Hyperliquid.
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @param limit - Number of trades to return (default: 100)
    * @returns Array of recent trades
    */
-  async recent(coin, limit) {
+  async recent(symbol, limit) {
     const response = await this.http.get(
-      `${this.basePath}/trades/${this.coinTransform(coin)}/recent`,
+      `${this.basePath}/trades/${this.coinTransform(symbol)}/recent`,
       { limit },
       this.http.validationEnabled ? TradeArrayResponseSchema : void 0
     );
@@ -1180,15 +1182,15 @@ var FundingResource = class {
     this.coinTransform = coinTransform;
   }
   /**
-   * Get funding rate history for a coin with cursor-based pagination
+   * Get funding rate history for a symbol with cursor-based pagination
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @param params - Time range and cursor pagination parameters (start and end are required)
    * @returns CursorResponse with funding rate records and nextCursor for pagination
    */
-  async history(coin, params) {
+  async history(symbol, params) {
     const response = await this.http.get(
-      `${this.basePath}/funding/${this.coinTransform(coin)}`,
+      `${this.basePath}/funding/${this.coinTransform(symbol)}`,
       params,
       this.http.validationEnabled ? FundingRateArrayResponseSchema : void 0
     );
@@ -1198,14 +1200,14 @@ var FundingResource = class {
     };
   }
   /**
-   * Get current funding rate for a coin
+   * Get current funding rate for a symbol
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @returns Current funding rate
    */
-  async current(coin) {
+  async current(symbol) {
     const response = await this.http.get(
-      `${this.basePath}/funding/${this.coinTransform(coin)}/current`,
+      `${this.basePath}/funding/${this.coinTransform(symbol)}/current`,
       void 0,
       this.http.validationEnabled ? FundingRateResponseSchema : void 0
     );
@@ -1221,15 +1223,15 @@ var OpenInterestResource = class {
     this.coinTransform = coinTransform;
   }
   /**
-   * Get open interest history for a coin with cursor-based pagination
+   * Get open interest history for a symbol with cursor-based pagination
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @param params - Time range and cursor pagination parameters (start and end are required)
    * @returns CursorResponse with open interest records and nextCursor for pagination
    */
-  async history(coin, params) {
+  async history(symbol, params) {
     const response = await this.http.get(
-      `${this.basePath}/openinterest/${this.coinTransform(coin)}`,
+      `${this.basePath}/openinterest/${this.coinTransform(symbol)}`,
       params,
       this.http.validationEnabled ? OpenInterestArrayResponseSchema : void 0
     );
@@ -1239,14 +1241,14 @@ var OpenInterestResource = class {
     };
   }
   /**
-   * Get current open interest for a coin
+   * Get current open interest for a symbol
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @returns Current open interest
    */
-  async current(coin) {
+  async current(symbol) {
     const response = await this.http.get(
-      `${this.basePath}/openinterest/${this.coinTransform(coin)}/current`,
+      `${this.basePath}/openinterest/${this.coinTransform(symbol)}/current`,
       void 0,
       this.http.validationEnabled ? OpenInterestResponseSchema : void 0
     );
@@ -1264,13 +1266,13 @@ var CandlesResource = class {
   /**
    * Get historical OHLCV candle data with cursor-based pagination
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @param params - Time range, interval, and cursor pagination parameters (start and end are required)
    * @returns CursorResponse with candle records and nextCursor for pagination
    */
-  async history(coin, params) {
+  async history(symbol, params) {
     const response = await this.http.get(
-      `${this.basePath}/candles/${this.coinTransform(coin)}`,
+      `${this.basePath}/candles/${this.coinTransform(symbol)}`,
       params,
       this.http.validationEnabled ? CandleArrayResponseSchema : void 0
     );
@@ -1283,20 +1285,21 @@ var CandlesResource = class {
 
 // src/resources/liquidations.ts
 var LiquidationsResource = class {
-  constructor(http, basePath = "/v1") {
+  constructor(http, basePath = "/v1", coinTransform = (c) => c.toUpperCase()) {
     this.http = http;
     this.basePath = basePath;
+    this.coinTransform = coinTransform;
   }
   /**
-   * Get liquidation history for a coin with cursor-based pagination
+   * Get liquidation history for a symbol with cursor-based pagination
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @param params - Time range and cursor pagination parameters (start and end are required)
    * @returns CursorResponse with liquidation records and nextCursor for pagination
    */
-  async history(coin, params) {
+  async history(symbol, params) {
     const response = await this.http.get(
-      `${this.basePath}/liquidations/${coin.toUpperCase()}`,
+      `${this.basePath}/liquidations/${this.coinTransform(symbol)}`,
       params,
       this.http.validationEnabled ? LiquidationArrayResponseSchema : void 0
     );
@@ -1333,13 +1336,13 @@ var LiquidationsResource = class {
    * Returns pre-aggregated data with total/long/short USD volumes per bucket,
    * reducing data transfer by 100-1000x compared to individual liquidation records.
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @param params - Time range, cursor, and interval parameters
    * @returns CursorResponse with liquidation volume buckets
    */
-  async volume(coin, params) {
+  async volume(symbol, params) {
     const response = await this.http.get(
-      `${this.basePath}/liquidations/${coin.toUpperCase()}/volume`,
+      `${this.basePath}/liquidations/${this.coinTransform(symbol)}/volume`,
       params,
       this.http.validationEnabled ? LiquidationVolumeArrayResponseSchema : void 0
     );
@@ -1686,6 +1689,190 @@ var Web3Resource = class {
   }
 };
 
+// src/resources/orders.ts
+var OrdersResource = class {
+  constructor(http, basePath = "/v1", coinTransform = (c) => c.toUpperCase()) {
+    this.http = http;
+    this.basePath = basePath;
+    this.coinTransform = coinTransform;
+  }
+  /**
+   * Get order history for a symbol with cursor-based pagination
+   *
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
+   * @param params - Time range, cursor pagination, and filter parameters
+   * @returns CursorResponse with order records and nextCursor for pagination
+   */
+  async history(symbol, params) {
+    const response = await this.http.get(
+      `${this.basePath}/orders/${this.coinTransform(symbol)}/history`,
+      params
+    );
+    return { data: response.data, nextCursor: response.meta.nextCursor };
+  }
+  /**
+   * Get order flow for a symbol
+   *
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
+   * @param params - Time range and interval parameters
+   * @returns CursorResponse with order flow records
+   */
+  async flow(symbol, params) {
+    const response = await this.http.get(
+      `${this.basePath}/orders/${this.coinTransform(symbol)}/flow`,
+      params
+    );
+    return { data: response.data, nextCursor: response.meta.nextCursor };
+  }
+  /**
+   * Get TP/SL orders for a symbol with cursor-based pagination
+   *
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
+   * @param params - Time range, cursor pagination, and filter parameters
+   * @returns CursorResponse with TP/SL order records
+   */
+  async tpsl(symbol, params) {
+    const response = await this.http.get(
+      `${this.basePath}/orders/${this.coinTransform(symbol)}/tpsl`,
+      params
+    );
+    return { data: response.data, nextCursor: response.meta.nextCursor };
+  }
+};
+
+// src/resources/l4-orderbook.ts
+var L4OrderBookResource = class {
+  constructor(http, basePath = "/v1", coinTransform = (c) => c.toUpperCase()) {
+    this.http = http;
+    this.basePath = basePath;
+    this.coinTransform = coinTransform;
+  }
+  /**
+   * Get L4 order book snapshot for a symbol
+   *
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
+   * @param params - Optional parameters (timestamp, depth)
+   * @returns L4 order book snapshot
+   */
+  async get(symbol, params) {
+    const response = await this.http.get(
+      `${this.basePath}/orderbook/${this.coinTransform(symbol)}/l4`,
+      params
+    );
+    return response.data;
+  }
+  /**
+   * Get L4 order book diffs with cursor-based pagination
+   *
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
+   * @param params - Time range and cursor pagination parameters
+   * @returns CursorResponse with L4 orderbook diffs and nextCursor for pagination
+   */
+  async diffs(symbol, params) {
+    const response = await this.http.get(
+      `${this.basePath}/orderbook/${this.coinTransform(symbol)}/l4/diffs`,
+      params
+    );
+    return { data: response.data, nextCursor: response.meta.nextCursor };
+  }
+  /**
+   * Get L4 order book history with cursor-based pagination
+   *
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
+   * @param params - Time range and cursor pagination parameters
+   * @returns CursorResponse with L4 orderbook snapshots and nextCursor for pagination
+   */
+  async history(symbol, params) {
+    const response = await this.http.get(
+      `${this.basePath}/orderbook/${this.coinTransform(symbol)}/l4/history`,
+      params
+    );
+    return { data: response.data, nextCursor: response.meta.nextCursor };
+  }
+};
+
+// src/resources/l2-orderbook.ts
+var L2OrderBookResource = class {
+  constructor(http, basePath = "/v1", coinTransform = (c) => c.toUpperCase()) {
+    this.http = http;
+    this.basePath = basePath;
+    this.coinTransform = coinTransform;
+  }
+  /** Get full-depth L2 order book snapshot. */
+  async get(symbol, params) {
+    const coin = this.coinTransform(symbol);
+    const query = {};
+    if (params?.timestamp != null) query.timestamp = params.timestamp;
+    if (params?.depth != null) query.depth = params.depth;
+    const resp = await this.http.get(
+      `${this.basePath}/orderbook/${encodeURIComponent(coin)}/l2`,
+      query
+    );
+    return resp.data;
+  }
+  /** Get paginated L2 full-depth history. */
+  async history(symbol, params) {
+    const coin = this.coinTransform(symbol);
+    const resp = await this.http.get(
+      `${this.basePath}/orderbook/${encodeURIComponent(coin)}/l2/history`,
+      params
+    );
+    return {
+      data: resp.data,
+      nextCursor: resp.meta?.next_cursor ?? void 0
+    };
+  }
+  /** Get tick-level L2 order book diffs. */
+  async diffs(symbol, params) {
+    const coin = this.coinTransform(symbol);
+    const resp = await this.http.get(
+      `${this.basePath}/orderbook/${encodeURIComponent(coin)}/l2/diffs`,
+      params
+    );
+    return {
+      data: resp.data,
+      nextCursor: resp.meta?.next_cursor ?? void 0
+    };
+  }
+};
+
+// src/resources/l3-orderbook.ts
+var L3OrderBookResource = class {
+  constructor(http, basePath = "/v1", coinTransform = (c) => c.toUpperCase()) {
+    this.http = http;
+    this.basePath = basePath;
+    this.coinTransform = coinTransform;
+  }
+  /**
+   * Get L3 order book snapshot for a symbol
+   *
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
+   * @param params - Optional parameters (timestamp, depth)
+   * @returns L3 order book snapshot
+   */
+  async get(symbol, params) {
+    const response = await this.http.get(
+      `${this.basePath}/l3orderbook/${this.coinTransform(symbol)}`,
+      params
+    );
+    return response.data;
+  }
+  /**
+   * Get L3 order book history with cursor-based pagination
+   *
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
+   * @param params - Time range and cursor pagination parameters
+   * @returns CursorResponse with L3 orderbook snapshots and nextCursor for pagination
+   */
+  async history(symbol, params) {
+    const response = await this.http.get(
+      `${this.basePath}/l3orderbook/${this.coinTransform(symbol)}/history`,
+      params
+    );
+    return { data: response.data, nextCursor: response.meta.nextCursor };
+  }
+};
+
 // src/exchanges.ts
 var HyperliquidClient = class {
   /**
@@ -1716,6 +1903,18 @@ var HyperliquidClient = class {
    * Liquidation events (May 2025+)
    */
   liquidations;
+  /**
+   * Order history, flow, and TP/SL
+   */
+  orders;
+  /**
+   * L4 order book (snapshots, diffs, history)
+   */
+  l4Orderbook;
+  /**
+   * L2 full-depth order book (derived from L4)
+   */
+  l2Orderbook;
   /**
    * HIP-3 builder-deployed perpetuals (February 2026+)
    */
@@ -1731,17 +1930,20 @@ var HyperliquidClient = class {
     this.openInterest = new OpenInterestResource(http, basePath);
     this.candles = new CandlesResource(http, basePath);
     this.liquidations = new LiquidationsResource(http, basePath);
+    this.orders = new OrdersResource(http, basePath);
+    this.l4Orderbook = new L4OrderBookResource(http, basePath);
+    this.l2Orderbook = new L2OrderBookResource(http, basePath);
     this.hip3 = new Hip3Client(http);
   }
   /**
-   * Get per-coin data freshness across all data types
+   * Get per-symbol data freshness across all data types
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
-   * @returns Per-coin freshness with last_updated and lag_ms for each data type
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
+   * @returns Per-symbol freshness with last_updated and lag_ms for each data type
    */
-  async freshness(coin) {
+  async freshness(symbol) {
     const response = await this.http.get(
-      `/v1/hyperliquid/freshness/${coin.toUpperCase()}`,
+      `/v1/hyperliquid/freshness/${symbol.toUpperCase()}`,
       void 0,
       this.http.validationEnabled ? CoinFreshnessResponseSchema : void 0
     );
@@ -1750,12 +1952,12 @@ var HyperliquidClient = class {
   /**
    * Get combined market summary (price, funding, OI, volume, liquidations) in one call
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @returns Combined market summary
    */
-  async summary(coin) {
+  async summary(symbol) {
     const response = await this.http.get(
-      `/v1/hyperliquid/summary/${coin.toUpperCase()}`,
+      `/v1/hyperliquid/summary/${symbol.toUpperCase()}`,
       void 0,
       this.http.validationEnabled ? CoinSummaryResponseSchema : void 0
     );
@@ -1764,13 +1966,13 @@ var HyperliquidClient = class {
   /**
    * Get mark/oracle/mid price history (projected from OI data)
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @param params - Time range, cursor, and interval parameters
    * @returns CursorResponse with price snapshots
    */
-  async priceHistory(coin, params) {
+  async priceHistory(symbol, params) {
     const response = await this.http.get(
-      `/v1/hyperliquid/prices/${coin.toUpperCase()}`,
+      `/v1/hyperliquid/prices/${symbol.toUpperCase()}`,
       params,
       this.http.validationEnabled ? PriceSnapshotArrayResponseSchema : void 0
     );
@@ -1805,6 +2007,22 @@ var Hip3Client = class {
    * OHLCV candle data
    */
   candles;
+  /**
+   * Liquidation events
+   */
+  liquidations;
+  /**
+   * Order history, flow, and TP/SL
+   */
+  orders;
+  /**
+   * L4 order book (snapshots, diffs, history)
+   */
+  l4Orderbook;
+  /**
+   * L2 full-depth order book (derived from L4)
+   */
+  l2Orderbook;
   http;
   constructor(http) {
     this.http = http;
@@ -1816,16 +2034,20 @@ var Hip3Client = class {
     this.funding = new FundingResource(http, basePath, coinTransform);
     this.openInterest = new OpenInterestResource(http, basePath, coinTransform);
     this.candles = new CandlesResource(http, basePath, coinTransform);
+    this.liquidations = new LiquidationsResource(http, basePath, coinTransform);
+    this.orders = new OrdersResource(http, basePath, coinTransform);
+    this.l4Orderbook = new L4OrderBookResource(http, basePath, coinTransform);
+    this.l2Orderbook = new L2OrderBookResource(http, basePath, coinTransform);
   }
   /**
-   * Get per-coin data freshness across all data types
+   * Get per-symbol data freshness across all data types
    *
-   * @param coin - The coin symbol (case-sensitive, e.g., 'km:US500')
-   * @returns Per-coin freshness with last_updated and lag_ms for each data type
+   * @param symbol - The symbol (case-sensitive, e.g., 'km:US500')
+   * @returns Per-symbol freshness with last_updated and lag_ms for each data type
    */
-  async freshness(coin) {
+  async freshness(symbol) {
     const response = await this.http.get(
-      `/v1/hyperliquid/hip3/freshness/${coin}`,
+      `/v1/hyperliquid/hip3/freshness/${symbol}`,
       void 0,
       this.http.validationEnabled ? CoinFreshnessResponseSchema : void 0
     );
@@ -1834,12 +2056,12 @@ var Hip3Client = class {
   /**
    * Get combined market summary (price, funding, OI) in one call
    *
-   * @param coin - The coin symbol (case-sensitive, e.g., 'km:US500')
+   * @param symbol - The symbol (case-sensitive, e.g., 'km:US500')
    * @returns Combined market summary
    */
-  async summary(coin) {
+  async summary(symbol) {
     const response = await this.http.get(
-      `/v1/hyperliquid/hip3/summary/${coin}`,
+      `/v1/hyperliquid/hip3/summary/${symbol}`,
       void 0,
       this.http.validationEnabled ? CoinSummaryResponseSchema : void 0
     );
@@ -1848,13 +2070,13 @@ var Hip3Client = class {
   /**
    * Get mark/oracle/mid price history (projected from OI data)
    *
-   * @param coin - The coin symbol (case-sensitive, e.g., 'km:US500')
+   * @param symbol - The symbol (case-sensitive, e.g., 'km:US500')
    * @param params - Time range, cursor, and interval parameters
    * @returns CursorResponse with price snapshots
    */
-  async priceHistory(coin, params) {
+  async priceHistory(symbol, params) {
     const response = await this.http.get(
-      `/v1/hyperliquid/hip3/prices/${coin}`,
+      `/v1/hyperliquid/hip3/prices/${symbol}`,
       params,
       this.http.validationEnabled ? PriceSnapshotArrayResponseSchema : void 0
     );
@@ -1889,6 +2111,10 @@ var LighterClient = class {
    * OHLCV candle data
    */
   candles;
+  /**
+   * L3 order book (Lighter only)
+   */
+  l3Orderbook;
   http;
   constructor(http) {
     this.http = http;
@@ -1899,16 +2125,17 @@ var LighterClient = class {
     this.funding = new FundingResource(http, basePath);
     this.openInterest = new OpenInterestResource(http, basePath);
     this.candles = new CandlesResource(http, basePath);
+    this.l3Orderbook = new L3OrderBookResource(http, basePath);
   }
   /**
-   * Get per-coin data freshness across all data types
+   * Get per-symbol data freshness across all data types
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
-   * @returns Per-coin freshness with last_updated and lag_ms for each data type
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
+   * @returns Per-symbol freshness with last_updated and lag_ms for each data type
    */
-  async freshness(coin) {
+  async freshness(symbol) {
     const response = await this.http.get(
-      `/v1/lighter/freshness/${coin.toUpperCase()}`,
+      `/v1/lighter/freshness/${symbol.toUpperCase()}`,
       void 0,
       this.http.validationEnabled ? CoinFreshnessResponseSchema : void 0
     );
@@ -1917,12 +2144,12 @@ var LighterClient = class {
   /**
    * Get combined market summary (price, funding, OI) in one call
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @returns Combined market summary
    */
-  async summary(coin) {
+  async summary(symbol) {
     const response = await this.http.get(
-      `/v1/lighter/summary/${coin.toUpperCase()}`,
+      `/v1/lighter/summary/${symbol.toUpperCase()}`,
       void 0,
       this.http.validationEnabled ? CoinSummaryResponseSchema : void 0
     );
@@ -1931,13 +2158,13 @@ var LighterClient = class {
   /**
    * Get mark/oracle price history (projected from OI data)
    *
-   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')
+   * @param symbol - The symbol (e.g., 'BTC', 'ETH')
    * @param params - Time range, cursor, and interval parameters
    * @returns CursorResponse with price snapshots
    */
-  async priceHistory(coin, params) {
+  async priceHistory(symbol, params) {
     const response = await this.http.get(
-      `/v1/lighter/prices/${coin.toUpperCase()}`,
+      `/v1/lighter/prices/${symbol.toUpperCase()}`,
       params,
       this.http.validationEnabled ? PriceSnapshotArrayResponseSchema : void 0
     );
@@ -2690,6 +2917,136 @@ var OxArchiveWs = class {
     }
   }
 };
+
+// src/l4-reconstructor.ts
+var L4OrderBookReconstructor = class {
+  orders = /* @__PURE__ */ new Map();
+  bidPrices = /* @__PURE__ */ new Map();
+  askPrices = /* @__PURE__ */ new Map();
+  /** Initialize from an L4 checkpoint. */
+  loadCheckpoint(checkpoint) {
+    this.orders.clear();
+    this.bidPrices.clear();
+    this.askPrices.clear();
+    for (const order of [...checkpoint.bids, ...checkpoint.asks]) {
+      const oid = order.oid;
+      const price = Number(order.price);
+      const size = Number(order.size);
+      const side = order.side;
+      this.orders.set(oid, {
+        oid,
+        userAddress: order.user_address ?? order.userAddress ?? "",
+        side,
+        price,
+        size
+      });
+      const priceMap = side === "B" ? this.bidPrices : this.askPrices;
+      if (!priceMap.has(price)) priceMap.set(price, /* @__PURE__ */ new Set());
+      priceMap.get(price).add(oid);
+    }
+  }
+  /** Apply a single L4 diff with matching engine. */
+  applyDiff(diff, nonRestingOids) {
+    const dt = diff.diff_type ?? diff.diffType;
+    const oid = diff.oid;
+    if (dt === "new") {
+      if (nonRestingOids?.has(oid)) return;
+      const newSize = diff.new_size ?? diff.newSize;
+      if (newSize == null || newSize <= 0) return;
+      const { side, price } = diff;
+      const sz = newSize;
+      if (side === "B") {
+        for (const [askPx, oids] of this.askPrices) {
+          if (askPx <= price) {
+            for (const crossedOid of oids) this.orders.delete(crossedOid);
+            this.askPrices.delete(askPx);
+          }
+        }
+      } else {
+        for (const [bidPx, oids] of this.bidPrices) {
+          if (bidPx >= price) {
+            for (const crossedOid of oids) this.orders.delete(crossedOid);
+            this.bidPrices.delete(bidPx);
+          }
+        }
+      }
+      this.orders.set(oid, {
+        oid,
+        userAddress: diff.user_address ?? diff.userAddress ?? "",
+        side,
+        price,
+        size: sz
+      });
+      const priceMap = side === "B" ? this.bidPrices : this.askPrices;
+      if (!priceMap.has(price)) priceMap.set(price, /* @__PURE__ */ new Set());
+      priceMap.get(price).add(oid);
+    } else if (dt === "update") {
+      const order = this.orders.get(oid);
+      const updSize = diff.new_size ?? diff.newSize;
+      if (order && updSize != null) {
+        order.size = updSize;
+      }
+    } else if (dt === "remove") {
+      const order = this.orders.get(oid);
+      if (order) {
+        this.orders.delete(oid);
+        const priceMap = order.side === "B" ? this.bidPrices : this.askPrices;
+        const oids = priceMap.get(order.price);
+        if (oids) {
+          oids.delete(oid);
+          if (oids.size === 0) priceMap.delete(order.price);
+        }
+      }
+    }
+  }
+  /** Return bids sorted by price descending. */
+  bids() {
+    return [...this.orders.values()].filter((o) => o.side === "B" && o.size > 0).sort((a, b) => b.price - a.price);
+  }
+  /** Return asks sorted by price ascending. */
+  asks() {
+    return [...this.orders.values()].filter((o) => o.side === "A" && o.size > 0).sort((a, b) => a.price - b.price);
+  }
+  bestBid() {
+    const b = this.bids();
+    return b.length > 0 ? b[0].price : null;
+  }
+  bestAsk() {
+    const a = this.asks();
+    return a.length > 0 ? a[0].price : null;
+  }
+  /** Check if the book is crossed. Should be false after correct reconstruction. */
+  isCrossed() {
+    const bb = this.bestBid();
+    const ba = this.bestAsk();
+    return bb != null && ba != null && bb >= ba;
+  }
+  get bidCount() {
+    return [...this.orders.values()].filter((o) => o.side === "B" && o.size > 0).length;
+  }
+  get askCount() {
+    return [...this.orders.values()].filter((o) => o.side === "A" && o.size > 0).length;
+  }
+  /** Aggregate L4 orders into L2 price levels. */
+  deriveL2() {
+    const bidAgg = /* @__PURE__ */ new Map();
+    const askAgg = /* @__PURE__ */ new Map();
+    for (const o of this.orders.values()) {
+      if (o.size <= 0) continue;
+      const agg = o.side === "B" ? bidAgg : askAgg;
+      const existing = agg.get(o.price);
+      if (existing) {
+        existing.sz += o.size;
+        existing.n += 1;
+      } else {
+        agg.set(o.price, { sz: o.size, n: 1 });
+      }
+    }
+    const bids = [...bidAgg.entries()].sort(([a], [b]) => b - a).map(([px, v]) => ({ px, sz: v.sz, n: v.n }));
+    const asks = [...askAgg.entries()].sort(([a], [b]) => a - b).map(([px, v]) => ({ px, sz: v.sz, n: v.n }));
+    return { bids, asks };
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ApiMetaSchema,
@@ -2711,6 +3068,8 @@ var OxArchiveWs = class {
   InstrumentResponseSchema,
   InstrumentSchema,
   InstrumentTypeSchema,
+  L2OrderBookResource,
+  L4OrderBookReconstructor,
   LighterClient,
   LiquidationArrayResponseSchema,
   LiquidationSchema,