@nktkas/hyperliquid 0.25.0-beta.4 → 0.25.1

package/esm/src/api/info/userFees.js

@@ -0,0 +1,139 @@
+import * as v from "valibot";
+import { Address, Decimal, parser, UnsignedDecimal } from "../_common.js";
+// -------------------- Schemas --------------------
+/**
+ * Request user fees.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-fees
+ */
+export const UserFeesRequest = /* @__PURE__ */ (() => {
+    return v.pipe(v.object({
+        /** Type of request. */
+        type: v.pipe(v.literal("userFees"), v.description("Type of request.")),
+        /** User address. */
+        user: v.pipe(Address, v.description("User address.")),
+    }), v.description("Request user fees."));
+})();
+/**
+ * User fees.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-fees
+ */
+export const UserFeesResponse = /* @__PURE__ */ (() => {
+    return v.pipe(v.object({
+        /** Daily user volume metrics. */
+        dailyUserVlm: v.pipe(v.array(
+        /** Daily user volume metrics record. */
+        v.pipe(v.object({
+            /** Date in YYYY-M-D format. */
+            date: v.pipe(v.string(), v.isoDate(), v.description("Date in YYYY-M-D format.")),
+            /** User cross-trade volume. */
+            userCross: v.pipe(UnsignedDecimal, v.description("User cross-trade volume.")),
+            /** User add-liquidity volume. */
+            userAdd: v.pipe(UnsignedDecimal, v.description("User add-liquidity volume.")),
+            /** Exchange total volume. */
+            exchange: v.pipe(UnsignedDecimal, v.description("Exchange total volume.")),
+        }), v.description("Daily user volume metrics record."))), v.description("Daily user volume metrics.")),
+        /** Fee schedule information. */
+        feeSchedule: v.pipe(v.object({
+            /** Cross-trade fee rate. */
+            cross: v.pipe(UnsignedDecimal, v.description("Cross-trade fee rate.")),
+            /** Add-liquidity fee rate. */
+            add: v.pipe(UnsignedDecimal, v.description("Add-liquidity fee rate.")),
+            /** Spot cross-trade fee rate. */
+            spotCross: v.pipe(UnsignedDecimal, v.description("Spot cross-trade fee rate.")),
+            /** Spot add-liquidity fee rate. */
+            spotAdd: v.pipe(UnsignedDecimal, v.description("Spot add-liquidity fee rate.")),
+            /** Fee tiers details. */
+            tiers: v.pipe(v.object({
+                /** Array of VIP fee tiers. */
+                vip: v.pipe(v.array(
+                /** VIP fee tier. */
+                v.pipe(v.object({
+                    /** Notional volume cutoff. */
+                    ntlCutoff: v.pipe(UnsignedDecimal, v.description("Notional volume cutoff.")),
+                    /** Cross-trade fee rate. */
+                    cross: v.pipe(UnsignedDecimal, v.description("Cross-trade fee rate.")),
+                    /** Add-liquidity fee rate. */
+                    add: v.pipe(UnsignedDecimal, v.description("Add-liquidity fee rate.")),
+                    /** Spot cross-trade fee rate. */
+                    spotCross: v.pipe(UnsignedDecimal, v.description("Spot cross-trade fee rate.")),
+                    /** Spot add-liquidity fee rate. */
+                    spotAdd: v.pipe(UnsignedDecimal, v.description("Spot add-liquidity fee rate.")),
+                }), v.description("VIP fee tier."))), v.description("Array of VIP fee tiers.")),
+                /** Array of market maker fee tiers. */
+                mm: v.pipe(v.array(
+                /** Market maker fee tier. */
+                v.pipe(v.object({
+                    /** Maker fraction cutoff. */
+                    makerFractionCutoff: v.pipe(UnsignedDecimal, v.description("Maker fraction cutoff.")),
+                    /** Add-liquidity fee rate. */
+                    add: v.pipe(Decimal, v.description("Add-liquidity fee rate.")),
+                }), v.description("Market maker fee tier."))), v.description("Array of market maker fee tiers.")),
+            }), v.description("Fee tiers details.")),
+            /** Referral discount rate. */
+            referralDiscount: v.pipe(UnsignedDecimal, v.description("Referral discount rate.")),
+            /** Array of staking discount tiers. */
+            stakingDiscountTiers: v.pipe(v.array(
+            /** Staking discount tier. */
+            v.pipe(v.object({
+                /** Basis points of maximum supply. */
+                bpsOfMaxSupply: v.pipe(UnsignedDecimal, v.description("Basis points of maximum supply.")),
+                /** Discount rate applied. */
+                discount: v.pipe(UnsignedDecimal, v.description("Discount rate applied.")),
+            }), v.description("Staking discount tier."))), v.description("Staking discount tiers details.")),
+        }), v.description("Array of staking discount tiers.")),
+        /** User cross-trade rate. */
+        userCrossRate: v.pipe(UnsignedDecimal, v.description("User cross-trade rate.")),
+        /** User add-liquidity rate. */
+        userAddRate: v.pipe(UnsignedDecimal, v.description("User add-liquidity rate.")),
+        /** User spot cross-trade rate. */
+        userSpotCrossRate: v.pipe(UnsignedDecimal, v.description("User spot cross-trade rate.")),
+        /** User spot add-liquidity rate. */
+        userSpotAddRate: v.pipe(UnsignedDecimal, v.description("User spot add-liquidity rate.")),
+        /** Active referral discount rate. */
+        activeReferralDiscount: v.pipe(UnsignedDecimal, v.description("Active referral discount rate.")),
+        /** Trial details. */
+        trial: v.pipe(v.union([v.unknown(), v.null()]), v.description("Trial details.")),
+        /** Fee trial reward amount. */
+        feeTrialReward: v.pipe(UnsignedDecimal, v.description("Fee trial reward amount.")),
+        /** Timestamp when next trial becomes available. */
+        nextTrialAvailableTimestamp: v.pipe(v.union([v.unknown(), v.null()]), v.description("Timestamp when next trial becomes available.")),
+        stakingLink: v.union([v.unknown(), v.null()]),
+        /** Active staking discount details. */
+        activeStakingDiscount: v.pipe(v.object({
+            /** Basis points of maximum supply. */
+            bpsOfMaxSupply: v.pipe(UnsignedDecimal, v.description("Basis points of maximum supply.")),
+            /** Discount rate applied. */
+            discount: v.pipe(UnsignedDecimal, v.description("Discount rate applied.")),
+        }), v.description("Active staking discount details.")),
+    }), v.description("User fees."));
+})();
+/**
+ * Request user fees.
+ * @param config - General configuration for Info API requests.
+ * @param params - Parameters specific to the API request.
+ * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the request by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+ * @returns User fees.
+ *
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-fees
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { userFees } from "@nktkas/hyperliquid/api/info";
+ *
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ * const data = await userFees(
+ *   { transport },
+ *   { user: "0x..." },
+ * );
+ * ```
+ */
+export function userFees(config, params, signal) {
+    const request = parser(UserFeesRequest)({
+        type: "userFees",
+        ...params,
+    });
+    return config.transport.request("info", request, signal);
+}
+//# sourceMappingURL=userFees.js.map

