@pear-protocol/exchanges-sdk 0.15.0 → 0.16.0

package/dist/client/hyperliquid/rest.js

@@ -86,6 +86,19 @@ async function fetchUserVaultEquities(user, demo = false) {
   }, demo);
 }
 __name(fetchUserVaultEquities, "fetchUserVaultEquities");
+async function fetchBorrowLendUserState(user, demo = false) {
+  return fetchInfo({
+    type: "borrowLendUserState",
+    user
+  }, demo);
+}
+__name(fetchBorrowLendUserState, "fetchBorrowLendUserState");
+async function fetchAllBorrowLendReserveStates(demo = false) {
+  return fetchInfo({
+    type: "allBorrowLendReserveStates"
+  }, demo);
+}
+__name(fetchAllBorrowLendReserveStates, "fetchAllBorrowLendReserveStates");
 async function fetchActiveAssetData(user, coin, demo = false) {
   return fetchInfo({
     type: "activeAssetData",
@@ -95,4 +108,4 @@ async function fetchActiveAssetData(user, coin, demo = false) {
 }
 __name(fetchActiveAssetData, "fetchActiveAssetData");
 
-export { HyperliquidInfoRequestError, fetchActiveAssetData, fetchAllMids, fetchClearinghouseState, fetchDelegatorSummary, fetchInfo, fetchPerpDexs, fetchSpotClearinghouseState, fetchUserAbstraction, fetchUserRole, fetchUserVaultEquities };
+export { HyperliquidInfoRequestError, fetchActiveAssetData, fetchAllBorrowLendReserveStates, fetchAllMids, fetchBorrowLendUserState, fetchClearinghouseState, fetchDelegatorSummary, fetchInfo, fetchPerpDexs, fetchSpotClearinghouseState, fetchUserAbstraction, fetchUserRole, fetchUserVaultEquities };

package/dist/index.d.ts

@@ -1447,6 +1447,7 @@ declare const AccountBalance: z.ZodDiscriminatedUnion<[z.ZodObject<{
         withdrawable: z.ZodString;
         ltv: z.ZodNullable<z.ZodString>;
         borrowCapUsed: z.ZodNullable<z.ZodString>;
+        borrowed: z.ZodString;
     }, z.core.$strip>>;
     tradingEquity: z.ZodNullable<z.ZodString>;
     vaultEquity: z.ZodString;
@@ -1458,6 +1459,13 @@ declare const AccountBalance: z.ZodDiscriminatedUnion<[z.ZodObject<{
     portfolioMarginRatio: z.ZodNullable<z.ZodString>;
     portfolioAccountLeverage: z.ZodNullable<z.ZodString>;
     borrowCapUsed: z.ZodNullable<z.ZodString>;
+    borrowedValue: z.ZodNullable<z.ZodString>;
+    healthFactor: z.ZodNullable<z.ZodString>;
+    borrowLendReserves: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        borrowYearlyRate: z.ZodString;
+        supplyYearlyRate: z.ZodString;
+    }, z.core.$strip>>;
     perDexState: z.ZodArray<z.ZodObject<{
         dex: z.ZodString;
         collateralToken: z.ZodNullable<z.ZodNumber>;
@@ -2174,8 +2182,9 @@ type HyperliquidUnifiedBalance = z.infer<typeof HyperliquidUnifiedBalance>;
  *   accounts measured hold one — `0x0871deb3…` reports USDC at −957,802.15. An unsigned row cannot
  *   state that at all, which is the defect that made a borrowed pool indistinguishable from an
  *   untouched one.
- * - **two more columns.** `ltv` and `borrowCapUsed` are per-coin risk weights the venue renders
- *   beside the quantities, and both are PM-only wire fields.
+ * - **three more columns.** `ltv` and `borrowCapUsed` are per-coin risk weights the venue renders
+ *   beside the quantities, and both are PM-only wire fields. `borrowed`, the coin's outstanding
+ *   debt, is the third, and PM-only as well.
  *
  * The row is otherwise the shared shape: same keys, same meanings, so a consumer reading
  * `perCollateral` without narrowing still reads `asset` / `equity` / `availableMargin` /
@@ -2188,8 +2197,16 @@ declare const HyperliquidPortfolioMarginCollateral: z.ZodObject<{
     withdrawable: z.ZodString;
     ltv: z.ZodNullable<z.ZodString>;
     borrowCapUsed: z.ZodNullable<z.ZodString>;
+    borrowed: z.ZodString;
 }, z.core.$strip>;
 type HyperliquidPortfolioMarginCollateral = z.infer<typeof HyperliquidPortfolioMarginCollateral>;
+/** One borrow/lend reserve's yearly rates, named by its coin's wire name. */
+declare const HyperliquidBorrowLendReserve: z.ZodObject<{
+    asset: z.ZodString;
+    borrowYearlyRate: z.ZodString;
+    supplyYearlyRate: z.ZodString;
+}, z.core.$strip>;
+type HyperliquidBorrowLendReserve = z.infer<typeof HyperliquidBorrowLendReserve>;
 declare const HyperliquidPortfolioMarginBalance: z.ZodObject<{
     totalEquity: z.ZodNullable<z.ZodString>;
     withdrawableBalance: z.ZodNullable<z.ZodString>;
@@ -2204,6 +2221,7 @@ declare const HyperliquidPortfolioMarginBalance: z.ZodObject<{
         withdrawable: z.ZodString;
         ltv: z.ZodNullable<z.ZodString>;
         borrowCapUsed: z.ZodNullable<z.ZodString>;
+        borrowed: z.ZodString;
     }, z.core.$strip>>;
     tradingEquity: z.ZodNullable<z.ZodString>;
     vaultEquity: z.ZodString;
@@ -2215,6 +2233,13 @@ declare const HyperliquidPortfolioMarginBalance: z.ZodObject<{
     portfolioMarginRatio: z.ZodNullable<z.ZodString>;
     portfolioAccountLeverage: z.ZodNullable<z.ZodString>;
     borrowCapUsed: z.ZodNullable<z.ZodString>;
+    borrowedValue: z.ZodNullable<z.ZodString>;
+    healthFactor: z.ZodNullable<z.ZodString>;
+    borrowLendReserves: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        borrowYearlyRate: z.ZodString;
+        supplyYearlyRate: z.ZodString;
+    }, z.core.$strip>>;
     perDexState: z.ZodArray<z.ZodObject<{
         dex: z.ZodString;
         collateralToken: z.ZodNullable<z.ZodNumber>;
@@ -2232,9 +2257,10 @@ type HyperliquidPortfolioMarginBalance = z.infer<typeof HyperliquidPortfolioMarg
  * Both fill the same `HyperliquidBalanceContext` and hand it to the same mapper, which is what
  * makes "same account state, same balance" true across two different transports. The tracker takes
  * every CHANGING value off a channel — `allDexsClearinghouseState`, `spotState`, `webData3`,
- * `allMids`, `activeAssetData` — including vault equity, which rides `webData3`. Its only REST
- * reads happen at `start()`: the static dex metadata, and the staking position, which the venue
- * publishes on no channel at all.
+ * `allMids`, `activeAssetData` — including vault equity, which rides `webData3`, save one:
+ * Portfolio Margin's health factor and reserve rates ride no channel, so it polls them while the
+ * account is in that mode. Its only other REST reads happen at `start()`: the static dex metadata,
+ * and the staking position, which the venue publishes on no channel at all.
  *
  * The snapshot has no channels, so it reads the same figures over REST — vault equity from
  * `userVaultEquities`, which was measured equal to the `webData3` figure on ten live accounts.
@@ -2256,6 +2282,11 @@ declare class HyperliquidAccountTracker extends BaseAccountTracker {
     /** Portfolio Margin's own risk scalars, which ride the same `spotState` frame the balances do. */
     private portfolioMarginRatio;
     private borrowRatioByToken;
+    /** Portfolio Margin's REST-only figures, and the timer that keeps them fresh while in that mode. */
+    private borrowLend;
+    private borrowLendPollTimer;
+    /** Advances on every stop, so a read fired in an earlier poll period is recognised and dropped. */
+    private borrowLendPollGeneration;
     private hasSpotState;
     private hasClearinghouseState;
     private accountType;
@@ -2314,6 +2345,27 @@ declare class HyperliquidAccountTracker extends BaseAccountTracker {
      * vault. Partial equity is worse than no equity, so nothing is published early.
      */
     private buildBalance;
+    /**
+     * Runs the borrow/lend poll exactly while the account is in Portfolio Margin.
+     *
+     * Safe to call on every mode read: a poll already in the state the mode asks for is left alone,
+     * so a steady stream of `webData3` frames neither restarts the timer nor refires a read.
+     */
+    private syncBorrowLendPoll;
+    /**
+     * Stops the borrow/lend poll and drops its figures, so no later mode or session inherits them.
+     *
+     * Every stop opens a new generation — a session ending, a restart, or the account leaving
+     * Portfolio Margin — so a read still in flight from the period just ended can never land.
+     */
+    private stopBorrowLendPoll;
+    /**
+     * Reads the health factor and reserve rates once, then republishes the balance with them.
+     *
+     * A failed read is reported and left for the next tick: the previous figures stay in place, since
+     * one missed read says nothing about the account that the last good one did not.
+     */
+    private refreshBorrowLendState;
     /** The floor of `availableToTrade` over the tracked set; `null` when nothing is tracked. */
     private availableMargin;
     /** Clears both sides of the live balance join and the public account cache without emitting. */
@@ -2778,4 +2830,4 @@ declare class ExchangesSDK {
     private fetchCredentials;
 }
 
-export { ACCOUNT_MODE_LABELS, ASSET_DECIMALS, AccountBalance, AccountBalanceCore, type AccountHealthStatus, AccountMode, type AccountPosition, type AccountSnapshot, type AccountStatus, type AccountSyncer, type AccountSyncerConfig, type AccountTierCallback, type AccountTracker, type AccountTrackerConfig, type AccountWarningReason, type ApiKey, type ApproveIntegratorParams, type ApproveIntegratorResult, AssetId, type AssetSnapshotMap, type BalanceCallback, BaseAccountSyncer, BaseAccountTracker, BaseWs, BinanceAccountSyncer, BinanceAccountTracker, type BinanceAccountTrackerConfig, BinanceExchangeWs, BinanceMultiAssetBalance, BinanceSingleAssetBalance, BinanceUserDataWs, type BinanceUserDataWsConfig, BinanceWsApi, type BinanceWsApiConfig, BybitAccountSyncer, BybitAccountTracker, type BybitAccountTrackerConfig, BybitExchangeWs, BybitIsolatedMarginBalance, BybitPortfolioMarginBalance, BybitRegularMarginBalance, BybitWs, type BybitWsConfig, type CctpDepositAddressParams, type CctpDepositAddressResult, type CctpDepositHistorySettlement, type CctpDepositParams, type CctpDepositRegistrationSettlement, type CctpDepositResult, type CctpDepositSettlement, type ChangeAccountTierParams, type ChangeAccountTierResult, type CheckApiWalletParams, CollateralBalance, type ConnectOptions, type ConnectWalletParams, type ConnectWalletResult, type CreateAccountTrackerConfig, type CreateExchangeWsConfig, DecimalString, type EthereumDepositParams, type EthereumDepositResult, type ExchangeConnection, type ExchangeHelperExchange, type ExchangeHelperMap, type ExchangeState, ExchangeWs, type ExchangeWsByConnector, ExchangesSDK, type ExchangesSDKConfig, FUNXYZ_DEPOSIT_MINIMUMS_USD, FUNXYZ_ETHEREUM_MAINNET_CHAIN_ID, FUNXYZ_EVM_CHAIN_NAMES, type FastWithdrawParams, type FastWithdrawResult, type FillSyncOutcome, type FundingSyncOutcome, type FunxyzAccountState, type FunxyzAsset, type FunxyzDepositAddressParams, type FunxyzDepositAddressResult, type FunxyzDepositCredit, type FunxyzDepositParams, type FunxyzDepositResult, type FunxyzDepositSettlement, type FunxyzDepositSource, type FunxyzMarket, HyperliquidAccountSyncer, HyperliquidAccountTracker, type HyperliquidAccountTrackerConfig, HyperliquidDexState, HyperliquidExchangeWs, type HyperliquidHelper, HyperliquidPortfolioMarginBalance, HyperliquidPortfolioMarginCollateral, HyperliquidStandardBalance, HyperliquidUnifiedBalance, HyperliquidWs, type IntegratorApprovalRequirements, L2_ASSET_DECIMALS, LIGHTER_NATIVE_USDC_ADDRESSES, LIGHTER_QUOTE_ASSETS, LIGHTER_RHC_CHAIN_ID, LIGHTER_RHC_USDG_ADDRESS, LIGHTER_RHC_USDG_DECIMALS, LIGHTER_USDC_DECIMALS, LighterAccountSyncer, type LighterAccountSyncerConfig, type LighterAccountTier, LighterAccountTracker, type LighterAccountTrackerConfig, type LighterApplyReferralCodeParams, type LighterAuthCredentials, LighterClassicBalance, type LighterConnector, type LighterDeposit, type LighterDepositAddressParams, type LighterDepositAddressResult, type LighterDepositCredit, type LighterDepositHistoryParams, type LighterDepositNetwork, type LighterDepositPage, type LighterDepositParams, type LighterDepositProgress, type LighterDepositResult, type LighterDepositStatus, type LighterDepositWalletAdapter, LighterExchangeWs, type LighterHelper, type LighterLookupResult, type LighterOnboardingStatus, type LighterReferral, type LighterReferralTotals, type LighterReferralTradeStats, LighterRhcAssetId, type LighterRhcDepositAddressParams, type LighterRhcDepositAddressResult, type LighterRhcDepositParams, type LighterRhcDepositResult, type LighterRhcDepositWallet, type LighterRhcHelper, type LighterSharedHelper, LighterUnifiedBalance, type LighterUserReferrals, type LighterUserReferralsParams, type LighterWithdraw, type LighterWithdrawHistoryParams, type LighterWithdrawPage, type LighterWithdrawStatus, type LighterWithdrawType, LighterWs, type ListExternalFillsParams, type ListExternalFundingParams, type ListExternalPositionsParams, MAX_API_KEY_INDEX, MIN_LIGHTER_CCTP_DEPOSIT_USDC, MIN_LIGHTER_FAST_WITHDRAW_COLLATERAL, MIN_LIGHTER_RHC_DEPOSIT_USDG, MIN_USER_API_KEY_INDEX, MarginMode, type MessageListener, OkxAccountSyncer, OkxAccountTracker, type OkxAccountTrackerConfig, OkxExchangeWs, OkxFuturesBalance, OkxMultiCurrencyMarginBalance, OkxPortfolioMarginBalance, OkxSpotBalance, OkxWs, type OkxWsConfig, type OpenListener, type PositionsCallback, RouteType, Side, SignedDecimalString, type StateUpdate, type SupportedCredentials, type SyncerThrottle, type TrackedAssetCallback, type TrackedAssetInfo, type WalletClientWithAccount, type WithdrawParams, type WithdrawResult, type WsMessage, createAccountSyncer, createAccountTracker, createExchangeWs, createHyperliquidHelper, createLighterHelper, createLighterRhcHelper, findAvailableApiKeyIndex, getAssetDecimals, getLighterNativeUsdcAddress, listFunxyzTransferableChains, readFunxyzChainSource, readFunxyzMinimumUsd, retrieveLighterAuthToken, usdcAbi };
+export { ACCOUNT_MODE_LABELS, ASSET_DECIMALS, AccountBalance, AccountBalanceCore, type AccountHealthStatus, AccountMode, type AccountPosition, type AccountSnapshot, type AccountStatus, type AccountSyncer, type AccountSyncerConfig, type AccountTierCallback, type AccountTracker, type AccountTrackerConfig, type AccountWarningReason, type ApiKey, type ApproveIntegratorParams, type ApproveIntegratorResult, AssetId, type AssetSnapshotMap, type BalanceCallback, BaseAccountSyncer, BaseAccountTracker, BaseWs, BinanceAccountSyncer, BinanceAccountTracker, type BinanceAccountTrackerConfig, BinanceExchangeWs, BinanceMultiAssetBalance, BinanceSingleAssetBalance, BinanceUserDataWs, type BinanceUserDataWsConfig, BinanceWsApi, type BinanceWsApiConfig, BybitAccountSyncer, BybitAccountTracker, type BybitAccountTrackerConfig, BybitExchangeWs, BybitIsolatedMarginBalance, BybitPortfolioMarginBalance, BybitRegularMarginBalance, BybitWs, type BybitWsConfig, type CctpDepositAddressParams, type CctpDepositAddressResult, type CctpDepositHistorySettlement, type CctpDepositParams, type CctpDepositRegistrationSettlement, type CctpDepositResult, type CctpDepositSettlement, type ChangeAccountTierParams, type ChangeAccountTierResult, type CheckApiWalletParams, CollateralBalance, type ConnectOptions, type ConnectWalletParams, type ConnectWalletResult, type CreateAccountTrackerConfig, type CreateExchangeWsConfig, DecimalString, type EthereumDepositParams, type EthereumDepositResult, type ExchangeConnection, type ExchangeHelperExchange, type ExchangeHelperMap, type ExchangeState, ExchangeWs, type ExchangeWsByConnector, ExchangesSDK, type ExchangesSDKConfig, FUNXYZ_DEPOSIT_MINIMUMS_USD, FUNXYZ_ETHEREUM_MAINNET_CHAIN_ID, FUNXYZ_EVM_CHAIN_NAMES, type FastWithdrawParams, type FastWithdrawResult, type FillSyncOutcome, type FundingSyncOutcome, type FunxyzAccountState, type FunxyzAsset, type FunxyzDepositAddressParams, type FunxyzDepositAddressResult, type FunxyzDepositCredit, type FunxyzDepositParams, type FunxyzDepositResult, type FunxyzDepositSettlement, type FunxyzDepositSource, type FunxyzMarket, HyperliquidAccountSyncer, HyperliquidAccountTracker, type HyperliquidAccountTrackerConfig, HyperliquidBorrowLendReserve, HyperliquidDexState, HyperliquidExchangeWs, type HyperliquidHelper, HyperliquidPortfolioMarginBalance, HyperliquidPortfolioMarginCollateral, HyperliquidStandardBalance, HyperliquidUnifiedBalance, HyperliquidWs, type IntegratorApprovalRequirements, L2_ASSET_DECIMALS, LIGHTER_NATIVE_USDC_ADDRESSES, LIGHTER_QUOTE_ASSETS, LIGHTER_RHC_CHAIN_ID, LIGHTER_RHC_USDG_ADDRESS, LIGHTER_RHC_USDG_DECIMALS, LIGHTER_USDC_DECIMALS, LighterAccountSyncer, type LighterAccountSyncerConfig, type LighterAccountTier, LighterAccountTracker, type LighterAccountTrackerConfig, type LighterApplyReferralCodeParams, type LighterAuthCredentials, LighterClassicBalance, type LighterConnector, type LighterDeposit, type LighterDepositAddressParams, type LighterDepositAddressResult, type LighterDepositCredit, type LighterDepositHistoryParams, type LighterDepositNetwork, type LighterDepositPage, type LighterDepositParams, type LighterDepositProgress, type LighterDepositResult, type LighterDepositStatus, type LighterDepositWalletAdapter, LighterExchangeWs, type LighterHelper, type LighterLookupResult, type LighterOnboardingStatus, type LighterReferral, type LighterReferralTotals, type LighterReferralTradeStats, LighterRhcAssetId, type LighterRhcDepositAddressParams, type LighterRhcDepositAddressResult, type LighterRhcDepositParams, type LighterRhcDepositResult, type LighterRhcDepositWallet, type LighterRhcHelper, type LighterSharedHelper, LighterUnifiedBalance, type LighterUserReferrals, type LighterUserReferralsParams, type LighterWithdraw, type LighterWithdrawHistoryParams, type LighterWithdrawPage, type LighterWithdrawStatus, type LighterWithdrawType, LighterWs, type ListExternalFillsParams, type ListExternalFundingParams, type ListExternalPositionsParams, MAX_API_KEY_INDEX, MIN_LIGHTER_CCTP_DEPOSIT_USDC, MIN_LIGHTER_FAST_WITHDRAW_COLLATERAL, MIN_LIGHTER_RHC_DEPOSIT_USDG, MIN_USER_API_KEY_INDEX, MarginMode, type MessageListener, OkxAccountSyncer, OkxAccountTracker, type OkxAccountTrackerConfig, OkxExchangeWs, OkxFuturesBalance, OkxMultiCurrencyMarginBalance, OkxPortfolioMarginBalance, OkxSpotBalance, OkxWs, type OkxWsConfig, type OpenListener, type PositionsCallback, RouteType, Side, SignedDecimalString, type StateUpdate, type SupportedCredentials, type SyncerThrottle, type TrackedAssetCallback, type TrackedAssetInfo, type WalletClientWithAccount, type WithdrawParams, type WithdrawResult, type WsMessage, createAccountSyncer, createAccountTracker, createExchangeWs, createHyperliquidHelper, createLighterHelper, createLighterRhcHelper, findAvailableApiKeyIndex, getAssetDecimals, getLighterNativeUsdcAddress, listFunxyzTransferableChains, readFunxyzChainSource, readFunxyzMinimumUsd, retrieveLighterAuthToken, usdcAbi };

package/dist/tracker/hyperliquid/balance.js

@@ -146,7 +146,22 @@ const HyperliquidPortfolioMarginCollateral = z.object({
   * `borrowed / borrow cap` for this coin, and `null` where the venue renders `--` — no borrow.
   * NOT clipped at one: `0x0871deb3…` reports 1.0081 on USDT0.
   */
-  borrowCapUsed: DecimalString.nullable()
+  borrowCapUsed: DecimalString.nullable(),
+  /**
+  * The coin's outstanding borrow in its own units, and `0` on a coin never borrowed.
+  *
+  * Read from the wire's `borrowed`, never from a negative `equity`: the USDC row already contains
+  * the perps account value, so `equity` is `supplied − borrowed + accountValue` and its negative
+  * understates the debt by exactly that wallet.
+  */
+  borrowed: DecimalString
+});
+const HyperliquidBorrowLendReserve = z.object({
+  asset: z.string(),
+  /** What borrowing the coin costs per year, as a fraction — `0.05` is 5% APY. */
+  borrowYearlyRate: DecimalString,
+  /** What supplying the coin earns per year; Portfolio Margin supplies idle balances automatically. */
+  supplyYearlyRate: DecimalString
 });
 const HyperliquidPortfolioMarginBalance = AccountBalanceCore.extend({
   accountMode: z.literal("hyperliquid:portfolioMargin"),
@@ -194,7 +209,27 @@ const HyperliquidPortfolioMarginBalance = AccountBalanceCore.extend({
   * account borrows nothing. Not clipped at one, and never the USDC entry alone.
   */
   borrowCapUsed: DecimalString.nullable(),
+  /**
+  * The venue's Your Borrowed: every row's `borrowed` valued at its own mid, in USD, and `0` when
+  * the account borrows nothing. Null when a borrowed coin cannot be priced, since a debt counted
+  * as zero would hide exactly the part nobody could value.
+  */
+  borrowedValue: DecimalString.nullable(),
+  /**
+  * The venue's Health Factor — LTV-weighted collateral over the borrowed value — at four decimals.
+  * Below `1` the account can borrow no more, which is not by itself liquidation: that is
+  * `portfolioMarginRatio`. Null when the account borrows nothing, and until the first read lands.
+  *
+  * Read, never derived, and over REST because no channel carries it: the live tracker refreshes it
+  * on a timer, so it can trail the channel-fed figures beside it by up to one poll interval.
+  */
+  healthFactor: DecimalString.nullable(),
+  /**
+  * Every reserve's yearly rates, listed whatever the account holds, so what a borrow will cost
+  * shows before the first one happens. Empty until the first read lands.
+  */
+  borrowLendReserves: z.array(HyperliquidBorrowLendReserve),
   perDexState: z.array(HyperliquidDexState)
 });
 
-export { HyperliquidDexState, HyperliquidPortfolioMarginBalance, HyperliquidPortfolioMarginCollateral, HyperliquidStandardBalance, HyperliquidUnifiedBalance };
+export { HyperliquidBorrowLendReserve, HyperliquidDexState, HyperliquidPortfolioMarginBalance, HyperliquidPortfolioMarginCollateral, HyperliquidStandardBalance, HyperliquidUnifiedBalance };

package/dist/tracker/hyperliquid/borrow-lend.js

@@ -0,0 +1,32 @@
+import { fetchBorrowLendUserState, fetchAllBorrowLendReserveStates } from '../../client/hyperliquid/rest';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const EMPTY_BORROW_LEND_STATE = {
+  healthFactor: null,
+  ratesByToken: /* @__PURE__ */ new Map()
+};
+async function fetchBorrowLendState(user, demo) {
+  const [userState, reserves] = await Promise.all([
+    fetchBorrowLendUserState(user, demo),
+    fetchAllBorrowLendReserveStates(demo)
+  ]);
+  return {
+    healthFactor: userState.healthFactor ?? null,
+    ratesByToken: ratesByToken(reserves)
+  };
+}
+__name(fetchBorrowLendState, "fetchBorrowLendState");
+function ratesByToken(reserves) {
+  const rates = /* @__PURE__ */ new Map();
+  for (const [token, reserve] of reserves) {
+    rates.set(token, {
+      borrowYearlyRate: reserve.borrowYearlyRate,
+      supplyYearlyRate: reserve.supplyYearlyRate
+    });
+  }
+  return rates;
+}
+__name(ratesByToken, "ratesByToken");
+
+export { EMPTY_BORROW_LEND_STATE, fetchBorrowLendState };

package/dist/tracker/hyperliquid/mapper.js

@@ -232,6 +232,9 @@ function mapPortfolioMarginBalance(context) {
     portfolioMarginRatio: wireMarginRatio(context),
     portfolioAccountLeverage: portfolioAccountLeverage(context),
     borrowCapUsed: worstBorrowCapUsed(context),
+    borrowedValue: borrowedValueOf(context),
+    healthFactor: wireHealthFactor(context),
+    borrowLendReserves: borrowLendReserveRows(context),
     perDexState: context.summary.perDexState,
     timestamp: context.timestamp
   };
@@ -256,7 +259,8 @@ function portfolioMarginCollateralRows(context) {
       availableMargin: context.availableMarginByToken.get(balance.token) ?? null,
       withdrawable: signed(total.minus(toDecimal(balance.hold)).toFixed()),
       ltv: balance.ltv === null ? null : toDecimal(balance.ltv).toFixed(),
-      borrowCapUsed: borrowCapUsedFor(context, balance.token)
+      borrowCapUsed: borrowCapUsedFor(context, balance.token),
+      borrowed: toDecimal(balance.borrowed).toFixed()
     });
   }
   rows.sort(byRowAsset);
@@ -283,6 +287,22 @@ function worstBorrowCapUsed(context) {
   return worst.isZero() ? null : worst.toFixed(RATIO_DECIMALS);
 }
 __name(worstBorrowCapUsed, "worstBorrowCapUsed");
+function borrowedValueOf(context) {
+  let borrowed = ZERO;
+  for (const balance of context.spotBalances.values()) {
+    const debt = toDecimal(balance.borrowed);
+    if (debt.isZero()) {
+      continue;
+    }
+    const mid = context.prices.midForToken(balance.token);
+    if (mid === null) {
+      return null;
+    }
+    borrowed = borrowed.plus(debt.times(toDecimal(mid)));
+  }
+  return borrowed.toFixed();
+}
+__name(borrowedValueOf, "borrowedValueOf");
 function wireMarginRatio(context) {
   if (context.portfolioMarginRatio === null) {
     return null;
@@ -290,6 +310,38 @@ function wireMarginRatio(context) {
   return toDecimal(context.portfolioMarginRatio).toFixed(RATIO_DECIMALS);
 }
 __name(wireMarginRatio, "wireMarginRatio");
+function wireHealthFactor(context) {
+  const healthFactor = context.borrowLend.healthFactor;
+  if (healthFactor === null) {
+    return null;
+  }
+  return toDecimal(healthFactor).toFixed(RATIO_DECIMALS);
+}
+__name(wireHealthFactor, "wireHealthFactor");
+function borrowLendReserveRows(context) {
+  const rows = [];
+  for (const [token, rates] of context.borrowLend.ratesByToken) {
+    const asset = context.collateralTokenNames.get(token);
+    if (asset === void 0) {
+      continue;
+    }
+    rows.push({
+      asset,
+      borrowYearlyRate: toDecimal(rates.borrowYearlyRate).toFixed(),
+      supplyYearlyRate: toDecimal(rates.supplyYearlyRate).toFixed()
+    });
+  }
+  rows.sort(byReserveAsset);
+  return rows;
+}
+__name(borrowLendReserveRows, "borrowLendReserveRows");
+function byReserveAsset(left, right) {
+  if (left.asset === right.asset) {
+    return 0;
+  }
+  return left.asset < right.asset ? -1 : 1;
+}
+__name(byReserveAsset, "byReserveAsset");
 function portfolioAccountLeverage(context) {
   const collateral = haircutCollateral(context);
   if (collateral === null) {

package/dist/tracker/hyperliquid/tracker.js

@@ -2,6 +2,7 @@ import { createExchangeWs } from '../../client';
 import { fetchPerpDexs, fetchInfo, fetchAllMids, fetchUserAbstraction, fetchSpotClearinghouseState, fetchDelegatorSummary, fetchUserVaultEquities, fetchClearinghouseState, fetchActiveAssetData } from '../../client/hyperliquid/rest';
 import { BaseAccountTracker } from '../base';
 import { resolveHyperliquidAccountType } from './account-mode';
+import { EMPTY_BORROW_LEND_STATE, fetchBorrowLendState } from './borrow-lend';
 import { buildAvailableMarginByToken, buildCollateralTokenNames, minimumAvailableToTrade } from './collateral';
 import { LOCKED_TRACKED_COINS } from './const';
 import { toDecimal, ZERO } from './decimal';
@@ -15,6 +16,7 @@ const EMPTY_SPOT_META = {
   tokens: [],
   universe: []
 };
+const BORROW_LEND_POLL_INTERVAL_MS = 3e4;
 class HyperliquidAccountTracker extends BaseAccountTracker {
   static {
     __name(this, "HyperliquidAccountTracker");
@@ -30,6 +32,11 @@ class HyperliquidAccountTracker extends BaseAccountTracker {
   /** Portfolio Margin's own risk scalars, which ride the same `spotState` frame the balances do. */
   portfolioMarginRatio = null;
   borrowRatioByToken = /* @__PURE__ */ new Map();
+  /** Portfolio Margin's REST-only figures, and the timer that keeps them fresh while in that mode. */
+  borrowLend = EMPTY_BORROW_LEND_STATE;
+  borrowLendPollTimer = null;
+  /** Advances on every stop, so a read fired in an earlier poll period is recognised and dropped. */
+  borrowLendPollGeneration = 0;
   hasSpotState = false;
   hasClearinghouseState = false;
   accountType = null;
@@ -74,8 +81,10 @@ class HyperliquidAccountTracker extends BaseAccountTracker {
     })));
     const assetData = await this.fetchActiveAssetEvents(this.coinsForAvailableMargin());
     const { summary, assetPositions } = aggregateClearinghouseStates(clearinghouseStates);
+    const accountType = resolveHyperliquidAccountType(abstraction);
+    const borrowLend = accountType === HyperliquidAccountType.PORTFOLIO_MARGIN ? await fetchBorrowLendState(user, this.demo) : EMPTY_BORROW_LEND_STATE;
     const balance = mapBalance({
-      accountType: resolveHyperliquidAccountType(abstraction),
+      accountType,
       summary,
       spotBalances: mapSpotBalances(spotState),
       prices: SpotPrices.from(spotMeta, mids),
@@ -86,6 +95,7 @@ class HyperliquidAccountTracker extends BaseAccountTracker {
       availableMarginByToken: buildAvailableMarginByToken(summary.perDexState, assetData.values()),
       portfolioMarginRatio: spotState.portfolioMarginRatio ?? null,
       borrowRatioByToken: mapBorrowRatios(spotState),
+      borrowLend,
       timestamp: Date.now()
     });
     const positions = Array.from(mapPositions(assetPositions).values());
@@ -116,6 +126,7 @@ class HyperliquidAccountTracker extends BaseAccountTracker {
     const lifecycleVersion = ++this.lifecycleVersion;
     const user = this.addrLower();
     this.destroyCurrentSocket();
+    this.stopBorrowLendPoll();
     this.subscribedCoins.clear();
     this.resetLiveAccountState();
     this.dexToMeta.clear();
@@ -148,6 +159,7 @@ class HyperliquidAccountTracker extends BaseAccountTracker {
     this.messageListenerId = this.ws.addMessageListener((raw) => this.routeRaw(raw));
     this.openListenerId = this.ws.addOpenListener(() => this.resubscribeAll());
     this.sendStaticSubs();
+    this.syncBorrowLendPoll();
     const coinsToTrack = /* @__PURE__ */ new Set([
       ...LOCKED_TRACKED_COINS,
       ...this.trackedCoins
@@ -159,6 +171,7 @@ class HyperliquidAccountTracker extends BaseAccountTracker {
   async cleanupConnections() {
     this.lifecycleVersion += 1;
     this.destroyCurrentSocket();
+    this.stopBorrowLendPoll();
     this.subscribedCoins.clear();
   }
   /** Detaches and destroys the active socket without changing the current lifecycle generation. */
@@ -422,6 +435,7 @@ class HyperliquidAccountTracker extends BaseAccountTracker {
       this.resetLiveAccountState();
     }
     this.accountType = nextAccountType;
+    this.syncBorrowLendPoll();
     this.vaultEquity = sumLiveVaultEquity(data.perpDexStates ?? []);
     this.hasWebData3 = true;
     if (!nextAccountType) {
@@ -475,9 +489,68 @@ class HyperliquidAccountTracker extends BaseAccountTracker {
       availableMarginByToken: buildAvailableMarginByToken(this.lastSummary.perDexState, this.trackedAssetData.values()),
       portfolioMarginRatio: this.portfolioMarginRatio,
       borrowRatioByToken: this.borrowRatioByToken,
+      borrowLend: this.borrowLend,
       timestamp: Date.now()
     });
   }
+  /**
+  * Runs the borrow/lend poll exactly while the account is in Portfolio Margin.
+  *
+  * Safe to call on every mode read: a poll already in the state the mode asks for is left alone,
+  * so a steady stream of `webData3` frames neither restarts the timer nor refires a read.
+  */
+  syncBorrowLendPoll() {
+    const wantsPoll = this.accountType === HyperliquidAccountType.PORTFOLIO_MARGIN;
+    if (wantsPoll === (this.borrowLendPollTimer !== null)) {
+      return;
+    }
+    if (!wantsPoll) {
+      this.stopBorrowLendPoll();
+      return;
+    }
+    void this.refreshBorrowLendState();
+    this.borrowLendPollTimer = setInterval(() => void this.refreshBorrowLendState(), BORROW_LEND_POLL_INTERVAL_MS);
+  }
+  /**
+  * Stops the borrow/lend poll and drops its figures, so no later mode or session inherits them.
+  *
+  * Every stop opens a new generation — a session ending, a restart, or the account leaving
+  * Portfolio Margin — so a read still in flight from the period just ended can never land.
+  */
+  stopBorrowLendPoll() {
+    if (this.borrowLendPollTimer !== null) {
+      clearInterval(this.borrowLendPollTimer);
+      this.borrowLendPollTimer = null;
+    }
+    this.borrowLendPollGeneration += 1;
+    this.borrowLend = EMPTY_BORROW_LEND_STATE;
+  }
+  /**
+  * Reads the health factor and reserve rates once, then republishes the balance with them.
+  *
+  * A failed read is reported and left for the next tick: the previous figures stay in place, since
+  * one missed read says nothing about the account that the last good one did not.
+  */
+  async refreshBorrowLendState() {
+    const generation = this.borrowLendPollGeneration;
+    let borrowLend;
+    try {
+      borrowLend = await fetchBorrowLendState(this.addrLower(), this.demo);
+    } catch (err) {
+      this.onError(err instanceof Error ? err : new Error(String(err)));
+      return;
+    }
+    if (generation !== this.borrowLendPollGeneration) {
+      return;
+    }
+    this.borrowLend = borrowLend;
+    const balance = this.buildBalance();
+    if (balance !== void 0) {
+      this.onStateUpdate({
+        balance
+      });
+    }
+  }
   /** The floor of `availableToTrade` over the tracked set; `null` when nothing is tracked. */
   availableMargin() {
     return minimumAvailableToTrade(this.trackedAssetData.values());
@@ -540,7 +613,9 @@ function mapSpotBalances(spotState) {
       hold: balance.hold,
       // An absent `ltv` means "not collateral", which weighs zero — never a zero weight, which is
       // a stablecoin at full value. The two states stay apart from the wire onward.
-      ltv: balance.ltv ?? null
+      ltv: balance.ltv ?? null,
+      // An absent `borrowed` means the coin was never borrowed; the key rides only a borrowed coin.
+      borrowed: balance.borrowed ?? null
     });
   }
   return balances;

package/dist/tracker/index.js

@@ -13,7 +13,7 @@ export { ACCOUNT_MODE_LABELS, AccountBalanceCore, AccountMode, CollateralBalance
 export { BaseAccountTracker } from './base';
 export { BinanceMultiAssetBalance, BinanceSingleAssetBalance } from './binance/balance';
 export { BybitIsolatedMarginBalance, BybitPortfolioMarginBalance, BybitRegularMarginBalance } from './bybit/balance';
-export { HyperliquidDexState, HyperliquidPortfolioMarginBalance, HyperliquidPortfolioMarginCollateral, HyperliquidStandardBalance, HyperliquidUnifiedBalance } from './hyperliquid/balance';
+export { HyperliquidBorrowLendReserve, HyperliquidDexState, HyperliquidPortfolioMarginBalance, HyperliquidPortfolioMarginCollateral, HyperliquidStandardBalance, HyperliquidUnifiedBalance } from './hyperliquid/balance';
 export { LighterClassicBalance, LighterUnifiedBalance } from './lighter/balance';
 export { LIGHTER_QUOTE_ASSETS } from './lighter/const';
 export { OkxFuturesBalance, OkxMultiCurrencyMarginBalance, OkxPortfolioMarginBalance, OkxSpotBalance } from './okx/balance';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/exchanges-sdk",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Pear Protocol Exchanges SDK",
   "private": false,
   "type": "module",