@yuants/vendor-hyperliquid 0.9.9 → 0.10.0

package/lib/api/public-api.d.ts

@@ -1,3 +1,8 @@
+export declare const buildUserPerpetualsAccountSummaryRequestBody: (params: {
+    user: string;
+}) => {
+    type: string;
+};
 /**
  * Get user's perpetual account summary including positions, margin, and portfolio information
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary
@@ -48,6 +53,11 @@ export declare const getUserPerpetualsAccountSummary: (params: {
     }[];
     time: number;
 }>;
+export declare const buildPerpetualsMetaDataRequestBody: (params?: {
+    dex?: string;
+}) => {
+    type: string;
+};
 /**
  * Get perpetual market metadata including available assets, their specifications, and margin tiers
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-metadata
@@ -66,17 +76,17 @@ export declare const getPerpetualsMetaData: (params?: {
         onlyIsolated?: boolean;
         isDelisted?: boolean;
     }[];
-    marginTables: [
-        number,
-        {
-            description: string;
-            marginTiers: {
-                lowerBound: string;
-                maxLeverage: number;
-            }[];
-        }
-    ][];
+    marginTables: [number, {
+        description: string;
+        marginTiers: {
+            lowerBound: string;
+            maxLeverage: number;
+        }[];
+    }][];
 }>;
+export declare const buildSpotMetaDataRequestBody: () => {
+    type: string;
+};
 /**
  * Get spot market metadata including available tokens and trading pairs
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-metadata
@@ -101,6 +111,13 @@ export declare const getSpotMetaData: () => Promise<{
         isCanonical: boolean;
     }[];
 }>;
+export declare const buildUserFundingHistoryRequestBody: (params: {
+    user: string;
+    startTime?: number;
+    endTime?: number;
+}) => {
+    type: string;
+};
 /**
  * Get user's funding rate payment history for perpetual positions
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-a-users-funding-history-or-non-funding-ledger-updates
@@ -126,10 +143,15 @@ export declare const getUserFundingHistory: (params: {
         fundingRate: string;
     };
 }[]>;
+export declare const buildUserTokenBalancesRequestBody: (params: {
+    user: string;
+}) => {
+    type: string;
+};
 /**
  * Get user's token balances for both spot and perpetual accounts
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-a-users-token-balances
- * API Endpoint: POST /info (type: tokenBalances)
+ * API Endpoint: POST /info (type: spotClearinghouseState)
  * @param params - Query parameters
  * @param params.user - User's wallet address
  * @returns Promise resolving to array of token balances with held and total amounts
@@ -145,6 +167,11 @@ export declare const getUserTokenBalances: (params: {
         entryNtl: string;
     }[];
 }>;
+export declare const buildUserOpenOrdersRequestBody: (params: {
+    user: string;
+}) => {
+    type: string;
+};
 /**
  * Get user's currently open orders across all markets
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#open-orders
@@ -163,6 +190,13 @@ export declare const getUserOpenOrders: (params: {
     sz: string;
     timestamp: number;
 }[]>;
+export declare const buildHistoricalFundingRatesRequestBody: (params: {
+    coin: string;
+    startTime: number;
+    endTime?: number;
+}) => {
+    type: string;
+};
 /**
  * Get historical funding rates for a specific perpetual asset
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-historical-funding-rates
@@ -183,6 +217,9 @@ export declare const getHistoricalFundingRates: (params: {
     premium: string;
     time: number;
 }[]>;
+export declare const buildAllMidsRequestBody: () => {
+    type: string;
+};
 /**
  * Get current mid prices for all tradable assets
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-mids-for-all-coins
@@ -190,6 +227,9 @@ export declare const getHistoricalFundingRates: (params: {
  * @returns Promise resolving to record of asset symbols mapped to their mid prices
  */
 export declare const getAllMids: () => Promise<Record<string, string>>;
+export declare const buildMetaAndAssetCtxsRequestBody: () => {
+    type: string;
+};
 /**
  * Get metadata and asset contexts (prices, funding, OI) for all perpetuals
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-asset-contexts-includes-mark-price-current-funding-open-interest-etc.
@@ -215,6 +255,16 @@ export declare const getMetaAndAssetCtxs: () => Promise<[{
     premium: string;
     prevDayPx: string;
 }[]]>;
+export declare const buildCandleSnapshotRequestBody: (params: {
+    req: {
+        coin: string;
+        interval: string;
+        startTime: number;
+        endTime: number;
+    };
+}) => {
+    type: string;
+};
 /**
  * Get candle/K-line data for a specific asset and time range
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#candle-snapshot

package/lib/api/public-api.d.ts.map

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

package/lib/api/public-api.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCandleSnapshot = exports.getMetaAndAssetCtxs = exports.getAllMids = exports.getHistoricalFundingRates = exports.getUserOpenOrders = exports.getUserTokenBalances = exports.getUserFundingHistory = exports.getSpotMetaData = exports.getPerpetualsMetaData = exports.getUserPerpetualsAccountSummary = void 0;
+exports.getCandleSnapshot = exports.buildCandleSnapshotRequestBody = exports.getMetaAndAssetCtxs = exports.buildMetaAndAssetCtxsRequestBody = exports.getAllMids = exports.buildAllMidsRequestBody = exports.getHistoricalFundingRates = exports.buildHistoricalFundingRatesRequestBody = exports.getUserOpenOrders = exports.buildUserOpenOrdersRequestBody = exports.getUserTokenBalances = exports.buildUserTokenBalancesRequestBody = exports.getUserFundingHistory = exports.buildUserFundingHistoryRequestBody = exports.getSpotMetaData = exports.buildSpotMetaDataRequestBody = exports.getPerpetualsMetaData = exports.buildPerpetualsMetaDataRequestBody = exports.getUserPerpetualsAccountSummary = exports.buildUserPerpetualsAccountSummaryRequestBody = void 0;
 const client_1 = require("./client");
+const buildInfoRequestBody = (type, params) => (Object.assign(Object.assign({}, (params !== null && params !== void 0 ? params : {})), { type }));
+const buildUserPerpetualsAccountSummaryRequestBody = (params) => buildInfoRequestBody('clearinghouseState', params);
+exports.buildUserPerpetualsAccountSummaryRequestBody = buildUserPerpetualsAccountSummaryRequestBody;
 /**
  * Get user's perpetual account summary including positions, margin, and portfolio information
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary
@@ -10,8 +13,10 @@ const client_1 = require("./client");
  * @param params.user - User's wallet address
  * @returns Promise resolving to account summary with margin information, positions, and portfolio details
  */
-const getUserPerpetualsAccountSummary = (params) => (0, client_1.request)('POST', 'info', Object.assign(Object.assign({}, params), { type: 'clearinghouseState' }));
+const getUserPerpetualsAccountSummary = (params) => (0, client_1.request)('POST', 'info', (0, exports.buildUserPerpetualsAccountSummaryRequestBody)(params));
 exports.getUserPerpetualsAccountSummary = getUserPerpetualsAccountSummary;
+const buildPerpetualsMetaDataRequestBody = (params) => buildInfoRequestBody('meta', params !== null && params !== void 0 ? params : {});
+exports.buildPerpetualsMetaDataRequestBody = buildPerpetualsMetaDataRequestBody;
 /**
  * Get perpetual market metadata including available assets, their specifications, and margin tiers
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-metadata
@@ -20,16 +25,20 @@ exports.getUserPerpetualsAccountSummary = getUserPerpetualsAccountSummary;
  * @param params.dex - Optional DEX identifier
  * @returns Promise resolving to universe of perpetual assets and margin configuration
  */