package/esm/src/api/info/userFees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userFees.js","sourceRoot":"","sources":["../../../../src/src/api/info/userFees.ts"],"names":[],"mappings":"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"}

package/esm/src/api/info/userFills.d.ts

@@ -0,0 +1,142 @@
+import * as v from "valibot";
+import { type DeepImmutable } from "../_common.js";
+import type { InfoRequestConfig } from "./_common.js";
+/**
+ * Request array of user fills.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills
+ */
+export declare const UserFillsRequest: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Type of request. */
+    readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"userFills", undefined>, v.DescriptionAction<"userFills", "Type of request.">]>;
+    /** User address. */
+    readonly user: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>, v.DescriptionAction<`0x${string}`, "User address.">]>;
+    /** If true, partial fills are aggregated when a crossing order fills multiple resting orders. */
+    readonly aggregateByTime: v.SchemaWithPipe<readonly [v.OptionalSchema<v.BooleanSchema<undefined>, undefined>, v.DescriptionAction<boolean | undefined, "If true, partial fills are aggregated when a crossing order fills multiple resting orders.">]>;
+}, undefined>, v.DescriptionAction<{
+    type: "userFills";
+    user: `0x${string}`;
+    aggregateByTime?: boolean | undefined;
+}, "Request array of user fills.">]>;
+export type UserFillsRequest = v.InferOutput<typeof UserFillsRequest>;
+/**
+ * Array of user trade fills.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills
+ */
+export declare const UserFillsResponse: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Asset symbol. */
+    readonly coin: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Asset symbol.">]>;
+    /** Price. */
+    readonly px: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Price.">]>;
+    /** Size. */
+    readonly sz: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Size.">]>;
+    /** Order side ("B" = Bid/Buy, "A" = Ask/Sell). */
+    readonly side: v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<"B", undefined>, v.LiteralSchema<"A", undefined>], undefined>, v.DescriptionAction<"B" | "A", "Order side (\"B\" = Bid/Buy, \"A\" = Ask/Sell).">]>;
+    /** Timestamp when the trade occurred (in ms since epoch). */
+    readonly time: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Timestamp when the trade occurred (in ms since epoch).">]>;
+    /** Start position size. */
+    readonly startPosition: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Start position size.">]>;
+    /** Direction indicator for frontend display. */
+    readonly dir: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Direction indicator for frontend display.">]>;
+    /** Realized PnL. */
+    readonly closedPnl: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Realized PnL.">]>;
+    /** L1 transaction hash. */
+    readonly hash: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>, v.DescriptionAction<`0x${string}`, "L1 transaction hash.">]>;
+    /** Order ID. */
+    readonly oid: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Order ID.">]>;
+    /** Indicates if the fill was a taker order. */
+    readonly crossed: v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Indicates if the fill was a taker order.">]>;
+    /** Fee charged or rebate received (negative indicates rebate). */
+    readonly fee: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Fee charged or rebate received (negative indicates rebate).">]>;
+    /** Unique transaction identifier for a partial fill of an order. */
+    readonly tid: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Unique transaction identifier for a partial fill of an order.">]>;
+    /** Client Order ID. */
+    readonly cloid: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 34, undefined>]>, undefined>, v.DescriptionAction<`0x${string}` | undefined, "Client Order ID.">]>;
+    /** Liquidation details. */
+    readonly liquidation: v.SchemaWithPipe<readonly [v.OptionalSchema<v.ObjectSchema<{
+        /** Address of the liquidated user. */
+        readonly liquidatedUser: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>, v.DescriptionAction<`0x${string}`, "Address of the liquidated user.">]>;
+        /** Mark price at the time of liquidation. */
+        readonly markPx: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Mark price at the time of liquidation.">]>;
+        /** Liquidation method. */
+        readonly method: v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<"market", undefined>, v.LiteralSchema<"backstop", undefined>], undefined>, v.DescriptionAction<"market" | "backstop", "Liquidation method.">]>;
+    }, undefined>, undefined>, v.DescriptionAction<{
+        liquidatedUser: `0x${string}`;
+        markPx: string;
+        method: "market" | "backstop";
+    } | undefined, "Liquidation details.">]>;
+    /** Token in which the fee is denominated (e.g., "USDC"). */
+    readonly feeToken: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Token in which the fee is denominated (e.g., \"USDC\").">]>;
+    /** ID of the TWAP. */
+    readonly twapId: v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.NullSchema<undefined>], undefined>, v.DescriptionAction<number | null, "ID of the TWAP.">]>;
+}, undefined>, v.DescriptionAction<{
+    coin: string;
+    px: string;
+    sz: string;
+    side: "B" | "A";
+    time: number;
+    startPosition: string;
+    dir: string;
+    closedPnl: string;
+    hash: `0x${string}`;
+    oid: number;
+    crossed: boolean;
+    fee: string;
+    tid: number;
+    cloid?: `0x${string}` | undefined;
+    liquidation?: {
+        liquidatedUser: `0x${string}`;
+        markPx: string;
+        method: "market" | "backstop";
+    } | undefined;
+    feeToken: string;
+    twapId: number | null;
+}, "Trade fill record.">]>, undefined>, v.DescriptionAction<{
+    coin: string;
+    px: string;
+    sz: string;
+    side: "B" | "A";
+    time: number;
+    startPosition: string;
+    dir: string;
+    closedPnl: string;
+    hash: `0x${string}`;
+    oid: number;
+    crossed: boolean;
+    fee: string;
+    tid: number;
+    cloid?: `0x${string}` | undefined;
+    liquidation?: {
+        liquidatedUser: `0x${string}`;
+        markPx: string;
+        method: "market" | "backstop";
+    } | undefined;
+    feeToken: string;
+    twapId: number | null;
+}[], "Array of user trade fills.">]>;
+export type UserFillsResponse = v.InferOutput<typeof UserFillsResponse>;
+/** Request parameters for the {@linkcode userFills} function. */
+export type UserFillsParameters = Omit<v.InferInput<typeof UserFillsRequest>, "type">;
+/**
+ * Request array of user fills.
+ * @param config - General configuration for Info API requests.
+ * @param params - Parameters specific to the API request.
+ * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the request by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+ * @returns Array of user trade fills.
+ *
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { userFills } from "@nktkas/hyperliquid/api/info";
+ *
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ * const data = await userFills(
+ *   { transport },
+ *   { user: "0x..." },
+ * );
+ * ```
+ */
+export declare function userFills(config: InfoRequestConfig, params: DeepImmutable<UserFillsParameters>, signal?: AbortSignal): Promise<UserFillsResponse>;
+//# sourceMappingURL=userFills.d.ts.map

