API

Base URL: https://api.hyperlend.finance

Available chains: hyperEvmTestnet

---

/data/interestRateHistory

Query interest rate hourly history.

• required params: chain and token (contract address)

• example: /data/interestRateHistory?chain=hyperEvmTestnet&token=0x453b63484b11bbF0b61fC7E854f8DAC7bdE7d458

• response format:

[
  {
    "_id": "66d90e9aa6e4d9c524ef729a",
    "timestamp": 1725501082135,
    "0x453b63484b11bbF0b61fC7E854f8DAC7bdE7d458": {
      "currentLiquidityRate": "7901245102880645706451431",
      "currentVariableBorrowRate": "29629649382709465022770918"
    }
  },
  {
    "_id": "66d91caaa6e4d9c524ef72b2",
    "timestamp": 1725504682074,
    "0x453b63484b11bbF0b61fC7E854f8DAC7bdE7d458": {
      "currentLiquidityRate": "6971805824458391305412",
      "currentVariableBorrowRate": "880139245577900154208182"
    }
  },
  ...
]

---

/data/user/valueChange

Query the user's 24-hour balance change.

• required params: address and chain

• example: /data/user/valueChange?chain=arbitrum&address=0x0E61A8fb14f6AC999646212D30b2192cd02080Dd

• response format:

{
  "prevPos": {
    "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9": {
      "tokenValue": 36.492697000000135,
      "usdValue": 36.4105784364399,
      "name": "tether"
    },
    "0xaf88d065e77c8cC2239327C5EDb3A432268e5831": {
      "tokenValue": -0.505677,
      "usdValue": -0.5047376206695895,
      "name": "usd-coin"
    },
    "0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f": {
      "tokenValue": 0.00033692,
      "usdValue": 19.147241624351143,
      "name": "bitcoin"
    }
  },
  "newPositions": {
    "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9": {
      "tokenValue": 36.492697000000135,
      "usdValue": 36.44846785123614,
      "name": "tether"
    },
    "0xaf88d065e77c8cC2239327C5EDb3A432268e5831": {
      "tokenValue": -0.505677,
      "usdValue": -0.505194584142,
      "name": "usd-coin"
    },
    "0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f": {
      "tokenValue": 0.00033692,
      "usdValue": 19.70038624,
      "name": "bitcoin"
    }
  },
  "tokenDiff": {
    "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9": 0,
    "0xaf88d065e77c8cC2239327C5EDb3A432268e5831": 0,
    "0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f": 0
  },
  "usdDiff": {
    "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9": 0.03788941479623986,
    "0xaf88d065e77c8cC2239327C5EDb3A432268e5831": -0.00045696347241053203,
    "0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f": 0.5531446156488578
  },
  "tokenPercentageDiff": {
    "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9": 0,
    "0xaf88d065e77c8cC2239327C5EDb3A432268e5831": 0,
    "0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f": 0
  },
  "usdPercentageDiff": {
    "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9": 0.10400744101600679,
    "0xaf88d065e77c8cC2239327C5EDb3A432268e5831": 0.09049389062620931,
    "0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f": 2.847765210171073
  },
  "totalBalanceChange": 0.5905770669726849,
  "totalBalanceChangePercentage": 1.0670179746650437
}

---

/data/user/historicalNetWorth

Query the user's hourly USD net worth.

• required params: address and chain

• example: /data/user/historicalNetWorth?chain=arbitrum&address=0x0E61A8fb14f6AC999646212D30b2192cd02080Dd

• response format:

[
  {
    "timestamp": 1725886951424,
    "usdValue": 605.9349161471797
  },
  {
    "timestamp": 1725890548453,
    "usdValue": 604.8168613233992
  },
  {
    "timestamp": 1725894410263,
    "usdValue": 604.4794076893005
  },
  ...
]

---

/data/markets

Query current reserves state

• required params: chain

• response format:

{
    "reserves": [
        {
            "chain": "arbitrum",
            "underlyingAsset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
            "name": "USD Coin",
            "symbol": "USDC",
            "decimals": "6",
            "baseLTVasCollateral": "8000",
            "reserveLiquidationThreshold": "8500",
            "reserveLiquidationBonus": "11000",
            "reserveFactor": "2000",
            "usageAsCollateralEnabled": true,
            "borrowingEnabled": true,
            "stableBorrowRateEnabled": false,
            "isActive": true,
            "isFrozen": false,
            "liquidityIndex": "1000000000000000000000000000",
            "variableBorrowIndex": "1000000000000000000000000000",
            "liquidityRate": "400000000000000000000000",
            "variableBorrowRate": "5000000000000000000000000",
            "stableBorrowRate": "60625000000000000000000000",
            "lastUpdateTimestamp": "1722973930",
            "aTokenAddress": "0x4ed318353e3aB859F614aB41BFC33f98Cca8B3aE",
            "stableDebtTokenAddress": "0x6a970b349D8B60b57a335C0bdd16b8EEbD19Fa8F",
            "variableDebtTokenAddress": "0x82bf3C188d6397f2b9dE6D9F3834381C9C205585",
            "interestRateStrategyAddress": "0xa18DE0E9fd605be95026130FDFb592431Fc7a9B7",
            "availableLiquidity": "900000",
            "totalPrincipalStableDebt": "0",
            "averageStableRate": "0",
            "stableDebtLastUpdateTimestamp": "0",
            "totalScaledVariableDebt": "100000",
            "priceInMarketReferenceCurrency": "99996000",
            "priceOracle": "0x50834F3163758fcC1Df9973b6e91f0F0F0434aD3",
            "variableRateSlope1": "40000000000000000000000000",
            "variableRateSlope2": "750000000000000000000000000",
            "stableRateSlope1": "5000000000000000000000000",
            "stableRateSlope2": "750000000000000000000000000",
            "baseStableBorrowRate": "60000000000000000000000000",
            "baseVariableBorrowRate": "0",
            "optimalUsageRatio": "800000000000000000000000000",
            "isPaused": false,
            "isSiloedBorrowing": false,
            "accruedToTreasury": "0",
            "unbacked": "0",
            "isolationModeTotalDebt": "0",
            "flashLoanEnabled": true,
            "debtCeiling": "0",
            "debtCeilingDecimals": "2",
            "eModeCategoryId": "0",
            "borrowCap": "0",
            "supplyCap": "10000",
            "eModeLtv": "0",
            "eModeLiquidationThreshold": "0",
            "eModeLiquidationBonus": "0",
            "eModePriceSource": "0x0000000000000000000000000000000000000000",
            "eModeLabel": "",
            "borrowableInIsolation": false
        }
    ]
}

---

/data/transactions

Query events data.

• optional params:

  • chain, contractId, blockNumber, txHash, logIndex, event

  • on data field: see available event parameters below

  • example: /data/transaction?chain=arbitrum&event=Borrow&reserve=0xaf88d065e77c8cC2239327C5EDb3A432268e5831

  • response format:

{
    uniqueId: "0x4839ef5e7ca3e0cf8eea625a2a640277980fbc0406542fcd4604fba15a325504_6"
    chain: "arbitrum"
    contractId: "pool"
    blockNumber	240136270
    txHash: "0x4839ef5e7ca3e0cf8eea625a2a640277980fbc0406542fcd4604fba15a325504"
    logIndex: 6
    event: "Borrow"
    data: {
        ...eventParameters
    }
}

All indexed events:

[
  {
    "name": "BackUnbacked",
    "parameters": [
      ["reserve", "address"],
      ["backer", "address"],
      ["amount", "uint256"],
      ["fee", "uint256"]
    ]
  },
  {
    "name": "Borrow",
    "parameters": [
      ["reserve", "address"],
      ["user", "address"],
      ["onBehalfOf", "address"],
      ["amount", "uint256"],
      ["interestRateMode", "uint8"],
      ["borrowRate", "uint256"],
      ["referralCode", "uint16"]
    ]
  },
  {
    "name": "FlashLoan",
    "parameters": [
      ["target", "address"],
      ["initiator", "address"],
      ["asset", "address"],
      ["amount", "uint256"],
      ["interestRateMode", "uint8"],
      ["premium", "uint256"],
      ["referralCode", "uint16"]
    ]
  },
  {
    "name": "IsolationModeTotalDebtUpdated",
    "parameters": [
      ["asset", "address"],
      ["totalDebt", "uint256"]
    ]
  },
  {
    "name": "LiquidationCall",
    "parameters": [
      ["collateralAsset", "address"],
      ["debtAsset", "address"],
      ["user", "address"],
      ["debtToCover", "uint256"],
      ["liquidatedCollateralAmount", "uint256"],
      ["liquidator", "address"],
      ["receiveAToken", "bool"]
    ]
  },
  {
    "name": "MintUnbacked",
    "parameters": [
      ["reserve", "address"],
      ["user", "address"],
      ["onBehalfOf", "address"],
      ["amount", "uint256"],
      ["referralCode", "uint16"]
    ]
  },
  {
    "name": "MintedToTreasury",
    "parameters": [
      ["reserve", "address"],
      ["amountMinted", "uint256"]
    ]
  },
  {
    "name": "RebalanceStableBorrowRate",
    "parameters": [
      ["reserve", "address"],
      ["user", "address"]
    ]
  },
  {
    "name": "Repay",
    "parameters": [
      ["reserve", "address"],
      ["user", "address"],
      ["repayer", "address"],
      ["amount", "uint256"],
      ["useATokens", "bool"]
    ]
  },
  {
    "name": "ReserveDataUpdated",
    "parameters": [
      ["reserve", "address"],
      ["liquidityRate", "uint256"],
      ["stableBorrowRate", "uint256"],
      ["variableBorrowRate", "uint256"],
      ["liquidityIndex", "uint256"],
      ["variableBorrowIndex", "uint256"]
    ]
  },
  {
    "name": "ReserveUsedAsCollateralDisabled",
    "parameters": [
      ["reserve", "address"],
      ["user", "address"]
    ]
  },
  {
    "name": "ReserveUsedAsCollateralEnabled",
    "parameters": [
      ["reserve", "address"],
      ["user", "address"]
    ]
  },
  {
    "name": "Supply",
    "parameters": [
      ["reserve", "address"],
      ["user", "address"],
      ["onBehalfOf", "address"],
      ["amount", "uint256"],
      ["referralCode", "uint16"]
    ]
  },
  {
    "name": "SwapBorrowRateMode",
    "parameters": [
      ["reserve", "address"],
      ["user", "address"],
      ["interestRateMode", "uint8"]
    ]
  },
  {
    "name": "UserEModeSet",
    "parameters": [
      ["user", "address"],
      ["categoryId", "uint8"]
    ]
  },
  {
    "name": "Withdraw",
    "parameters": [
      ["reserve", "address"],
      ["user", "address"],
      ["to", "address"],
      ["amount", "uint256"]
    ]
  }
]