-const getPerpetualsMetaData = (params) => (0, client_1.request)('POST', 'info', Object.assign(Object.assign({}, (params !== null && params !== void 0 ? params : {})), { type: 'meta' }));
+const getPerpetualsMetaData = (params) => (0, client_1.request)('POST', 'info', (0, exports.buildPerpetualsMetaDataRequestBody)(params));
 exports.getPerpetualsMetaData = getPerpetualsMetaData;
+const buildSpotMetaDataRequestBody = () => buildInfoRequestBody('spotMeta');
+exports.buildSpotMetaDataRequestBody = buildSpotMetaDataRequestBody;
 /**
  * Get spot market metadata including available tokens and trading pairs
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-metadata
  * API Endpoint: POST /info (type: spotMeta)
  * @returns Promise resolving to spot universe with token information and pair configurations
  */
-const getSpotMetaData = () => (0, client_1.request)('POST', 'info', { type: 'spotMeta' });
+const getSpotMetaData = () => (0, client_1.request)('POST', 'info', (0, exports.buildSpotMetaDataRequestBody)());
 exports.getSpotMetaData = getSpotMetaData;
+const buildUserFundingHistoryRequestBody = (params) => buildInfoRequestBody('fundingHistory', params);
+exports.buildUserFundingHistoryRequestBody = buildUserFundingHistoryRequestBody;
 /**
  * Get user's funding rate payment history for perpetual positions
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-a-users-funding-history-or-non-funding-ledger-updates
@@ -40,18 +49,22 @@ exports.getSpotMetaData = getSpotMetaData;
  * @param params.endTime - Optional end timestamp in milliseconds
  * @returns Promise resolving to array of funding payment records with amounts and rates
  */
-const getUserFundingHistory = (params) => (0, client_1.request)('POST', 'info', Object.assign(Object.assign({}, params), { type: 'fundingHistory' }));
+const getUserFundingHistory = (params) => (0, client_1.request)('POST', 'info', (0, exports.buildUserFundingHistoryRequestBody)(params));
 exports.getUserFundingHistory = getUserFundingHistory;
+const buildUserTokenBalancesRequestBody = (params) => buildInfoRequestBody('spotClearinghouseState', params);
+exports.buildUserTokenBalancesRequestBody = buildUserTokenBalancesRequestBody;
 /**
  * Get user's token balances for both spot and perpetual accounts
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-a-users-token-balances
- * API Endpoint: POST /info (type: tokenBalances)
+ * API Endpoint: POST /info (type: spotClearinghouseState)
  * @param params - Query parameters
  * @param params.user - User's wallet address
  * @returns Promise resolving to array of token balances with held and total amounts
  */
-const getUserTokenBalances = (params) => (0, client_1.request)('POST', 'info', Object.assign(Object.assign({}, params), { type: 'spotClearinghouseState' }));
+const getUserTokenBalances = (params) => (0, client_1.request)('POST', 'info', (0, exports.buildUserTokenBalancesRequestBody)(params));
 exports.getUserTokenBalances = getUserTokenBalances;
+const buildUserOpenOrdersRequestBody = (params) => buildInfoRequestBody('openOrders', params);
+exports.buildUserOpenOrdersRequestBody = buildUserOpenOrdersRequestBody;
 /**
  * Get user's currently open orders across all markets
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#open-orders
@@ -60,8 +73,10 @@ exports.getUserTokenBalances = getUserTokenBalances;
  * @param params.user - User's wallet address
  * @returns Promise resolving to array of open order details with prices, sizes, and timestamps
  */
-const getUserOpenOrders = (params) => (0, client_1.request)('POST', 'info', Object.assign(Object.assign({}, params), { type: 'openOrders' }));
+const getUserOpenOrders = (params) => (0, client_1.request)('POST', 'info', (0, exports.buildUserOpenOrdersRequestBody)(params));
 exports.getUserOpenOrders = getUserOpenOrders;
+const buildHistoricalFundingRatesRequestBody = (params) => buildInfoRequestBody('fundingHistory', params);
+exports.buildHistoricalFundingRatesRequestBody = buildHistoricalFundingRatesRequestBody;
 /**
  * Get historical funding rates for a specific perpetual asset
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-historical-funding-rates
@@ -72,24 +87,30 @@ exports.getUserOpenOrders = getUserOpenOrders;
  * @param params.endTime - Optional end timestamp in milliseconds
  * @returns Promise resolving to array of historical funding rate records
  */
-const getHistoricalFundingRates = (params) => (0, client_1.request)('POST', 'info', Object.assign(Object.assign({}, params), { type: 'fundingHistory' }));
+const getHistoricalFundingRates = (params) => (0, client_1.request)('POST', 'info', (0, exports.buildHistoricalFundingRatesRequestBody)(params));
 exports.getHistoricalFundingRates = getHistoricalFundingRates;
+const buildAllMidsRequestBody = () => buildInfoRequestBody('allMids');
+exports.buildAllMidsRequestBody = buildAllMidsRequestBody;
 /**
  * Get current mid prices for all tradable assets
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-mids-for-all-coins
  * API Endpoint: POST /info (type: allMids)
  * @returns Promise resolving to record of asset symbols mapped to their mid prices
  */
-const getAllMids = () => (0, client_1.request)('POST', 'info', { type: 'allMids' });
+const getAllMids = () => (0, client_1.request)('POST', 'info', (0, exports.buildAllMidsRequestBody)());
 exports.getAllMids = getAllMids;
+const buildMetaAndAssetCtxsRequestBody = () => buildInfoRequestBody('metaAndAssetCtxs');
+exports.buildMetaAndAssetCtxsRequestBody = buildMetaAndAssetCtxsRequestBody;
 /**
  * Get metadata and asset contexts (prices, funding, OI) for all perpetuals
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-asset-contexts-includes-mark-price-current-funding-open-interest-etc.
  * API Endpoint: POST /info (type: metaAndAssetCtxs)
  * @returns Promise resolving to metadata and current asset contexts
  */
-const getMetaAndAssetCtxs = () => (0, client_1.request)('POST', 'info', { type: 'metaAndAssetCtxs' });
+const getMetaAndAssetCtxs = () => (0, client_1.request)('POST', 'info', (0, exports.buildMetaAndAssetCtxsRequestBody)());
 exports.getMetaAndAssetCtxs = getMetaAndAssetCtxs;
+const buildCandleSnapshotRequestBody = (params) => buildInfoRequestBody('candleSnapshot', params);
+exports.buildCandleSnapshotRequestBody = buildCandleSnapshotRequestBody;
 /**
  * Get candle/K-line data for a specific asset and time range
  * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#candle-snapshot
@@ -102,6 +123,6 @@ exports.getMetaAndAssetCtxs = getMetaAndAssetCtxs;
  * @param params.req.endTime - End timestamp in milliseconds
  * @returns Promise resolving to candle data with OHLCV information
  */
-const getCandleSnapshot = (params) => (0, client_1.request)('POST', 'info', Object.assign({ type: 'candleSnapshot' }, params));
+const getCandleSnapshot = (params) => (0, client_1.request)('POST', 'info', (0, exports.buildCandleSnapshotRequestBody)(params));
 exports.getCandleSnapshot = getCandleSnapshot;
 //# sourceMappingURL=public-api.js.map