package/esm/src/api/info/userFills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userFills.d.ts","sourceRoot":"","sources":["../../../../src/src/api/info/userFills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAoB,KAAK,aAAa,EAAiD,MAAM,eAAe,CAAC;AACpH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAItD;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAGvB,uBAAuB;;IAKvB,oBAAoB;;IAKpB,iGAAiG;;;;;;oCAQnG,CAAC;AACL,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAMpB,oBAAoB;;IAKpB,aAAa;;IAKb,YAAY;;IAKZ,kDAAkD;;IAKlD,6DAA6D;;IAK7D,2BAA2B;;IAK3B,gDAAgD;;IAKhD,oBAAoB;;IAKpB,2BAA2B;;IAK3B,gBAAgB;;IAKhB,+CAA+C;;IAK/C,kEAAkE;;IAKlE,oEAAoE;;IAKpE,uBAAuB;;IAKvB,2BAA2B;;QAIrB,sCAAsC;;QAKtC,6CAA6C;;QAK7C,0BAA0B;;;;;;;IAShC,4DAA4D;;IAK5D,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAW5B,CAAC;AACL,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAIxE,iEAAiE;AACjE,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAC1C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAM5B"}

package/esm/src/api/info/userFills.js

@@ -0,0 +1,98 @@
+import * as v from "valibot";
+import { Address, Decimal, Hex, parser, UnsignedDecimal, UnsignedInteger } from "../_common.js";
+// -------------------- Schemas --------------------
+/**
+ * Request array of user fills.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills
+ */
+export const UserFillsRequest = /* @__PURE__ */ (() => {
+    return v.pipe(v.object({
+        /** Type of request. */
+        type: v.pipe(v.literal("userFills"), v.description("Type of request.")),
+        /** User address. */
+        user: v.pipe(Address, v.description("User address.")),
+        /** If true, partial fills are aggregated when a crossing order fills multiple resting orders. */
+        aggregateByTime: v.pipe(v.optional(v.boolean()), v.description("If true, partial fills are aggregated when a crossing order fills multiple resting orders.")),
+    }), v.description("Request array of user fills."));
+})();
+/**
+ * Array of user trade fills.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills
+ */
+export const UserFillsResponse = /* @__PURE__ */ (() => {
+    return v.pipe(v.array(
+    /** Trade fill record. */
+    v.pipe(v.object({
+        /** Asset symbol. */
+        coin: v.pipe(v.string(), v.description("Asset symbol.")),
+        /** Price. */
+        px: v.pipe(UnsignedDecimal, v.description("Price.")),
+        /** Size. */
+        sz: v.pipe(UnsignedDecimal, v.description("Size.")),
+        /** Order side ("B" = Bid/Buy, "A" = Ask/Sell). */
+        side: v.pipe(v.union([v.literal("B"), v.literal("A")]), v.description('Order side ("B" = Bid/Buy, "A" = Ask/Sell).')),
+        /** Timestamp when the trade occurred (in ms since epoch). */
+        time: v.pipe(UnsignedInteger, v.description("Timestamp when the trade occurred (in ms since epoch).")),
+        /** Start position size. */
+        startPosition: v.pipe(Decimal, v.description("Start position size.")),
+        /** Direction indicator for frontend display. */
+        dir: v.pipe(v.string(), v.description("Direction indicator for frontend display.")),
+        /** Realized PnL. */
+        closedPnl: v.pipe(Decimal, v.description("Realized PnL.")),
+        /** L1 transaction hash. */
+        hash: v.pipe(v.pipe(Hex, v.length(66)), v.description("L1 transaction hash.")),
+        /** Order ID. */
+        oid: v.pipe(UnsignedInteger, v.description("Order ID.")),
+        /** Indicates if the fill was a taker order. */
+        crossed: v.pipe(v.boolean(), v.description("Indicates if the fill was a taker order.")),
+        /** Fee charged or rebate received (negative indicates rebate). */
+        fee: v.pipe(Decimal, v.description("Fee charged or rebate received (negative indicates rebate).")),
+        /** Unique transaction identifier for a partial fill of an order. */
+        tid: v.pipe(UnsignedInteger, v.description("Unique transaction identifier for a partial fill of an order.")),
+        /** Client Order ID. */
+        cloid: v.pipe(v.optional(v.pipe(Hex, v.length(34))), v.description("Client Order ID.")),
+        /** Liquidation details. */
+        liquidation: v.pipe(v.optional(v.object({
+            /** Address of the liquidated user. */
+            liquidatedUser: v.pipe(Address, v.description("Address of the liquidated user.")),
+            /** Mark price at the time of liquidation. */
+            markPx: v.pipe(UnsignedDecimal, v.description("Mark price at the time of liquidation.")),
+            /** Liquidation method. */
+            method: v.pipe(v.union([v.literal("market"), v.literal("backstop")]), v.description("Liquidation method.")),
+        })), v.description("Liquidation details.")),
+        /** Token in which the fee is denominated (e.g., "USDC"). */
+        feeToken: v.pipe(v.string(), v.description('Token in which the fee is denominated (e.g., "USDC").')),
+        /** ID of the TWAP. */
+        twapId: v.pipe(v.union([UnsignedInteger, v.null()]), v.description("ID of the TWAP.")),
+    }), v.description("Trade fill record."))), v.description("Array of user trade fills."));
+})();
+/**
+ * Request array of user fills.
+ * @param config - General configuration for Info API requests.
+ * @param params - Parameters specific to the API request.
+ * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the request by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+ * @returns Array of user trade fills.
+ *
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { userFills } from "@nktkas/hyperliquid/api/info";
+ *
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ * const data = await userFills(
+ *   { transport },
+ *   { user: "0x..." },
+ * );
+ * ```
+ */
+export function userFills(config, params, signal) {
+    const request = parser(UserFillsRequest)({
+        type: "userFills",
+        ...params,
+    });
+    return config.transport.request("info", request, signal);
+}
+//# sourceMappingURL=userFills.js.map

