Aave logo
Protocol

Aave API

Aave V3 is a lending and borrowing protocol. The API returns market-level aggregate states, individual supply and borrow positions, and reserve metadata.

Supported chains

EthereumBaseArbitrumOptimismPolygonAvalanche

Available data

Market States

Per-market aggregates including net worth, health factor, total collateral, and total debt

Supply Positions

Deposit positions earning interest with balance, APY, and collateral status

Borrow Positions

Debt positions accruing interest with outstanding debt and APY

Reserves

Token metadata including aToken and vToken addresses

Notes

  • APY is provided in two formats: apy.value (decimal) and apy.formatted (string, e.g., "5.32%")
  • healthFactor is null when the wallet has no debt — below 1.0 means liquidatable
  • isCollateral indicates whether the asset is currently enabled as collateral

Example query

query.graphql
query {
  walletPositions(inputs: [
    { protocol: "aave", chainId: 1, walletAddress: "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6" }
  ]) {
    data {
      ... on AaveWalletPositions {
        protocol
        walletAddress
        chainId
        marketStates {
          marketName
          netWorth
          healthFactor
          totalCollateralBase
          totalDebtBase
        }
        supplyPositions {
          currency { symbol }
          balanceUsd
          apy { value formatted }
          isCollateral
        }
        borrowPositions {
          currency { symbol }
          debtUsd
          apy { value formatted }
        }
      }
    }
    errors { protocol error { code message } }
  }
}
Try in PlaygroundView full docs

Other protocols

MorphoMorphoPendlePendleFluidFluidCompoundCompoundAvantAvantAvantisAvantisNeutrlNeutrlMidasMidas