package/lib/api/public-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../../src/api/public-api.ts"],"names":[],"mappings":";;;AAAA,qCAAmC;AAEnC;;;;;;;GAOG;AACI,MAAM,+BAA+B,GAAG,CAAC,MAAwB,EAAE,EAAE,CAC1E,IAAA,gBAAO,EAoCJ,MAAM,EAAE,MAAM,kCAAO,MAAM,KAAE,IAAI,EAAE,oBAAoB,IAAG,CAAC;AArCnD,QAAA,+BAA+B,mCAqCoB;AAEhE;;;;;;;GAOG;AACI,MAAM,qBAAqB,GAAG,CAAC,MAAyB,EAAE,EAAE,CACjE,IAAA,gBAAO,EAkBJ,MAAM,EAAE,MAAM,kCAAO,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,KAAE,IAAI,EAAE,MAAM,IAAG,CAAC;AAnB7C,QAAA,qBAAqB,yBAmBwB;AAE1D;;;;;GAKG;AACI,MAAM,eAAe,GAAG,GAAG,EAAE,CAClC,IAAA,gBAAO,EAiBJ,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;AAlB9B,QAAA,eAAe,mBAkBe;AAE3C;;;;;;;;;GASG;AACI,MAAM,qBAAqB,GAAG,CAAC,MAA8D,EAAE,EAAE,CACtG,IAAA,gBAAO,EAML,MAAM,EAAE,MAAM,kCAAO,MAAM,KAAE,IAAI,EAAE,gBAAgB,IAAG,CAAC;AAP9C,QAAA,qBAAqB,yBAOyB;AAE3D;;;;;;;GAOG;AACI,MAAM,oBAAoB,GAAG,CAAC,MAAwB,EAAE,EAAE,CAC/D,IAAA,gBAAO,EACL,MAAM,EACN,MAAM,kCAED,MAAM,KACT,IAAI,EAAE,wBAAwB,IAEjC,CAAC;AARS,QAAA,oBAAoB,wBAQ7B;AAEJ;;;;;;;GAOG;AACI,MAAM,iBAAiB,GAAG,CAAC,MAAwB,EAAE,EAAE,CAC5D,IAAA,gBAAO,EACL,MAAM,EACN,MAAM,kCAED,MAAM,KACT,IAAI,EAAE,YAAY,IAErB,CAAC;AARS,QAAA,iBAAiB,qBAQ1B;AAEJ;;;;;;;;;GASG;AACI,MAAM,yBAAyB,GAAG,CAAC,MAA6D,EAAE,EAAE,CACzG,IAAA,gBAAO,EAAyE,MAAM,EAAE,MAAM,kCACzF,MAAM,KACT,IAAI,EAAE,gBAAgB,IACtB,CAAC;AAJQ,QAAA,yBAAyB,6BAIjC;AAEL;;;;;GAKG;AACI,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,IAAA,gBAAO,EAAyB,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AAAxF,QAAA,UAAU,cAA8E;AAErG;;;;;GAKG;AACI,MAAM,mBAAmB,GAAG,GAAG,EAAE,CACtC,IAAA,gBAAO,EAuBL,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAxBrC,QAAA,mBAAmB,uBAwBkB;AAElD;;;;;;;;;;;GAWG;AACI,MAAM,iBAAiB,GAAG,CAAC,MAEjC,EAAE,EAAE,CACH,IAAA,gBAAO,EAaL,MAAM,EAAE,MAAM,kBAAI,IAAI,EAAE,gBAAgB,IAAK,MAAM,EAAG,CAAC;AAhB9C,QAAA,iBAAiB,qBAgB6B","sourcesContent":["import { request } from './client';\n\n/**\n * Get user's perpetual account summary including positions, margin, and portfolio information\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary\n * API Endpoint: POST /info (type: clearinghouseState)\n * @param params - Query parameters\n * @param params.user - User's wallet address\n * @returns Promise resolving to account summary with margin information, positions, and portfolio details\n */\nexport const getUserPerpetualsAccountSummary = (params: { user: string }) =>\n  request<{\n    marginSummary: {\n      accountValue: string;\n      totalNtlPos: string;\n      totalRawUsd: string;\n      totalMarginUsed: string;\n    };\n    crossMarginSummary: {\n      accountValue: string;\n      totalNtlPos: string;\n      totalRawUsd: string;\n      totalMarginUsed: string;\n    };\n    crossMaintenanceMarginUsed: string;\n    withdrawable: string;\n    assetPositions: {\n      type: string;\n      position: {\n        coin: string;\n        szi: string;\n        leverage: { type: string; value: number };\n        entryPx: string;\n        positionValue: string;\n        unrealizedPnl: string;\n        returnOnEquity: string;\n        liquidationPx: string;\n        marginUsed: string;\n        maxLeverage: number;\n        cumFunding: {\n          allTime: string;\n          sinceOpen: string;\n          sinceChange: string;\n        };\n      };\n    }[];\n    time: number;\n  }>('POST', 'info', { ...params, type: 'clearinghouseState' });\n\n/**\n * Get perpetual market metadata including available assets, their specifications, and margin tiers\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-metadata\n * API Endpoint: POST /info (type: meta)\n * @param params - Optional query parameters\n * @param params.dex - Optional DEX identifier\n * @returns Promise resolving to universe of perpetual assets and margin configuration\n */\nexport const getPerpetualsMetaData = (params?: { dex?: string }) =>\n  request<{\n    universe: {\n      name: string;\n      szDecimals: number;\n      maxLeverage: number;\n      onlyIsolated?: boolean;\n      isDelisted?: boolean;\n    }[];\n    marginTables: [\n      number,\n      {\n        description: string;\n        marginTiers: {\n          lowerBound: string;\n          maxLeverage: number;\n        }[];\n      },\n    ][];\n  }>('POST', 'info', { ...(params ?? {}), type: 'meta' });\n\n/**\n * Get spot market metadata including available tokens and trading pairs\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-metadata\n * API Endpoint: POST /info (type: spotMeta)\n * @returns Promise resolving to spot universe with token information and pair configurations\n */\nexport const getSpotMetaData = () =>\n  request<{\n    tokens: {\n      name: string;\n      szDecimals: number;\n      weiDecimals: number;\n      index: number;\n      tokenId: string;\n      isCanonical: boolean;\n      evmContract: null;\n      fullName: null;\n    }[];\n    universe: {\n      name: string;\n      tokens: number[];\n      index: number;\n      isCanonical: boolean;\n    }[];\n  }>('POST', 'info', { type: 'spotMeta' });\n\n/**\n * Get user's funding rate payment history for perpetual positions\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-a-users-funding-history-or-non-funding-ledger-updates\n * API Endpoint: POST /info (type: fundingHistory)\n * @param params - Query parameters\n * @param params.user - User's wallet address\n * @param params.startTime - Optional start timestamp in milliseconds\n * @param params.endTime - Optional end timestamp in milliseconds\n * @returns Promise resolving to array of funding payment records with amounts and rates\n */\nexport const getUserFundingHistory = (params: { user: string; startTime?: number; endTime?: number }) =>\n  request<\n    {\n      time: number;\n      hash: string;\n      delta: { type: string; coin: string; usdc: string; szi: string; fundingRate: string };\n    }[]\n  >('POST', 'info', { ...params, type: 'fundingHistory' });\n\n/**\n * Get user's token balances for both spot and perpetual accounts\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-a-users-token-balances\n * API Endpoint: POST /info (type: tokenBalances)\n * @param params - Query parameters\n * @param params.user - User's wallet address\n * @returns Promise resolving to array of token balances with held and total amounts\n */\nexport const getUserTokenBalances = (params: { user: string }) =>\n  request<{ balances: { coin: string; token: number; hold: string; total: string; entryNtl: string }[] }>(\n    'POST',\n    'info',\n    {\n      ...params,\n      type: 'spotClearinghouseState',\n    },\n  );\n\n/**\n * Get user's currently open orders across all markets\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#open-orders\n * API Endpoint: POST /info (type: openOrders)\n * @param params - Query parameters\n * @param params.user - User's wallet address\n * @returns Promise resolving to array of open order details with prices, sizes, and timestamps\n */\nexport const getUserOpenOrders = (params: { user: string }) =>\n  request<{ coin: string; limitPx: string; oid: number; side: string; sz: string; timestamp: number }[]>(\n    'POST',\n    'info',\n    {\n      ...params,\n      type: 'openOrders',\n    },\n  );\n\n/**\n * Get historical funding rates for a specific perpetual asset\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-historical-funding-rates\n * API Endpoint: POST /info (type: fundingHistory)\n * @param params - Query parameters\n * @param params.coin - Asset symbol (e.g., \"BTC\", \"ETH\")\n * @param params.startTime - Start timestamp in milliseconds\n * @param params.endTime - Optional end timestamp in milliseconds\n * @returns Promise resolving to array of historical funding rate records\n */\nexport const getHistoricalFundingRates = (params: { coin: string; startTime: number; endTime?: number }) =>\n  request<{ coin: string; fundingRate: string; premium: string; time: number }[]>('POST', 'info', {\n    ...params,\n    type: 'fundingHistory',\n  });\n\n/**\n * Get current mid prices for all tradable assets\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-mids-for-all-coins\n * API Endpoint: POST /info (type: allMids)\n * @returns Promise resolving to record of asset symbols mapped to their mid prices\n */\nexport const getAllMids = () => request<Record<string, string>>('POST', 'info', { type: 'allMids' });\n\n/**\n * Get metadata and asset contexts (prices, funding, OI) for all perpetuals\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-asset-contexts-includes-mark-price-current-funding-open-interest-etc.\n * API Endpoint: POST /info (type: metaAndAssetCtxs)\n * @returns Promise resolving to metadata and current asset contexts\n */\nexport const getMetaAndAssetCtxs = () =>\n  request<\n    [\n      {\n        universe: {\n          name: string;\n          szDecimals: number;\n          maxLeverage: number;\n          onlyIsolated?: boolean;\n          isDelisted?: boolean;\n        }[];\n      },\n      {\n        dayNtlVlm: string;\n        funding: string;\n        impactPxs: [string, string];\n        markPx: string;\n        midPx: string;\n        openInterest: string;\n        oraclePx: string;\n        premium: string;\n        prevDayPx: string;\n      }[],\n    ]\n  >('POST', 'info', { type: 'metaAndAssetCtxs' });\n\n/**\n * Get candle/K-line data for a specific asset and time range\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#candle-snapshot\n * API Endpoint: POST /info (type: candleSnapshot)\n * @param params - Query parameters\n * @param params.req - Request object with candle parameters\n * @param params.req.coin - Asset symbol\n * @param params.req.interval - Time interval (e.g., \"1m\", \"5m\", \"1h\", \"1d\")\n * @param params.req.startTime - Start timestamp in milliseconds\n * @param params.req.endTime - End timestamp in milliseconds\n * @returns Promise resolving to candle data with OHLCV information\n */\nexport const getCandleSnapshot = (params: {\n  req: { coin: string; interval: string; startTime: number; endTime: number };\n}) =>\n  request<\n    {\n      T: number;\n      c: string;\n      h: string;\n      i: string;\n      l: string;\n      o: string;\n      n: number;\n      s: string;\n      t: number;\n      v: string;\n    }[]\n  >('POST', 'info', { type: 'candleSnapshot', ...params });\n"]}
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../../src/api/public-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { request } from './client';\n\nconst buildInfoRequestBody = <P extends Record<string, unknown>>(type: string, params?: P) => ({\n  ...(params ?? {}),\n  type,\n});\n\nexport const buildUserPerpetualsAccountSummaryRequestBody = (params: { user: string }) =>\n  buildInfoRequestBody('clearinghouseState', params);\n\n/**\n * Get user's perpetual account summary including positions, margin, and portfolio information\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary\n * API Endpoint: POST /info (type: clearinghouseState)\n * @param params - Query parameters\n * @param params.user - User's wallet address\n * @returns Promise resolving to account summary with margin information, positions, and portfolio details\n */\nexport const getUserPerpetualsAccountSummary = (params: { user: string }) =>\n  request<{\n    marginSummary: {\n      accountValue: string;\n      totalNtlPos: string;\n      totalRawUsd: string;\n      totalMarginUsed: string;\n    };\n    crossMarginSummary: {\n      accountValue: string;\n      totalNtlPos: string;\n      totalRawUsd: string;\n      totalMarginUsed: string;\n    };\n    crossMaintenanceMarginUsed: string;\n    withdrawable: string;\n    assetPositions: {\n      type: string;\n      position: {\n        coin: string;\n        szi: string;\n        leverage: { type: string; value: number };\n        entryPx: string;\n        positionValue: string;\n        unrealizedPnl: string;\n        returnOnEquity: string;\n        liquidationPx: string;\n        marginUsed: string;\n        maxLeverage: number;\n        cumFunding: {\n          allTime: string;\n          sinceOpen: string;\n          sinceChange: string;\n        };\n      };\n    }[];\n    time: number;\n  }>('POST', 'info', buildUserPerpetualsAccountSummaryRequestBody(params));\n\nexport const buildPerpetualsMetaDataRequestBody = (params?: { dex?: string }) =>\n  buildInfoRequestBody('meta', params ?? {});\n\n/**\n * Get perpetual market metadata including available assets, their specifications, and margin tiers\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-metadata\n * API Endpoint: POST /info (type: meta)\n * @param params - Optional query parameters\n * @param params.dex - Optional DEX identifier\n * @returns Promise resolving to universe of perpetual assets and margin configuration\n */\nexport const getPerpetualsMetaData = (params?: { dex?: string }) =>\n  request<{\n    universe: {\n      name: string;\n      szDecimals: number;\n      maxLeverage: number;\n      onlyIsolated?: boolean;\n      isDelisted?: boolean;\n    }[];\n    marginTables: [\n      number,\n      {\n        description: string;\n        marginTiers: {\n          lowerBound: string;\n          maxLeverage: number;\n        }[];\n      },\n    ][];\n  }>('POST', 'info', buildPerpetualsMetaDataRequestBody(params));\n\nexport const buildSpotMetaDataRequestBody = () => buildInfoRequestBody('spotMeta');\n\n/**\n * Get spot market metadata including available tokens and trading pairs\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-metadata\n * API Endpoint: POST /info (type: spotMeta)\n * @returns Promise resolving to spot universe with token information and pair configurations\n */\nexport const getSpotMetaData = () =>\n  request<{\n    tokens: {\n      name: string;\n      szDecimals: number;\n      weiDecimals: number;\n      index: number;\n      tokenId: string;\n      isCanonical: boolean;\n      evmContract: null;\n      fullName: null;\n    }[];\n    universe: {\n      name: string;\n      tokens: number[];\n      index: number;\n      isCanonical: boolean;\n    }[];\n  }>('POST', 'info', buildSpotMetaDataRequestBody());\n\nexport const buildUserFundingHistoryRequestBody = (params: {\n  user: string;\n  startTime?: number;\n  endTime?: number;\n}) => buildInfoRequestBody('fundingHistory', params);\n\n/**\n * Get user's funding rate payment history for perpetual positions\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-a-users-funding-history-or-non-funding-ledger-updates\n * API Endpoint: POST /info (type: fundingHistory)\n * @param params - Query parameters\n * @param params.user - User's wallet address\n * @param params.startTime - Optional start timestamp in milliseconds\n * @param params.endTime - Optional end timestamp in milliseconds\n * @returns Promise resolving to array of funding payment records with amounts and rates\n */\nexport const getUserFundingHistory = (params: { user: string; startTime?: number; endTime?: number }) =>\n  request<\n    {\n      time: number;\n      hash: string;\n      delta: { type: string; coin: string; usdc: string; szi: string; fundingRate: string };\n    }[]\n  >('POST', 'info', buildUserFundingHistoryRequestBody(params));\n\nexport const buildUserTokenBalancesRequestBody = (params: { user: string }) =>\n  buildInfoRequestBody('spotClearinghouseState', params);\n\n/**\n * Get user's token balances for both spot and perpetual accounts\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-a-users-token-balances\n * API Endpoint: POST /info (type: spotClearinghouseState)\n * @param params - Query parameters\n * @param params.user - User's wallet address\n * @returns Promise resolving to array of token balances with held and total amounts\n */\nexport const getUserTokenBalances = (params: { user: string }) =>\n  request<{ balances: { coin: string; token: number; hold: string; total: string; entryNtl: string }[] }>(\n    'POST',\n    'info',\n    buildUserTokenBalancesRequestBody(params),\n  );\n\nexport const buildUserOpenOrdersRequestBody = (params: { user: string }) =>\n  buildInfoRequestBody('openOrders', params);\n\n/**\n * Get user's currently open orders across all markets\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#open-orders\n * API Endpoint: POST /info (type: openOrders)\n * @param params - Query parameters\n * @param params.user - User's wallet address\n * @returns Promise resolving to array of open order details with prices, sizes, and timestamps\n */\nexport const getUserOpenOrders = (params: { user: string }) =>\n  request<{ coin: string; limitPx: string; oid: number; side: string; sz: string; timestamp: number }[]>(\n    'POST',\n    'info',\n    buildUserOpenOrdersRequestBody(params),\n  );\n\nexport const buildHistoricalFundingRatesRequestBody = (params: {\n  coin: string;\n  startTime: number;\n  endTime?: number;\n}) => buildInfoRequestBody('fundingHistory', params);\n\n/**\n * Get historical funding rates for a specific perpetual asset\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-historical-funding-rates\n * API Endpoint: POST /info (type: fundingHistory)\n * @param params - Query parameters\n * @param params.coin - Asset symbol (e.g., \"BTC\", \"ETH\")\n * @param params.startTime - Start timestamp in milliseconds\n * @param params.endTime - Optional end timestamp in milliseconds\n * @returns Promise resolving to array of historical funding rate records\n */\nexport const getHistoricalFundingRates = (params: { coin: string; startTime: number; endTime?: number }) =>\n  request<{ coin: string; fundingRate: string; premium: string; time: number }[]>(\n    'POST',\n    'info',\n    buildHistoricalFundingRatesRequestBody(params),\n  );\n\nexport const buildAllMidsRequestBody = () => buildInfoRequestBody('allMids');\n\n/**\n * Get current mid prices for all tradable assets\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-mids-for-all-coins\n * API Endpoint: POST /info (type: allMids)\n * @returns Promise resolving to record of asset symbols mapped to their mid prices\n */\nexport const getAllMids = () => request<Record<string, string>>('POST', 'info', buildAllMidsRequestBody());\n\nexport const buildMetaAndAssetCtxsRequestBody = () => buildInfoRequestBody('metaAndAssetCtxs');\n\n/**\n * Get metadata and asset contexts (prices, funding, OI) for all perpetuals\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-asset-contexts-includes-mark-price-current-funding-open-interest-etc.\n * API Endpoint: POST /info (type: metaAndAssetCtxs)\n * @returns Promise resolving to metadata and current asset contexts\n */\nexport const getMetaAndAssetCtxs = () =>\n  request<\n    [\n      {\n        universe: {\n          name: string;\n          szDecimals: number;\n          maxLeverage: number;\n          onlyIsolated?: boolean;\n          isDelisted?: boolean;\n        }[];\n      },\n      {\n        dayNtlVlm: string;\n        funding: string;\n        impactPxs: [string, string];\n        markPx: string;\n        midPx: string;\n        openInterest: string;\n        oraclePx: string;\n        premium: string;\n        prevDayPx: string;\n      }[],\n    ]\n  >('POST', 'info', buildMetaAndAssetCtxsRequestBody());\n\nexport const buildCandleSnapshotRequestBody = (params: {\n  req: { coin: string; interval: string; startTime: number; endTime: number };\n}) => buildInfoRequestBody('candleSnapshot', params);\n\n/**\n * Get candle/K-line data for a specific asset and time range\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#candle-snapshot\n * API Endpoint: POST /info (type: candleSnapshot)\n * @param params - Query parameters\n * @param params.req - Request object with candle parameters\n * @param params.req.coin - Asset symbol\n * @param params.req.interval - Time interval (e.g., \"1m\", \"5m\", \"1h\", \"1d\")\n * @param params.req.startTime - Start timestamp in milliseconds\n * @param params.req.endTime - End timestamp in milliseconds\n * @returns Promise resolving to candle data with OHLCV information\n */\nexport const getCandleSnapshot = (params: {\n  req: { coin: string; interval: string; startTime: number; endTime: number };\n}) =>\n  request<\n    {\n      T: number;\n      c: string;\n      h: string;\n      i: string;\n      l: string;\n      o: string;\n      n: number;\n      s: string;\n      t: number;\n      v: string;\n    }[]\n  >('POST', 'info', buildCandleSnapshotRequestBody(params));\n"]}

