@0xarchive/sdk 0.7.0 → 0.8.1

package/dist/index.mjs

@@ -516,9 +516,10 @@ function reconstructFinal(tickData, depth) {
 
 // src/resources/orderbook.ts
 var OrderBookResource = class {
-  constructor(http, basePath = "/v1") {
+  constructor(http, basePath = "/v1", coinTransform = (c) => c.toUpperCase()) {
     this.http = http;
     this.basePath = basePath;
+    this.coinTransform = coinTransform;
   }
   /**
    * Get order book snapshot for a coin
@@ -529,7 +530,7 @@ var OrderBookResource = class {
    */
   async get(coin, params) {
     const response = await this.http.get(
-      `${this.basePath}/orderbook/${coin.toUpperCase()}`,
+      `${this.basePath}/orderbook/${this.coinTransform(coin)}`,
       params,
       this.http.validationEnabled ? OrderBookResponseSchema : void 0
     );
@@ -564,7 +565,7 @@ var OrderBookResource = class {
    */
   async history(coin, params) {
     const response = await this.http.get(
-      `${this.basePath}/orderbook/${coin.toUpperCase()}/history`,
+      `${this.basePath}/orderbook/${this.coinTransform(coin)}/history`,
       params,
       this.http.validationEnabled ? OrderBookArrayResponseSchema : void 0
     );
@@ -604,7 +605,7 @@ var OrderBookResource = class {
    */
   async historyTick(coin, params) {
     const response = await this.http.get(
-      `${this.basePath}/orderbook/${coin.toUpperCase()}/history`,
+      `${this.basePath}/orderbook/${this.coinTransform(coin)}/history`,
       {
         ...params,
         granularity: "tick"
@@ -757,9 +758,10 @@ var OrderBookResource = class {
 
 // src/resources/trades.ts
 var TradesResource = class {
-  constructor(http, basePath = "/v1") {
+  constructor(http, basePath = "/v1", coinTransform = (c) => c.toUpperCase()) {
     this.http = http;
     this.basePath = basePath;
+    this.coinTransform = coinTransform;
   }
   /**
    * Get trade history for a coin using cursor-based pagination
@@ -793,7 +795,7 @@ var TradesResource = class {
    */
   async list(coin, params) {
     const response = await this.http.get(
-      `${this.basePath}/trades/${coin.toUpperCase()}`,
+      `${this.basePath}/trades/${this.coinTransform(coin)}`,
       params,
       this.http.validationEnabled ? TradeArrayResponseSchema : void 0
     );
@@ -805,9 +807,10 @@ var TradesResource = class {
   /**
    * Get most recent trades for a coin.
    *
-   * Note: This method is only available for Lighter (client.lighter.trades.recent())
-   * which has real-time data ingestion. Hyperliquid uses hourly backfill so this
-   * endpoint is not available for Hyperliquid.
+   * 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 limit - Number of trades to return (default: 100)
@@ -815,7 +818,7 @@ var TradesResource = class {
    */
   async recent(coin, limit) {
     const response = await this.http.get(
-      `${this.basePath}/trades/${coin.toUpperCase()}/recent`,
+      `${this.basePath}/trades/${this.coinTransform(coin)}/recent`,
       { limit },
       this.http.validationEnabled ? TradeArrayResponseSchema : void 0
     );
@@ -886,12 +889,45 @@ var LighterInstrumentsResource = class {
     return response.data;
   }
 };
+var Hip3InstrumentsResource = class {
+  constructor(http, basePath = "/v1/hyperliquid/hip3", coinTransform) {
+    this.http = http;
+    this.basePath = basePath;
+    this.coinTransform = coinTransform || ((c) => c);
+  }
+  coinTransform;
+  /**
+   * List all available HIP-3 instruments with latest market data
+   *
+   * @returns Array of HIP-3 instruments
+   */
+  async list() {
+    const response = await this.http.get(
+      `${this.basePath}/instruments`
+    );
+    return response.data;
+  }
+  /**
+   * Get a specific HIP-3 instrument by coin name
+   *
+   * @param coin - The coin name (e.g., 'km:US500', 'xyz:XYZ100'). Case-sensitive.
+   * @returns HIP-3 instrument details with latest market data
+   */
+  async get(coin) {
+    coin = this.coinTransform(coin);
+    const response = await this.http.get(
+      `${this.basePath}/instruments/${coin}`
+    );
+    return response.data;
+  }
+};
 
 // src/resources/funding.ts
 var FundingResource = class {
-  constructor(http, basePath = "/v1") {
+  constructor(http, basePath = "/v1", coinTransform = (c) => c.toUpperCase()) {
     this.http = http;
     this.basePath = basePath;
+    this.coinTransform = coinTransform;
   }
   /**
    * Get funding rate history for a coin with cursor-based pagination
@@ -902,7 +938,7 @@ var FundingResource = class {
    */
   async history(coin, params) {
     const response = await this.http.get(
-      `${this.basePath}/funding/${coin.toUpperCase()}`,
+      `${this.basePath}/funding/${this.coinTransform(coin)}`,
       params,
       this.http.validationEnabled ? FundingRateArrayResponseSchema : void 0
     );
@@ -919,7 +955,7 @@ var FundingResource = class {
    */
   async current(coin) {
     const response = await this.http.get(
-      `/v1/funding/${coin.toUpperCase()}/current`,
+      `${this.basePath}/funding/${this.coinTransform(coin)}/current`,
       void 0,
       this.http.validationEnabled ? FundingRateResponseSchema : void 0
     );
@@ -929,9 +965,10 @@ var FundingResource = class {
 
 // src/resources/openinterest.ts
 var OpenInterestResource = class {
-  constructor(http, basePath = "/v1") {
+  constructor(http, basePath = "/v1", coinTransform = (c) => c.toUpperCase()) {
     this.http = http;
     this.basePath = basePath;
+    this.coinTransform = coinTransform;
   }
   /**
    * Get open interest history for a coin with cursor-based pagination
@@ -942,7 +979,7 @@ var OpenInterestResource = class {
    */
   async history(coin, params) {
     const response = await this.http.get(
-      `${this.basePath}/openinterest/${coin.toUpperCase()}`,
+      `${this.basePath}/openinterest/${this.coinTransform(coin)}`,
       params,
       this.http.validationEnabled ? OpenInterestArrayResponseSchema : void 0
     );
@@ -959,7 +996,7 @@ var OpenInterestResource = class {
    */
   async current(coin) {
     const response = await this.http.get(
-      `/v1/openinterest/${coin.toUpperCase()}/current`,
+      `${this.basePath}/openinterest/${this.coinTransform(coin)}/current`,
       void 0,
       this.http.validationEnabled ? OpenInterestResponseSchema : void 0
     );
@@ -1093,7 +1130,7 @@ var DataQualityResource = class {
   /**
    * Get data coverage for a specific exchange
    *
-   * @param exchange - Exchange name ('hyperliquid' or 'lighter')
+   * @param exchange - Exchange name ('hyperliquid', 'lighter', or 'hip3')
    * @returns ExchangeCoverage with coverage info for all data types on this exchange
    *
    * @example
@@ -1113,8 +1150,8 @@ var DataQualityResource = class {
    * Includes gap detection, empirical data cadence, and hour-level historical coverage.
    * Supports optional time bounds for gap detection (default: last 30 days).
    *
-   * @param exchange - Exchange name ('hyperliquid' or 'lighter')
-   * @param symbol - Symbol name (e.g., 'BTC', 'ETH')
+   * @param exchange - Exchange name ('hyperliquid', 'lighter', or 'hip3')
+   * @param symbol - Symbol name (e.g., 'BTC', 'ETH', or HIP3 coins like 'xyz:XYZ100')
    * @param options - Optional time bounds for gap detection window
    * @returns SymbolCoverageResponse with per-data-type coverage including gaps, cadence, and historical coverage
    *
@@ -1266,6 +1303,10 @@ var HyperliquidClient = class {
    * Liquidation events (May 2025+)
    */
   liquidations;
+  /**
+   * HIP-3 builder-deployed perpetuals (Pro+ only, February 2026+)
+   */
+  hip3;
   constructor(http) {
     const basePath = "/v1/hyperliquid";
     this.orderbook = new OrderBookResource(http, basePath);
@@ -1275,6 +1316,38 @@ var HyperliquidClient = class {
     this.openInterest = new OpenInterestResource(http, basePath);
     this.candles = new CandlesResource(http, basePath);
     this.liquidations = new LiquidationsResource(http, basePath);
+    this.hip3 = new Hip3Client(http);
+  }
+};
+var Hip3Client = class {
+  /**
+   * HIP-3 instruments with latest market data
+   */
+  instruments;
+  /**
+   * Order book snapshots (February 2026+)
+   */
+  orderbook;
+  /**
+   * Trade/fill history
+   */
+  trades;
+  /**
+   * Funding rates
+   */
+  funding;
+  /**
+   * Open interest
+   */
+  openInterest;
+  constructor(http) {
+    const basePath = "/v1/hyperliquid/hip3";
+    const coinTransform = (c) => c;
+    this.instruments = new Hip3InstrumentsResource(http, basePath, coinTransform);
+    this.orderbook = new OrderBookResource(http, basePath, coinTransform);
+    this.trades = new TradesResource(http, basePath, coinTransform);
+    this.funding = new FundingResource(http, basePath, coinTransform);
+    this.openInterest = new OpenInterestResource(http, basePath, coinTransform);
   }
 };
 var LighterClient = class {
@@ -1956,6 +2029,7 @@ export {
   FundingRateArrayResponseSchema,
   FundingRateResponseSchema,
   FundingRateSchema,
+  Hip3Client,
   HyperliquidClient,
   InstrumentArrayResponseSchema,
   InstrumentResponseSchema,