The Aave Protocol has several view contracts to assist with querying onchain data.

Contract that returns an array of all reserve or user data for a particular market (for example, liquidity, token addresses, rate strategy), used by the Aave Interface to display Markets and Dashboard data. Compatible with both V2 and v3 of the Aave Protocol.

The Aave Utilities SDK includes an interface to make calls to this contract, and functions to format the response for frontend use-cases.

The source code is available on GitHub.

function getReservesList(IPoolAddressesProvider provider) public view override returns (address[] memory)

Returns the list of initialised reserves in the Pool associated with the given provider.

function getReservesData(IPoolAddressesProvider provider) public view override returns (AggregatedReserveData[] memory, BaseCurrencyInfo memory)

Returns BaseCurrencyInfo of the Pool and AggregatedReserveData[] for all the initialised reserves in the Pool associated with the given provider.

The BaseCurrencyInfo struct is composed of the following fields:

The AggregatedReserveData struct is composed of the following fields:

function getUserReservesData(IPoolAddressesProvider provider, address user) external view override returns (UserReserveData[] memory, uint8)

Returns UserReserveData[] for all user reserves in the Pool associated with the given provider.

The UserReserveData struct is composed of the following fields:

Returns an array of all available E-mode categories in the Pool associated with the provider.

function getEModes(IPoolAddressesProvider provider) external view returns (Emode[] memory)

The Emode struct is composed of the following fields:

The EModeCategory struct is composed of the following fields:

Fetches tokens balances for all underlying tokens of Aave reserves for one user address.

The source code is available on GitHub.

function balanceOf(address user, address token) public view returns (uint256)

Checks the token balance of a wallet in a token contract. Returns the balance of the token for user (ETH included with MOCK_ETH_ADDRESS).

function batchBalanceOf(address[] calldata users, address[] calldata tokens) external view returns (uint256[] memory)

Returns balances for a list of users and tokens (ETH included with MOCK_ETH_ADDRESS).

function getUserWalletBalances(address provider, address user) external view returns (address[] memory, uint256[] memory)

Provides balances of user wallet for all reserves available on the pool.

Contract that returns an array of all reserve incentives or user claimable rewards within a particular market, used by the Aave Labs Interface to display incentives data. Compatible with both V2 and v3 of the Aave Protocol.

The Aave Utilities SDK includes an interface to make calls to this contract, and functions to format the response for frontend use-cases.

The source code is available on GitHub.

function getFullReservesIncentiveData(IPoolAddressesProvider provider, address user)    external    view    override    returns (AggregatedReserveIncentiveData[] memory, UserReserveIncentiveData[] memory)

Returns both AggregatedReserveIncentiveData[] and UserReserveIncentiveData[] for the given user for the pool associated with the given provider.

The AggregatedReserveIncentiveData struct is composed of the following fields:

The UserReserveIncentiveData struct is composed of the following fields:

function getReservesIncentivesData(IPoolAddressesProvider provider) external view override returns (AggregatedReserveIncentiveData[] memory)

Returns AggregatedReserveIncentiveData[] for the pool associated with the given provider.

The AggregatedReserveIncentiveData struct is composed of the following fields:

function getUserReservesIncentivesData(IPoolAddressesProvider provider, address user) external view override returns (UserReserveIncentiveData[] memory)

Returns the UserReserveIncentiveData[] for the given user for the pool associated with the given provider.

The UserReserveIncentiveData struct is composed of the following fields:

The AaveProtocolDataProvider is a peripheral contract to collect and pre-process information from the Pool. This contract contains methods for querying token addresses, reserve parameters, and user account information. The methods of the PoolDataProvider are more granular than the UiPoolDataProvider, which queries data for reserve tokens or user balances simultaneously.

The source code is available on GitHub.

function getAllReservesTokens() external view returns (TokenData[] memory)

Returns a list of the existing reserves in the pool, pairs include the symbol and tokenAddress. Handles MKR and ETH in a different way since they do not have standard symbol functions.

The TokenData struct is composed of the following fields:

function getAllATokens() external view returns (TokenData[] memory)

Returns a list of the existing ATokens in the pool, pairs include the symbol and tokenAddress.

The TokenData struct is composed of the following fields:

function getReserveConfigurationData(address asset) external view returns (    uint256 decimals,    uint256 ltv,    uint256 liquidationThreshold,    uint256 liquidationBonus,    uint256 reserveFactor,    bool usageAsCollateralEnabled,    bool borrowingEnabled,    bool stableBorrowRateEnabled,    bool isActive,    bool isFrozen)