package/lib/api/rate-limit.d.ts

@@ -0,0 +1,21 @@
+type HttpMethod = 'GET' | 'POST';
+type RestRequestContext = Readonly<{
+    method: HttpMethod;
+    path: string;
+    body?: unknown;
+    kind: 'info' | 'exchange' | 'explorer' | 'other';
+    infoType?: string;
+    exchangeActionType?: string;
+    exchangeBatchLength?: number;
+}>;
+export declare const getRestRequestContext: (method: HttpMethod, path: string, body?: unknown) => RestRequestContext;
+export declare const getRestBaseWeight: (ctx: RestRequestContext) => number;
+export declare const getRestEstimatedExtraWeight: (ctx: RestRequestContext) => number;
+export declare const acquireRestIpWeightSync: (meta: Record<string, unknown>, weight: number) => void;
+export declare const beforeRestRequest: (meta: Record<string, unknown>, ctx: RestRequestContext) => Readonly<{
+    baseWeight: number;
+    estimatedExtraWeight: number;
+}>;
+export declare const afterRestResponse: (meta: Record<string, unknown>, ctx: RestRequestContext, response: unknown, estimatedExtraWeight: number) => Promise<void>;
+export {};
+//# sourceMappingURL=rate-limit.d.ts.map

package/lib/api/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/api/rate-limit.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;AAEjC,KAAK,kBAAkB,GAAG,QAAQ,CAAC;IACjC,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC,CAAC;AAkEH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,UAAU,EAClB,MAAM,MAAM,EACZ,OAAO,OAAO,KACb,kBAmBF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,KAAK,kBAAkB,KAAG,MAY3D,CAAC;AA0DF,eAAO,MAAM,2BAA2B,GAAI,KAAK,kBAAkB,KAAG,MAQrE,CAAC;AAoBF,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,MAAM,SAKpF,CAAC;AAeF,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,kBAAkB,KACtB,QAAQ,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,CAK/D,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,kBAAkB,EACvB,UAAU,OAAO,EACjB,sBAAsB,MAAM,kBAc7B,CAAC"}

package/lib/api/rate-limit.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.afterRestResponse = exports.beforeRestRequest = exports.acquireRestIpWeightSync = exports.getRestEstimatedExtraWeight = exports.getRestBaseWeight = exports.getRestRequestContext = void 0;
+const utils_1 = require("@yuants/utils");
+const REST_IP_BUCKET_ID = 'HYPERLIQUID_REST_IP_WEIGHT_1200_PER_MIN';
+const REST_IP_BUCKET_CAPACITY = 1200;
+const REST_IP_WEIGHT_MAX = REST_IP_BUCKET_CAPACITY * 10;
+(0, utils_1.tokenBucket)(REST_IP_BUCKET_ID, {
+    capacity: REST_IP_BUCKET_CAPACITY,
+    refillInterval: 60000,
+    refillAmount: 1200,
+});
+const INFO_TYPE_TO_BASE_WEIGHT = {
+    l2Book: 2,
+    allMids: 2,
+    clearinghouseState: 2,
+    orderStatus: 2,
+    spotClearinghouseState: 2,
+    exchangeStatus: 2,
+    userRole: 60,
+};
+const INTERVAL_TO_MS = {
+    '1m': 60000,
+    '3m': 180000,
+    '5m': 300000,
+    '15m': 900000,
+    '30m': 1800000,
+    '1h': 3600000,
+    '2h': 7200000,
+    '4h': 14400000,
+    '8h': 28800000,
+    '12h': 43200000,
+    '1d': 86400000,
+    '3d': 259200000,
+    '1w': 604800000,
+    '1M': 2592000000,
+};
+const getObject = (value) => {
+    if (typeof value !== 'object' || value === null)
+        return;
+    return value;
+};
+const getString = (value) => {
+    if (typeof value !== 'string')
+        return;
+    return value;
+};
+const getNumber = (value) => {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return;
+    return value;
+};
+const getArray = (value) => {
+    if (!Array.isArray(value))
+        return;
+    return value;
+};
+const getRestRequestContext = (method, path, body) => {
+    var _a, _b;
+    if (method === 'POST' && path === 'info') {
+        const obj = getObject(body);
+        const infoType = getString(obj === null || obj === void 0 ? void 0 : obj.type);
+        return { method, path, body, kind: 'info', infoType };
+    }
+    if (method === 'POST' && path === 'exchange') {
+        const obj = getObject(body);
+        const action = getObject(obj === null || obj === void 0 ? void 0 : obj.action);
+        const exchangeActionType = getString(action === null || action === void 0 ? void 0 : action.type);
+        const orders = getArray(action === null || action === void 0 ? void 0 : action.orders);
+        const cancels = getArray(action === null || action === void 0 ? void 0 : action.cancels);
+        const exchangeBatchLength = Math.max(1, (_b = (_a = orders === null || orders === void 0 ? void 0 : orders.length) !== null && _a !== void 0 ? _a : cancels === null || cancels === void 0 ? void 0 : cancels.length) !== null && _b !== void 0 ? _b : 1);
+        return { method, path, body, kind: 'exchange', exchangeActionType, exchangeBatchLength };
+    }
+    if (path.startsWith('explorer')) {
+        return { method, path, body, kind: 'explorer' };
+    }
+    return { method, path, body, kind: 'other' };
+};
+exports.getRestRequestContext = getRestRequestContext;
+const getRestBaseWeight = (ctx) => {
+    var _a, _b, _c;
+    if (ctx.kind === 'exchange') {
+        const batchLength = Math.max(1, (_a = ctx.exchangeBatchLength) !== null && _a !== void 0 ? _a : 1);
+        return 1 + Math.floor(batchLength / 40);
+    }
+    if (ctx.kind === 'info') {
+        return (_c = INFO_TYPE_TO_BASE_WEIGHT[(_b = ctx.infoType) !== null && _b !== void 0 ? _b : '']) !== null && _c !== void 0 ? _c : 20;
+    }
+    if (ctx.kind === 'explorer') {
+        return 40;
+    }
+    return 20;
+};
+exports.getRestBaseWeight = getRestBaseWeight;
+const estimateCandleSnapshotItems = (ctx) => {
+    var _a;
+    if (ctx.kind !== 'info' || ctx.infoType !== 'candleSnapshot')
+        return 0;
+    const bodyObj = getObject(ctx.body);
+    const reqObj = getObject(bodyObj === null || bodyObj === void 0 ? void 0 : bodyObj.req);
+    const interval = getString(reqObj === null || reqObj === void 0 ? void 0 : reqObj.interval);
+    const startTime = getNumber(reqObj === null || reqObj === void 0 ? void 0 : reqObj.startTime);
+    const endTime = getNumber(reqObj === null || reqObj === void 0 ? void 0 : reqObj.endTime);
+    if (!interval || startTime === undefined || endTime === undefined || endTime <= startTime)
+        return 0;
+    const intervalMs = (_a = INTERVAL_TO_MS[interval]) !== null && _a !== void 0 ? _a : 0;
+    if (!intervalMs)
+        return 0;
+    // Hyperliquid docs: Only the most recent 5000 candles are available
+    const estimated = Math.ceil((endTime - startTime) / intervalMs);
+    return Math.min(5000, Math.max(0, estimated));
+};
+const countArrayResponseItems = (response) => {
+    var _a;
+    const arr = getArray(response);
+    return (_a = arr === null || arr === void 0 ? void 0 : arr.length) !== null && _a !== void 0 ? _a : 0;
+};
+const countUserFillsItems = (response) => {
+    var _a;
+    const obj = getObject(response);
+    const fills = getArray(obj === null || obj === void 0 ? void 0 : obj.fills);
+    return (_a = fills === null || fills === void 0 ? void 0 : fills.length) !== null && _a !== void 0 ? _a : 0;
+};
+const extraWeighers = [
+    {
+        match: (ctx) => ctx.kind === 'info' && ctx.infoType === 'candleSnapshot',
+        divisor: 60,
+        estimateItems: estimateCandleSnapshotItems,
+        countItemsFromResponse: countArrayResponseItems,
+    },
+    {
+        match: (ctx) => ctx.kind === 'info' &&
+            (ctx.infoType === 'recentTrades' ||
+                ctx.infoType === 'historicalOrders' ||
+                ctx.infoType === 'userFills' ||
+                ctx.infoType === 'userFillsByTime' ||
+                ctx.infoType === 'fundingHistory' ||
+                ctx.infoType === 'userFunding' ||
+                ctx.infoType === 'nonUserFundingUpdates' ||
+                ctx.infoType === 'twapHistory' ||
+                ctx.infoType === 'userTwapSliceFills' ||
+                ctx.infoType === 'userTwapSliceFillsByTime' ||
+                ctx.infoType === 'delegatorHistory' ||
+                ctx.infoType === 'delegatorRewards' ||
+                ctx.infoType === 'validatorStats'),
+        divisor: 20,
+        countItemsFromResponse: (response) => countUserFillsItems(response) || countArrayResponseItems(response),
+    },
+];
+const getRestEstimatedExtraWeight = (ctx) => {
+    var _a, _b;
+    for (const weigher of extraWeighers) {
+        if (!weigher.match(ctx))
+            continue;
+        const items = (_b = (_a = weigher.estimateItems) === null || _a === void 0 ? void 0 : _a.call(weigher, ctx)) !== null && _b !== void 0 ? _b : 0;
+        if (items <= 0)
+            return 0;
+        return Math.ceil(items / weigher.divisor);
+    }
+    return 0;
+};
+exports.getRestEstimatedExtraWeight = getRestEstimatedExtraWeight;
+const normalizeRestWeight = (meta, weight) => {
+    if (!Number.isFinite(weight)) {
+        throw (0, utils_1.newError)('HYPERLIQUID_REST_WEIGHT_INVALID', Object.assign(Object.assign({}, meta), { weight }));
+    }
+    const normalized = Math.floor(weight);
+    if (normalized <= 0) {
+        throw (0, utils_1.newError)('HYPERLIQUID_REST_WEIGHT_INVALID', Object.assign(Object.assign({}, meta), { weight: normalized }));
+    }
+    if (normalized > REST_IP_WEIGHT_MAX) {
+        throw (0, utils_1.newError)('HYPERLIQUID_REST_WEIGHT_EXCESSIVE', Object.assign(Object.assign({}, meta), { weight: normalized, maxWeight: REST_IP_WEIGHT_MAX }));
+    }
+    return normalized;
+};
+const acquireRestIpWeightSync = (meta, weight) => {
+    const normalized = normalizeRestWeight(meta, weight);
+    (0, utils_1.scopeError)('HYPERLIQUID_API_RATE_LIMIT', Object.assign(Object.assign({}, meta), { bucketId: REST_IP_BUCKET_ID, weight: normalized }), () => (0, utils_1.tokenBucket)(REST_IP_BUCKET_ID).acquireSync(normalized));
+};
+exports.acquireRestIpWeightSync = acquireRestIpWeightSync;
+const acquireRestIpWeight = async (meta, weight) => {
+    let remaining = normalizeRestWeight(meta, weight);
+    while (remaining > 0) {
+        const chunk = Math.min(REST_IP_BUCKET_CAPACITY, remaining);
+        await (0, utils_1.scopeError)('HYPERLIQUID_API_RATE_LIMIT', Object.assign(Object.assign({}, meta), { bucketId: REST_IP_BUCKET_ID, weight: chunk, remaining }), () => (0, utils_1.tokenBucket)(REST_IP_BUCKET_ID).acquire(chunk));
+        remaining -= chunk;
+    }
+};
+const beforeRestRequest = (meta, ctx) => {
+    const baseWeight = (0, exports.getRestBaseWeight)(ctx);
+    const estimatedExtraWeight = (0, exports.getRestEstimatedExtraWeight)(ctx);
+    (0, exports.acquireRestIpWeightSync)(meta, baseWeight + estimatedExtraWeight);
+    return { baseWeight, estimatedExtraWeight };
+};
+exports.beforeRestRequest = beforeRestRequest;
+const afterRestResponse = async (meta, ctx, response, estimatedExtraWeight) => {
+    var _a, _b;
+    for (const weigher of extraWeighers) {
+        if (!weigher.match(ctx))
+            continue;
+        const items = (_b = (_a = weigher.countItemsFromResponse) === null || _a === void 0 ? void 0 : _a.call(weigher, response)) !== null && _b !== void 0 ? _b : 0;
+        if (items <= 0)
+            return;
+        const actualExtraWeight = Math.ceil(items / weigher.divisor);
+        const delta = actualExtraWeight - estimatedExtraWeight;
+        if (delta > 0) {
+            // 不使用 acquireSync：响应后只阻塞等待，不报错
+            await acquireRestIpWeight(meta, delta);
+        }
+        return;
+    }
+};
+exports.afterRestResponse = afterRestResponse;
+//# sourceMappingURL=rate-limit.js.map

