@0xarchive/sdk 0.8.1 → 0.8.2

package/README.md

@@ -700,6 +700,7 @@ const ws = new OxArchiveWs({
 |---------|-------------|---------------|-------------------|
 | `hip3_orderbook` | HIP-3 L2 order book snapshots | Yes | Yes |
 | `hip3_trades` | HIP-3 trade/fill updates | Yes | Yes |
+| `hip3_candles` | HIP-3 OHLCV candle data | Yes | Yes |
 
 > **Note:** HIP-3 coins are case-sensitive (e.g., `km:US500`, `xyz:XYZ100`). Do not uppercase them.
 
@@ -754,6 +755,14 @@ ws.stream('hip3_trades', 'xyz:XYZ100', {
   end: Date.now(),
   batchSize: 1000,
 });
+
+// HIP-3 candles
+ws.replay('hip3_candles', 'km:US500', {
+  start: Date.now() - 86400000,
+  end: Date.now(),
+  speed: 100,
+  interval: '1h'
+});
 ```
 
 ### WebSocket Connection States

package/dist/index.d.mts

@@ -356,7 +356,7 @@ interface CandleHistoryParams extends CursorPaginationParams {
     interval?: CandleInterval;
 }
 /** WebSocket channel types. Note: ticker/all_tickers are real-time only. Liquidations is historical only (May 2025+). */
-type WsChannel = 'orderbook' | 'trades' | 'candles' | 'liquidations' | 'ticker' | 'all_tickers' | 'lighter_orderbook' | 'lighter_trades' | 'lighter_candles' | 'hip3_orderbook' | 'hip3_trades';
+type WsChannel = 'orderbook' | 'trades' | 'candles' | 'liquidations' | 'ticker' | 'all_tickers' | 'lighter_orderbook' | 'lighter_trades' | 'lighter_candles' | 'hip3_orderbook' | 'hip3_trades' | 'hip3_candles';
 /** Subscribe message from client */
 interface WsSubscribe {
     op: 'subscribe';
@@ -1591,7 +1591,8 @@ declare class OpenInterestResource {
 declare class CandlesResource {
     private http;
     private basePath;
-    constructor(http: HttpClient, basePath?: string);
+    private coinTransform;
+    constructor(http: HttpClient, basePath?: string, coinTransform?: (coin: string) => string);
     /**
      * Get historical OHLCV candle data with cursor-based pagination
      *
@@ -1878,7 +1879,7 @@ declare class HyperliquidClient {
      */
     readonly liquidations: LiquidationsResource;
     /**
-     * HIP-3 builder-deployed perpetuals (Pro+ only, February 2026+)
+     * HIP-3 builder-deployed perpetuals (February 2026+)
      */
     readonly hip3: Hip3Client;
     constructor(http: HttpClient);
@@ -1887,7 +1888,7 @@ declare class HyperliquidClient {
  * HIP-3 builder-deployed perpetuals client
  *
  * Access Hyperliquid HIP-3 builder perps data through the 0xarchive API.
- * Requires Pro tier or higher.
+ * Free: km:US500 only. Build+: all coins. Orderbook: Pro+.
  *
  * @example
  * ```typescript
@@ -1917,6 +1918,10 @@ declare class Hip3Client {
      * Open interest
      */
     readonly openInterest: OpenInterestResource;
+    /**
+     * OHLCV candle data
+     */
+    readonly candles: CandlesResource;
     constructor(http: HttpClient);
 }
 /**

package/dist/index.d.ts

@@ -356,7 +356,7 @@ interface CandleHistoryParams extends CursorPaginationParams {
     interval?: CandleInterval;
 }
 /** WebSocket channel types. Note: ticker/all_tickers are real-time only. Liquidations is historical only (May 2025+). */
-type WsChannel = 'orderbook' | 'trades' | 'candles' | 'liquidations' | 'ticker' | 'all_tickers' | 'lighter_orderbook' | 'lighter_trades' | 'lighter_candles' | 'hip3_orderbook' | 'hip3_trades';
+type WsChannel = 'orderbook' | 'trades' | 'candles' | 'liquidations' | 'ticker' | 'all_tickers' | 'lighter_orderbook' | 'lighter_trades' | 'lighter_candles' | 'hip3_orderbook' | 'hip3_trades' | 'hip3_candles';
 /** Subscribe message from client */
 interface WsSubscribe {
     op: 'subscribe';
@@ -1591,7 +1591,8 @@ declare class OpenInterestResource {
 declare class CandlesResource {
     private http;
     private basePath;
-    constructor(http: HttpClient, basePath?: string);
+    private coinTransform;
+    constructor(http: HttpClient, basePath?: string, coinTransform?: (coin: string) => string);
     /**
      * Get historical OHLCV candle data with cursor-based pagination
      *
@@ -1878,7 +1879,7 @@ declare class HyperliquidClient {
      */
     readonly liquidations: LiquidationsResource;
     /**
-     * HIP-3 builder-deployed perpetuals (Pro+ only, February 2026+)
+     * HIP-3 builder-deployed perpetuals (February 2026+)
      */
     readonly hip3: Hip3Client;
     constructor(http: HttpClient);
@@ -1887,7 +1888,7 @@ declare class HyperliquidClient {
  * HIP-3 builder-deployed perpetuals client
  *
  * Access Hyperliquid HIP-3 builder perps data through the 0xarchive API.
- * Requires Pro tier or higher.
+ * Free: km:US500 only. Build+: all coins. Orderbook: Pro+.
  *
  * @example
  * ```typescript
@@ -1917,6 +1918,10 @@ declare class Hip3Client {
      * Open interest
      */
     readonly openInterest: OpenInterestResource;
+    /**
+     * OHLCV candle data
+     */
+    readonly candles: CandlesResource;
     constructor(http: HttpClient);
 }
 /**

package/dist/index.js

@@ -1087,9 +1087,10 @@ var OpenInterestResource = class {
 
 // src/resources/candles.ts
 var CandlesResource = class {
-  constructor(http, basePath = "/v1") {
+  constructor(http, basePath = "/v1", coinTransform = (c) => c.toUpperCase()) {
     this.http = http;
     this.basePath = basePath;
+    this.coinTransform = coinTransform;
   }
   /**
    * Get historical OHLCV candle data with cursor-based pagination
@@ -1100,7 +1101,7 @@ var CandlesResource = class {
    */
   async history(coin, params) {
     const response = await this.http.get(
-      `${this.basePath}/candles/${coin.toUpperCase()}`,
+      `${this.basePath}/candles/${this.coinTransform(coin)}`,
       params,
       this.http.validationEnabled ? CandleArrayResponseSchema : void 0
     );
@@ -1385,7 +1386,7 @@ var HyperliquidClient = class {
    */
   liquidations;
   /**
-   * HIP-3 builder-deployed perpetuals (Pro+ only, February 2026+)
+   * HIP-3 builder-deployed perpetuals (February 2026+)
    */
   hip3;
   constructor(http) {
@@ -1421,6 +1422,10 @@ var Hip3Client = class {
    * Open interest
    */
   openInterest;
+  /**
+   * OHLCV candle data
+   */
+  candles;
   constructor(http) {
     const basePath = "/v1/hyperliquid/hip3";
     const coinTransform = (c) => c;
@@ -1429,6 +1434,7 @@ var Hip3Client = class {
     this.trades = new TradesResource(http, basePath, coinTransform);
     this.funding = new FundingResource(http, basePath, coinTransform);
     this.openInterest = new OpenInterestResource(http, basePath, coinTransform);
+    this.candles = new CandlesResource(http, basePath, coinTransform);
   }
 };
 var LighterClient = class {