package/esm/src/api/info/userFills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userFills.js","sourceRoot":"","sources":["../../../../src/src/api/info/userFills.ts"],"names":[],"mappings":"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"}

package/esm/src/api/info/userFillsByTime.d.ts

@@ -0,0 +1,148 @@
+import * as v from "valibot";
+import { type DeepImmutable } from "../_common.js";
+import type { InfoRequestConfig } from "./_common.js";
+/**
+ * Request array of user fills by time.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills-by-time
+ */
+export declare const UserFillsByTimeRequest: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Type of request. */
+    readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"userFillsByTime", undefined>, v.DescriptionAction<"userFillsByTime", "Type of request.">]>;
+    /** User address. */
+    readonly user: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>, v.DescriptionAction<`0x${string}`, "User address.">]>;
+    /** Start time (in ms since epoch). */
+    readonly startTime: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Start time (in ms since epoch).">]>;
+    /** End time (in ms since epoch). */
+    readonly endTime: v.SchemaWithPipe<readonly [v.NullishSchema<v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, v.DescriptionAction<number | null | undefined, "End time (in ms since epoch).">]>;
+    /** If true, partial fills are aggregated when a crossing order fills multiple resting orders. */
+    readonly aggregateByTime: v.SchemaWithPipe<readonly [v.OptionalSchema<v.BooleanSchema<undefined>, undefined>, v.DescriptionAction<boolean | undefined, "If true, partial fills are aggregated when a crossing order fills multiple resting orders.">]>;
+}, undefined>, v.DescriptionAction<{
+    type: "userFillsByTime";
+    user: `0x${string}`;
+    startTime: number;
+    endTime?: number | null | undefined;
+    aggregateByTime?: boolean | undefined;
+}, "Request array of user fills by time.">]>;
+export type UserFillsByTimeRequest = v.InferOutput<typeof UserFillsByTimeRequest>;
+/**
+ * Array of user trade fills by time.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills-by-time
+ */
+export declare const UserFillsByTimeResponse: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Asset symbol. */
+    readonly coin: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Asset symbol.">]>;
+    /** Price. */
+    readonly px: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Price.">]>;
+    /** Size. */
+    readonly sz: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Size.">]>;
+    /** Order side ("B" = Bid/Buy, "A" = Ask/Sell). */
+    readonly side: v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<"B", undefined>, v.LiteralSchema<"A", undefined>], undefined>, v.DescriptionAction<"B" | "A", "Order side (\"B\" = Bid/Buy, \"A\" = Ask/Sell).">]>;
+    /** Timestamp when the trade occurred (in ms since epoch). */
+    readonly time: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Timestamp when the trade occurred (in ms since epoch).">]>;
+    /** Start position size. */
+    readonly startPosition: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Start position size.">]>;
+    /** Direction indicator for frontend display. */
+    readonly dir: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Direction indicator for frontend display.">]>;
+    /** Realized PnL. */
+    readonly closedPnl: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Realized PnL.">]>;
+    /** L1 transaction hash. */
+    readonly hash: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>, v.DescriptionAction<`0x${string}`, "L1 transaction hash.">]>;
+    /** Order ID. */
+    readonly oid: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Order ID.">]>;
+    /** Indicates if the fill was a taker order. */
+    readonly crossed: v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Indicates if the fill was a taker order.">]>;
+    /** Fee charged or rebate received (negative indicates rebate). */
+    readonly fee: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Fee charged or rebate received (negative indicates rebate).">]>;
+    /** Unique transaction identifier for a partial fill of an order. */
+    readonly tid: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Unique transaction identifier for a partial fill of an order.">]>;
+    /** Client Order ID. */
+    readonly cloid: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 34, undefined>]>, undefined>, v.DescriptionAction<`0x${string}` | undefined, "Client Order ID.">]>;
+    /** Liquidation details. */
+    readonly liquidation: v.SchemaWithPipe<readonly [v.OptionalSchema<v.ObjectSchema<{
+        /** Address of the liquidated user. */
+        readonly liquidatedUser: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>, v.DescriptionAction<`0x${string}`, "Address of the liquidated user.">]>;
+        /** Mark price at the time of liquidation. */
+        readonly markPx: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Mark price at the time of liquidation.">]>;
+        /** Liquidation method. */
+        readonly method: v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<"market", undefined>, v.LiteralSchema<"backstop", undefined>], undefined>, v.DescriptionAction<"market" | "backstop", "Liquidation method.">]>;
+    }, undefined>, undefined>, v.DescriptionAction<{
+        liquidatedUser: `0x${string}`;
+        markPx: string;
+        method: "market" | "backstop";
+    } | undefined, "Liquidation details.">]>;
+    /** Token in which the fee is denominated (e.g., "USDC"). */
+    readonly feeToken: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Token in which the fee is denominated (e.g., \"USDC\").">]>;
+    /** ID of the TWAP. */
+    readonly twapId: v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.NullSchema<undefined>], undefined>, v.DescriptionAction<number | null, "ID of the TWAP.">]>;
+}, undefined>, v.DescriptionAction<{
+    coin: string;
+    px: string;
+    sz: string;
+    side: "B" | "A";
+    time: number;
+    startPosition: string;
+    dir: string;
+    closedPnl: string;
+    hash: `0x${string}`;
+    oid: number;
+    crossed: boolean;
+    fee: string;
+    tid: number;
+    cloid?: `0x${string}` | undefined;
+    liquidation?: {
+        liquidatedUser: `0x${string}`;
+        markPx: string;
+        method: "market" | "backstop";
+    } | undefined;
+    feeToken: string;
+    twapId: number | null;
+}, "Trade fill record.">]>, undefined>, v.DescriptionAction<{
+    coin: string;
+    px: string;
+    sz: string;
+    side: "B" | "A";
+    time: number;
+    startPosition: string;
+    dir: string;
+    closedPnl: string;
+    hash: `0x${string}`;
+    oid: number;
+    crossed: boolean;
+    fee: string;
+    tid: number;
+    cloid?: `0x${string}` | undefined;
+    liquidation?: {
+        liquidatedUser: `0x${string}`;
+        markPx: string;
+        method: "market" | "backstop";
+    } | undefined;
+    feeToken: string;
+    twapId: number | null;
+}[], "Array of user trade fills by time.">]>;
+export type UserFillsByTimeResponse = v.InferOutput<typeof UserFillsByTimeResponse>;
+/** Request parameters for the {@linkcode userFillsByTime} function. */
+export type UserFillsByTimeParameters = Omit<v.InferInput<typeof UserFillsByTimeRequest>, "type">;
+/**
+ * Request array of user fills by time.
+ * @param config - General configuration for Info API requests.
+ * @param params - Parameters specific to the API request.
+ * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the request by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+ * @returns Array of user trade fills by time.
+ *
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills-by-time
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { userFillsByTime } from "@nktkas/hyperliquid/api/info";
+ *
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ * const data = await userFillsByTime(
+ *   { transport },
+ *   { user: "0x...", startTime: Date.now() - 1000 * 60 * 60 * 24 },
+ * );
+ * ```
+ */
+export declare function userFillsByTime(config: InfoRequestConfig, params: DeepImmutable<UserFillsByTimeParameters>, signal?: AbortSignal): Promise<UserFillsByTimeResponse>;
+//# sourceMappingURL=userFillsByTime.d.ts.map

package/esm/src/api/info/userFillsByTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userFillsByTime.d.ts","sourceRoot":"","sources":["../../../../src/src/api/info/userFillsByTime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAoB,KAAK,aAAa,EAAiD,MAAM,eAAe,CAAC;AACpH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAItD;;;GAGG;AACH,eAAO,MAAM,sBAAsB;IAG7B,uBAAuB;;IAKvB,oBAAoB;;IAKpB,sCAAsC;;IAKtC,oCAAoC;;IAKpC,iGAAiG;;;;;;;;4CAQnG,CAAC;AACL,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,uBAAuB;IAM1B,oBAAoB;;IAKpB,aAAa;;IAKb,YAAY;;IAKZ,kDAAkD;;IAKlD,6DAA6D;;IAK7D,2BAA2B;;IAK3B,gDAAgD;;IAKhD,oBAAoB;;IAKpB,2BAA2B;;IAK3B,gBAAgB;;IAKhB,+CAA+C;;IAK/C,kEAAkE;;IAKlE,oEAAoE;;IAKpE,uBAAuB;;IAKvB,2BAA2B;;QAIrB,sCAAsC;;QAKtC,6CAA6C;;QAK7C,0BAA0B;;;;;;;IAShC,4DAA4D;;IAK5D,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CAW5B,CAAC;AACL,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAIpF,uEAAuE;AACvE,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,EAAE,MAAM,CAAC,CAAC;AAElG;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,aAAa,CAAC,yBAAyB,CAAC,EAChD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,uBAAuB,CAAC,CAMlC"}