@0xarchive/sdk 0.9.1 → 1.2.0

package/dist/index.mjs

@@ -45,6 +45,14 @@ var HttpClient = class {
   get validationEnabled() {
     return this.validate;
   }
+  /** Base URL for raw requests (used by web3 subscribe) */
+  getBaseUrl() {
+    return this.baseUrl;
+  }
+  /** Timeout in ms for raw requests (used by web3 subscribe) */
+  getTimeout() {
+    return this.timeout;
+  }
   /**
    * Make a GET request to the API
    *
@@ -115,6 +123,66 @@ var HttpClient = class {
       );
     }
   }
+  /**
+   * Make a POST request to the API
+   *
+   * @param path - API endpoint path
+   * @param body - JSON request body
+   * @param schema - Optional Zod schema for validation (used when validation is enabled)
+   */
+  async post(path, body, schema) {
+    const url = `${this.baseUrl}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "X-API-Key": this.apiKey,
+          "Content-Type": "application/json"
+        },
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      const rawData = await response.json();
+      const data = transformKeys(rawData);
+      if (!response.ok) {
+        const error = data;
+        const apiResponse = data;
+        throw new OxArchiveError(
+          error.error || `Request failed with status ${response.status}`,
+          response.status,
+          apiResponse.meta?.requestId
+        );
+      }
+      if (this.validate && schema) {
+        const result = schema.safeParse(data);
+        if (!result.success) {
+          const apiResponse = data;
+          throw new OxArchiveError(
+            `Response validation failed: ${result.error.message}`,
+            422,
+            apiResponse.meta?.requestId
+          );
+        }
+        return result.data;
+      }
+      return data;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof OxArchiveError) {
+        throw error;
+      }
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new OxArchiveError(`Request timeout after ${this.timeout}ms`, 408);
+      }
+      throw new OxArchiveError(
+        error instanceof Error ? error.message : "Unknown error",
+        500
+      );
+    }
+  }
 };
 
 // src/schemas.ts
@@ -613,15 +681,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
     );
@@ -630,7 +698,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
    *
@@ -654,9 +722,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
     );
@@ -674,7 +742,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
    *
@@ -694,9 +762,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"
@@ -721,7 +789,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
@@ -745,8 +813,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);
   }
@@ -786,7 +854,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
@@ -809,7 +877,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;
@@ -817,7 +885,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
@@ -855,12 +923,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
    *
@@ -884,9 +952,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
     );
@@ -896,20 +964,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
     );
@@ -1021,15 +1089,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
     );
@@ -1039,14 +1107,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
     );
@@ -1062,15 +1130,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
     );
@@ -1080,14 +1148,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
     );
@@ -1105,13 +1173,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
     );
@@ -1124,20 +1192,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
     );
@@ -1174,13 +1243,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
     );
@@ -1386,6 +1455,286 @@ var DataQualityResource = class {
   }
 };
 
+// src/resources/web3.ts
+var Web3Resource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Get a SIWE challenge message to sign.
+   *
+   * @param address - Ethereum wallet address
+   * @returns SIWE message and nonce. Sign the message with personal_sign (EIP-191).
+   */
+  async challenge(address) {
+    return this.http.post("/v1/auth/web3/challenge", { address });
+  }
+  /**
+   * Create a free-tier account and get an API key.
+   *
+   * @param message - The SIWE message from {@link challenge}
+   * @param signature - Hex-encoded signature from personal_sign
+   * @returns API key, tier, and wallet address
+   */
+  async signup(message, signature) {
+    return this.http.post("/v1/web3/signup", { message, signature });
+  }
+  /**
+   * List all API keys for the authenticated wallet.
+   *
+   * @param message - The SIWE message from {@link challenge}
+   * @param signature - Hex-encoded signature from personal_sign
+   * @returns List of API keys and wallet address
+   */
+  async listKeys(message, signature) {
+    return this.http.post("/v1/web3/keys", { message, signature });
+  }
+  /**
+   * Revoke a specific API key.
+   *
+   * @param message - The SIWE message from {@link challenge}
+   * @param signature - Hex-encoded signature from personal_sign
+   * @param keyId - UUID of the key to revoke
+   * @returns Confirmation message and wallet address
+   */
+  async revokeKey(message, signature, keyId) {
+    return this.http.post("/v1/web3/keys/revoke", {
+      message,
+      signature,
+      key_id: keyId
+    });
+  }
+  /**
+   * Get pricing info for a paid subscription (x402 flow, step 1).
+   *
+   * Returns the payment details needed to sign a USDC transfer on Base.
+   * After signing, pass the payment signature to {@link subscribe}.
+   *
+   * @param tier - Subscription tier: 'build' ($49/mo) or 'pro' ($199/mo)
+   * @returns Payment details (amount, asset, network, pay-to address)
+   */
+  async subscribeQuote(tier) {
+    const url = `${this.http.getBaseUrl()}/v1/web3/subscribe`;
+    const timeout = this.http.getTimeout();
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ tier }),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      const rawData = await response.json();
+      const data = transformKeys(rawData);
+      if (response.status === 402) {
+        return data.payment;
+      }
+      throw new OxArchiveError(
+        data.error || `Unexpected status ${response.status}`,
+        response.status
+      );
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof OxArchiveError) throw error;
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new OxArchiveError(`Request timeout after ${timeout}ms`, 408);
+      }
+      throw new OxArchiveError(
+        error instanceof Error ? error.message : "Unknown error",
+        500
+      );
+    }
+  }
+  /**
+   * Complete a paid subscription with a signed x402 payment (step 2).
+   *
+   * Requires a payment signature from signing a USDC transfer (EIP-3009)
+   * for the amount returned by {@link subscribeQuote}.
+   *
+   * @param tier - Subscription tier: 'build' or 'pro'
+   * @param paymentSignature - Signed x402 payment (from EIP-3009 USDC transfer on Base)
+   * @returns API key, tier, expiration, and wallet address
+   */
+  async subscribe(tier, paymentSignature) {
+    const url = `${this.http.getBaseUrl()}/v1/web3/subscribe`;
+    const timeout = this.http.getTimeout();
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "payment-signature": paymentSignature
+        },
+        body: JSON.stringify({ tier }),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      const rawData = await response.json();
+      const data = transformKeys(rawData);
+      if (!response.ok) {
+        throw new OxArchiveError(
+          data.error || "Subscribe failed",
+          response.status
+        );
+      }
+      return data;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof OxArchiveError) throw error;
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new OxArchiveError(`Request timeout after ${timeout}ms`, 408);
+      }
+      throw new OxArchiveError(
+        error instanceof Error ? error.message : "Unknown error",
+        500
+      );
+    }
+  }
+};
+
+// 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/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 {
   /**
@@ -1416,6 +1765,14 @@ var HyperliquidClient = class {
    * Liquidation events (May 2025+)
    */
   liquidations;
+  /**
+   * Order history, flow, and TP/SL
+   */
+  orders;
+  /**
+   * L4 order book (snapshots, diffs, history)
+   */
+  l4Orderbook;
   /**
    * HIP-3 builder-deployed perpetuals (February 2026+)
    */
@@ -1431,17 +1788,19 @@ 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.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
     );
@@ -1450,12 +1809,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
     );
@@ -1464,13 +1823,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
     );
@@ -1505,6 +1864,18 @@ var Hip3Client = class {
    * OHLCV candle data
    */
   candles;
+  /**
+   * Liquidation events
+   */
+  liquidations;
+  /**
+   * Order history, flow, and TP/SL
+   */
+  orders;
+  /**
+   * L4 order book (snapshots, diffs, history)
+   */
+  l4Orderbook;
   http;
   constructor(http) {
     this.http = http;
@@ -1516,16 +1887,19 @@ 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);
   }
   /**
-   * 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
     );
@@ -1534,12 +1908,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
     );
@@ -1548,13 +1922,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
     );
@@ -1589,6 +1963,10 @@ var LighterClient = class {
    * OHLCV candle data
    */
   candles;
+  /**
+   * L3 order book (Lighter only)
+   */
+  l3Orderbook;
   http;
   constructor(http) {
     this.http = http;
@@ -1599,16 +1977,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
     );
@@ -1617,12 +1996,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
     );
@@ -1631,13 +2010,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
     );
@@ -1665,6 +2044,10 @@ var OxArchive = class {
    * Data quality metrics: status, coverage, incidents, latency, SLA
    */
   dataQuality;
+  /**
+   * Wallet-based auth: get API keys via SIWE signature
+   */
+  web3;
   /**
    * @deprecated Use client.hyperliquid.orderbook instead
    */
@@ -1703,6 +2086,7 @@ var OxArchive = class {
     this.hyperliquid = new HyperliquidClient(this.http);
     this.lighter = new LighterClient(this.http);
     this.dataQuality = new DataQualityResource(this.http);
+    this.web3 = new Web3Resource(this.http);
     const legacyBase = "/v1/hyperliquid";
     this.orderbook = new OrderBookResource(this.http, legacyBase);
     this.trades = new TradesResource(this.http, legacyBase);