@nktkas/hyperliquid 0.30.3 → 0.31.0

package/esm/src/api/subscription/client.js

@@ -57,23 +57,132 @@ export class SubscriptionClient {
     constructor(config) {
         this.config_ = config;
     }
-    /** @see {@link activeAssetCtx} */
+    /**
+     * Subscribe to context updates for a specific perpetual asset.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.activeAssetCtx({ coin: "ETH" }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     activeAssetCtx(params, listener) {
         return activeAssetCtx(this.config_, params, listener);
     }
-    /** @see {@link activeAssetData} */
+    /**
+     * Subscribe to trading data updates for a specific asset and user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.activeAssetData({ coin: "ETH", user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     activeAssetData(params, listener) {
         return activeAssetData(this.config_, params, listener);
     }
-    /** @see {@link activeSpotAssetCtx} */
+    /**
+     * Subscribe to context updates for a specific spot asset.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.activeSpotAssetCtx({ coin: "@1" }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     activeSpotAssetCtx(params, listener) {
         return activeSpotAssetCtx(this.config_, params, listener);
     }
-    /** @see {@link allDexsAssetCtxs} */
+    /**
+     * Subscribe to asset contexts for all DEXs.
+     *
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.allDexsAssetCtxs((data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     allDexsAssetCtxs(listener) {
         return allDexsAssetCtxs(this.config_, listener);
     }
-    /** @see {@link allDexsClearinghouseState} */
+    /**
+     * Subscribe to clearinghouse states for all DEXs for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.allDexsClearinghouseState({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     allDexsClearinghouseState(params, listener) {
         return allDexsClearinghouseState(this.config_, params, listener);
     }
@@ -87,91 +196,573 @@ export class SubscriptionClient {
         const listener = typeof paramsOrListener === "function" ? paramsOrListener : maybeListener;
         return assetCtxs(this.config_, params, listener);
     }
-    /** @see {@link bbo} */
+    /**
+     * Subscribe to best bid and offer updates for a specific asset.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.bbo({ coin: "ETH" }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     bbo(params, listener) {
         return bbo(this.config_, params, listener);
     }
-    /** @see {@link candle} */
+    /**
+     * Subscribe to candlestick data updates for a specific asset.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.candle({ coin: "ETH", interval: "1h" }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     candle(params, listener) {
         return candle(this.config_, params, listener);
     }
-    /** @see {@link clearinghouseState} */
+    /**
+     * Subscribe to clearinghouse state updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.clearinghouseState({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     clearinghouseState(params, listener) {
         return clearinghouseState(this.config_, params, listener);
     }
-    /** @see {@link explorerBlock} */
+    /**
+     * Subscribe to explorer block updates.
+     *
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport({ url: "wss://rpc.hyperliquid.xyz/ws" }); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.explorerBlock((data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     explorerBlock(listener) {
         return explorerBlock(this.config_, listener);
     }
-    /** @see {@link explorerTxs} */
+    /**
+     * Subscribe to explorer transaction updates.
+     *
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport({ url: "wss://rpc.hyperliquid.xyz/ws" }); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.explorerTxs((data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     explorerTxs(listener) {
         return explorerTxs(this.config_, listener);
     }
-    /** @see {@link l2Book} */
+    /**
+     * Subscribe to L2 order book updates for a specific asset.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.l2Book({ coin: "ETH" }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     l2Book(params, listener) {
         return l2Book(this.config_, params, listener);
     }
-    /** @see {@link notification} */
+    /**
+     * Subscribe to notification updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.notification({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     notification(params, listener) {
         return notification(this.config_, params, listener);
     }
-    /** @see {@link openOrders} */
+    /**
+     * Subscribe to open orders updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.openOrders({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     openOrders(params, listener) {
         return openOrders(this.config_, params, listener);
     }
-    /** @see {@link orderUpdates} */
+    /**
+     * Subscribe to order status updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.orderUpdates({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     orderUpdates(params, listener) {
         return orderUpdates(this.config_, params, listener);
     }
-    /** @see {@link spotAssetCtxs} */
+    /**
+     * Subscribe to context updates for all spot assets.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.spotAssetCtxs((data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     spotAssetCtxs(listener) {
         return spotAssetCtxs(this.config_, listener);
     }
-    /** @see {@link spotState} */
+    /**
+     * Subscribe to spot state updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.spotState({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     spotState(params, listener) {
         return spotState(this.config_, params, listener);
     }
-    /** @see {@link trades} */
+    /**
+     * Subscribe to real-time trade updates for a specific asset.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.trades({ coin: "ETH" }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     trades(params, listener) {
         return trades(this.config_, params, listener);
     }
-    /** @see {@link twapStates} */
+    /**
+     * Subscribe to TWAP states updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.twapStates({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     twapStates(params, listener) {
         return twapStates(this.config_, params, listener);
     }
-    /** @see {@link userEvents} */
+    /**
+     * Subscribe to non-order events for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.userEvents({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     userEvents(params, listener) {
         return userEvents(this.config_, params, listener);
     }
-    /** @see {@link userFills} */
+    /**
+     * Subscribe to trade fill updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.userFills({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     userFills(params, listener) {
         return userFills(this.config_, params, listener);
     }
-    /** @see {@link userFundings} */
+    /**
+     * Subscribe to funding payment updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.userFundings({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     userFundings(params, listener) {
         return userFundings(this.config_, params, listener);
     }
-    /** @see {@link userHistoricalOrders} */
+    /**
+     * Subscribe to historical order updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.userHistoricalOrders({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     userHistoricalOrders(params, listener) {
         return userHistoricalOrders(this.config_, params, listener);
     }
-    /** @see {@link userNonFundingLedgerUpdates} */
+    /**
+     * Subscribe to non-funding ledger updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.userNonFundingLedgerUpdates({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     userNonFundingLedgerUpdates(params, listener) {
         return userNonFundingLedgerUpdates(this.config_, params, listener);
     }
-    /** @see {@link userTwapHistory} */
+    /**
+     * Subscribe to TWAP order history updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.userTwapHistory({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     userTwapHistory(params, listener) {
         return userTwapHistory(this.config_, params, listener);
     }
-    /** @see {@link userTwapSliceFills} */
+    /**
+     * Subscribe to TWAP execution updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.userTwapSliceFills({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     userTwapSliceFills(params, listener) {
         return userTwapSliceFills(this.config_, params, listener);
     }
-    /** @see {@link webData2} */
+    /**
+     * Subscribe to comprehensive user and market data updates.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.webData2({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     webData2(params, listener) {
         return webData2(this.config_, params, listener);
     }
-    /** @see {@link webData3} */
+    /**
+     * Subscribe to comprehensive user and market data updates.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.webData3({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     webData3(params, listener) {
         return webData3(this.config_, params, listener);
     }