package/lib/api/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../src/api/rate-limit.ts"],"names":[],"mappings":"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","sourcesContent":["import { newError, scopeError, tokenBucket } from '@yuants/utils';\n\ntype HttpMethod = 'GET' | 'POST';\n\ntype RestRequestContext = Readonly<{\n  method: HttpMethod;\n  path: string;\n  body?: unknown;\n  kind: 'info' | 'exchange' | 'explorer' | 'other';\n  infoType?: string;\n  exchangeActionType?: string;\n  exchangeBatchLength?: number;\n}>;\n\ntype ExtraWeigher = Readonly<{\n  match: (ctx: RestRequestContext) => boolean;\n  divisor: 20 | 60;\n  estimateItems?: (ctx: RestRequestContext) => number;\n  countItemsFromResponse?: (response: unknown) => number;\n}>;\n\nconst REST_IP_BUCKET_ID = 'HYPERLIQUID_REST_IP_WEIGHT_1200_PER_MIN';\nconst REST_IP_BUCKET_CAPACITY = 1200;\nconst REST_IP_WEIGHT_MAX = REST_IP_BUCKET_CAPACITY * 10;\n\ntokenBucket(REST_IP_BUCKET_ID, {\n  capacity: REST_IP_BUCKET_CAPACITY,\n  refillInterval: 60_000,\n  refillAmount: 1200,\n});\n\nconst INFO_TYPE_TO_BASE_WEIGHT: Readonly<Record<string, number>> = {\n  l2Book: 2,\n  allMids: 2,\n  clearinghouseState: 2,\n  orderStatus: 2,\n  spotClearinghouseState: 2,\n  exchangeStatus: 2,\n  userRole: 60,\n};\n\nconst INTERVAL_TO_MS: Readonly<Record<string, number>> = {\n  '1m': 60_000,\n  '3m': 180_000,\n  '5m': 300_000,\n  '15m': 900_000,\n  '30m': 1_800_000,\n  '1h': 3_600_000,\n  '2h': 7_200_000,\n  '4h': 14_400_000,\n  '8h': 28_800_000,\n  '12h': 43_200_000,\n  '1d': 86_400_000,\n  '3d': 259_200_000,\n  '1w': 604_800_000,\n  '1M': 2_592_000_000,\n};\n\nconst getObject = (value: unknown): Record<string, unknown> | undefined => {\n  if (typeof value !== 'object' || value === null) return;\n  return value as Record<string, unknown>;\n};\n\nconst getString = (value: unknown): string | undefined => {\n  if (typeof value !== 'string') return;\n  return value;\n};\n\nconst getNumber = (value: unknown): number | undefined => {\n  if (typeof value !== 'number' || !Number.isFinite(value)) return;\n  return value;\n};\n\nconst getArray = (value: unknown): unknown[] | undefined => {\n  if (!Array.isArray(value)) return;\n  return value;\n};\n\nexport const getRestRequestContext = (\n  method: HttpMethod,\n  path: string,\n  body?: unknown,\n): RestRequestContext => {\n  if (method === 'POST' && path === 'info') {\n    const obj = getObject(body);\n    const infoType = getString(obj?.type);\n    return { method, path, body, kind: 'info', infoType };\n  }\n  if (method === 'POST' && path === 'exchange') {\n    const obj = getObject(body);\n    const action = getObject(obj?.action);\n    const exchangeActionType = getString(action?.type);\n    const orders = getArray(action?.orders);\n    const cancels = getArray(action?.cancels);\n    const exchangeBatchLength = Math.max(1, orders?.length ?? cancels?.length ?? 1);\n    return { method, path, body, kind: 'exchange', exchangeActionType, exchangeBatchLength };\n  }\n  if (path.startsWith('explorer')) {\n    return { method, path, body, kind: 'explorer' };\n  }\n  return { method, path, body, kind: 'other' };\n};\n\nexport const getRestBaseWeight = (ctx: RestRequestContext): number => {\n  if (ctx.kind === 'exchange') {\n    const batchLength = Math.max(1, ctx.exchangeBatchLength ?? 1);\n    return 1 + Math.floor(batchLength / 40);\n  }\n  if (ctx.kind === 'info') {\n    return INFO_TYPE_TO_BASE_WEIGHT[ctx.infoType ?? ''] ?? 20;\n  }\n  if (ctx.kind === 'explorer') {\n    return 40;\n  }\n  return 20;\n};\n\nconst estimateCandleSnapshotItems = (ctx: RestRequestContext): number => {\n  if (ctx.kind !== 'info' || ctx.infoType !== 'candleSnapshot') return 0;\n  const bodyObj = getObject(ctx.body);\n  const reqObj = getObject(bodyObj?.req);\n  const interval = getString(reqObj?.interval);\n  const startTime = getNumber(reqObj?.startTime);\n  const endTime = getNumber(reqObj?.endTime);\n  if (!interval || startTime === undefined || endTime === undefined || endTime <= startTime) return 0;\n\n  const intervalMs = INTERVAL_TO_MS[interval] ?? 0;\n  if (!intervalMs) return 0;\n\n  // Hyperliquid docs: Only the most recent 5000 candles are available\n  const estimated = Math.ceil((endTime - startTime) / intervalMs);\n  return Math.min(5000, Math.max(0, estimated));\n};\n\nconst countArrayResponseItems = (response: unknown): number => {\n  const arr = getArray(response);\n  return arr?.length ?? 0;\n};\n\nconst countUserFillsItems = (response: unknown): number => {\n  const obj = getObject(response);\n  const fills = getArray(obj?.fills);\n  return fills?.length ?? 0;\n};\n\nconst extraWeighers: ReadonlyArray<ExtraWeigher> = [\n  {\n    match: (ctx) => ctx.kind === 'info' && ctx.infoType === 'candleSnapshot',\n    divisor: 60,\n    estimateItems: estimateCandleSnapshotItems,\n    countItemsFromResponse: countArrayResponseItems,\n  },\n  {\n    match: (ctx) =>\n      ctx.kind === 'info' &&\n      (ctx.infoType === 'recentTrades' ||\n        ctx.infoType === 'historicalOrders' ||\n        ctx.infoType === 'userFills' ||\n        ctx.infoType === 'userFillsByTime' ||\n        ctx.infoType === 'fundingHistory' ||\n        ctx.infoType === 'userFunding' ||\n        ctx.infoType === 'nonUserFundingUpdates' ||\n        ctx.infoType === 'twapHistory' ||\n        ctx.infoType === 'userTwapSliceFills' ||\n        ctx.infoType === 'userTwapSliceFillsByTime' ||\n        ctx.infoType === 'delegatorHistory' ||\n        ctx.infoType === 'delegatorRewards' ||\n        ctx.infoType === 'validatorStats'),\n    divisor: 20,\n    countItemsFromResponse: (response) => countUserFillsItems(response) || countArrayResponseItems(response),\n  },\n];\n\nexport const getRestEstimatedExtraWeight = (ctx: RestRequestContext): number => {\n  for (const weigher of extraWeighers) {\n    if (!weigher.match(ctx)) continue;\n    const items = weigher.estimateItems?.(ctx) ?? 0;\n    if (items <= 0) return 0;\n    return Math.ceil(items / weigher.divisor);\n  }\n  return 0;\n};\n\nconst normalizeRestWeight = (meta: Record<string, unknown>, weight: number): number => {\n  if (!Number.isFinite(weight)) {\n    throw newError('HYPERLIQUID_REST_WEIGHT_INVALID', { ...meta, weight });\n  }\n  const normalized = Math.floor(weight);\n  if (normalized <= 0) {\n    throw newError('HYPERLIQUID_REST_WEIGHT_INVALID', { ...meta, weight: normalized });\n  }\n  if (normalized > REST_IP_WEIGHT_MAX) {\n    throw newError('HYPERLIQUID_REST_WEIGHT_EXCESSIVE', {\n      ...meta,\n      weight: normalized,\n      maxWeight: REST_IP_WEIGHT_MAX,\n    });\n  }\n  return normalized;\n};\n\nexport const acquireRestIpWeightSync = (meta: Record<string, unknown>, weight: number) => {\n  const normalized = normalizeRestWeight(meta, weight);\n  scopeError('HYPERLIQUID_API_RATE_LIMIT', { ...meta, bucketId: REST_IP_BUCKET_ID, weight: normalized }, () =>\n    tokenBucket(REST_IP_BUCKET_ID).acquireSync(normalized),\n  );\n};\n\nconst acquireRestIpWeight = async (meta: Record<string, unknown>, weight: number) => {\n  let remaining = normalizeRestWeight(meta, weight);\n  while (remaining > 0) {\n    const chunk = Math.min(REST_IP_BUCKET_CAPACITY, remaining);\n    await scopeError(\n      'HYPERLIQUID_API_RATE_LIMIT',\n      { ...meta, bucketId: REST_IP_BUCKET_ID, weight: chunk, remaining },\n      () => tokenBucket(REST_IP_BUCKET_ID).acquire(chunk),\n    );\n    remaining -= chunk;\n  }\n};\n\nexport const beforeRestRequest = (\n  meta: Record<string, unknown>,\n  ctx: RestRequestContext,\n): Readonly<{ baseWeight: number; estimatedExtraWeight: number }> => {\n  const baseWeight = getRestBaseWeight(ctx);\n  const estimatedExtraWeight = getRestEstimatedExtraWeight(ctx);\n  acquireRestIpWeightSync(meta, baseWeight + estimatedExtraWeight);\n  return { baseWeight, estimatedExtraWeight };\n};\n\nexport const afterRestResponse = async (\n  meta: Record<string, unknown>,\n  ctx: RestRequestContext,\n  response: unknown,\n  estimatedExtraWeight: number,\n) => {\n  for (const weigher of extraWeighers) {\n    if (!weigher.match(ctx)) continue;\n    const items = weigher.countItemsFromResponse?.(response) ?? 0;\n    if (items <= 0) return;\n    const actualExtraWeight = Math.ceil(items / weigher.divisor);\n    const delta = actualExtraWeight - estimatedExtraWeight;\n    if (delta > 0) {\n      // 不使用 acquireSync：响应后只阻塞等待，不报错\n      await acquireRestIpWeight(meta, delta);\n    }\n    return;\n  }\n};\n"]}

package/lib/api/rate-limit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rate-limit.test.d.ts.map

package/lib/api/rate-limit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.test.d.ts","sourceRoot":"","sources":["../../src/api/rate-limit.test.ts"],"names":[],"mappings":""}