Returns the configuration data of the reserve as described below. Does not return borrow and supply caps, nor pause flag for compatibility.

function getReserveCaps(address asset) external view returns (uint256 borrowCap, uint256 supplyCap)

Returns the caps parameters of the reserve.

function getPaused(address asset) external view returns (bool isPaused)

Returns true if the pool isPaused.

function getSiloedBorrowing(address asset) external view override returns (bool)

Returns the siloed borrowing flag. It returns true if the asset is siloed for borrowing.

function getLiquidationProtocolFee(address asset) external view override returns (uint256)

Returns the protocol fee on the liquidation bonus.

function getUnbackedMintCap(address asset) external view override returns (uint256)

Returns the unbacked mint cap of the reserve.

function getDebtCeiling(address asset) external view override returns (uint256)

Returns the debt ceiling of the reserve.

function getReserveData(address asset) external view override returns (    uint256 unbacked,    uint256 accruedToTreasuryScaled,    uint256 totalAToken,    uint256 totalStableDebt,    uint256 totalVariableDebt,    uint256 liquidityRate,    uint256 variableBorrowRate,    uint256 stableBorrowRate,    uint256 averageStableBorrowRate,    uint256 liquidityIndex,    uint256 variableBorrowIndex,    uint40 lastUpdateTimestamp)

Returns the reserve data.

function getATokenTotalSupply(address asset) external view override returns (uint256)

Returns the total supply of aTokens for a given asset.

function getTotalDebt(address asset) external view override returns (uint256)

Returns the total debt for a given asset.

function getUserReserveData(address asset, address user) external view returns (    uint256 currentATokenBalance,    uint256 currentStableDebt,    uint256 currentVariableDebt,    uint256 principalStableDebt,    uint256 scaledVariableDebt,    uint256 stableBorrowRate,    uint256 liquidityRate,    uint40 stableRateLastUpdated,    bool usageAsCollateralEnabled)

Returns the following user reserve data.

function getReserveTokensAddresses(address asset) external view override returns (    address aTokenAddress,    address stableDebtTokenAddress,    address variableDebtTokenAddress)

Returns the addresses of the aToken, stableDebtToken and variableDebtToken of the reserve.

function getInterestRateStrategyAddress(address asset) external view override returns (address irStrategyAddress)

Returns the address of the Interest Rate strategy.

function getReserveDeficit(address asset) external view override returns (uint256)

function getDebtCeilingDecimals() external pure override returns (uint256)

Returns the debt ceiling decimals.

This contract is a utility for fetching and pre-processing liquidation-related parameters for a given user. It aggregates data from the underlying Pool and Price Oracle to determine a user’s position, collateral, borrow details, and liquidation limits according to the protocol parameters.

The source code is available on GitHub.

getUserPositionFullInfo(address user) public view override returns (UserPositionFullInfo memory)

Returns aggregated position information for a user including total collateral, total debt, available borrows, current liquidation threshold, loan-to-value (LTV), and health factor. All values are denominated in the base currency.

The UserPositionFullInfo struct is composed of the following fields:

getCollateralFullInfo(address user, address collateralAsset) external view override returns (CollateralFullInfo memory)

Returns detailed information regarding a user’s collateral for a given asset. The returned struct includes the asset’s unit (based on decimals), its current price (via the Price Oracle), the associated aToken address, the raw collateral balance, and its equivalent value in the base currency.

The CollateralFullInfo struct is composed of the following fields:

getDebtFullInfo(address user, address debtAsset) external view override returns (DebtFullInfo memory)

Returns detailed information regarding a user’s debt for a given asset. The returned struct includes the asset’s unit, current price, the associated variable debt token address, the debt balance, and its equivalent value in the base currency.

The DebtFullInfo struct is composed of the following fields:

getLiquidationInfo(address user, address collateralAsset, address debtAsset) public view override returns (LiquidationInfo memory)

A convenience function that returns liquidation parameters for a user using the maximum possible debt liquidation amount. Internally, it calls the overloaded version with debtLiquidationAmount set to the maximum (type(uint256).max).

The LiquidationInfo struct is composed of the following fields:

getLiquidationInfo(address user, address collateralAsset, address debtAsset, uint256 debtLiquidationAmount) public view override returns (LiquidationInfo memory)

Returns comprehensive liquidation parameters for a user given a specific collateral asset and debt asset, considering a custom maximum debt liquidation amount. The function aggregates the user’s position, collateral and debt details, checks if liquidation conditions are met, and computes the optimal amounts for liquidation—including any applicable protocol fees.

The LiquidationInfo struct is composed of the following fields: