Aavescan Dataset Guide
Learn how to use the Aavescan dataset and CSV exports to analyze historical Aave interest rates and market data.
What is Aave?
Aave is a decentralized lending platform that enables users to earn interest on deposits or borrow crypto assets using collateral. Aave lending markets use smart contracts to automatically adjust interest rates based on supply and demand.
How Aave Rates Are Determined
Aave interest rates are determined by the utilization rate - the percentage amount of an asset that has been borrowed from the pool. When more is borrowed, rates go up to discourage borrowing and encourage deposits. This system is built into Aave’s smart contracts to keep the market balanced.
Aavescan Dataset Fields
Aavescan CSV exports support historical analysis of Aave market data, including interest rates, utilization, supplied amounts and borrowed amounts.
Each row represents an asset in one market at a particular point in time, making it possible to compare reserve data across markets and across the full history of Aave.
The dataset includes the following fields:
Market Fields
These fields describe the market rates and size through time.
- totalSupplied: Total supplied amount in the underlying asset.
- totalBorrowed: Total borrowed amount in the underlying asset.
- totalSuppliedUsd: Total supplied amount denominated in USD.
- totalBorrowedUsd: Total borrowed amount denominated in USD.
- supplyApr24h: 24 hour average supply APR derived from index change.
- borrowApr24h: 24 hour average borrow APR derived from index change.
Rate and Index Fields
These fields describe supply rates, borrow rates and the indexes used to calculate historical interest through time.
- supplyApr: Supply APR at the snapshot timestamp.
- supplyIndex: Cumulative depositor index used to calculate historical supply yield between two timestamps.
- borrowApr: Variable borrow APR at the snapshot timestamp.
- borrowIndex: Cumulative borrow index used to calculate historical variable borrow interest between two timestamps.
- utilization: Percentage of supplied amount that is currently borrowed. It is not a CSV column, but can be calculated as totalBorrowed / totalSupplied.
Snapshot Fields
These fields identify when and where each reserve snapshot was taken.
- targetDate: Snapshot date in ISO format at midnight UTC.
- timestamp: Unix timestamp used for the snapshot.
- blockNumber: Blockchain block number used to fetch the snapshot.
- reserve: Reserve contract address for the asset in that market.
- symbol: Asset ticker symbol, for example USDC or WETH.
- price: Oracle price at the snapshot timestamp.
Aave V3 Fields
These fields appear for Aave V3 reserves.
- liquidityRate: Supply APR.
- variableBorrowRate: Borrow APR.
- liquidityIndex: Cumulative supply index.
- variableBorrowIndex: Cumulative borrow index.
- stableBorrowRate: Stable borrow APR at the snapshot timestamp.
- totalAToken: Total supplied liquidity denominated in the underlying asset.
- totalStableDebt: Total outstanding stable rate debt denominated in the underlying asset.
- totalVariableDebt: Total outstanding variable rate debt denominated in the underlying asset.
Aave V4 Fields
These fields appear for Aave V4 reserves.
- liquidity: Idle liquidity currently available to borrow in the market.
- addedAssets: Total supplied assets.
- totalOwed: Total borrowed amount.
- addedShares: Supply share units.
- liquidityFee: Liquidity fee in basis points used when deriving the supply APR from borrow demand.
- drawnRate: Borrow APR.
- drawnIndex: Cumulative borrow index.
To learn how Aavescan calculates historical APR and APY rates, read Calculating Crypto Interest Rates
How to Use the Dataset
Historical incentives are not included in Aavescan datasets. Live incentives are available separately in the product and API. If you need bespoke historical incentive support, we can assist subject to requirements.
- Analyze how supply and borrow rates have changed over time.
- Compare utilization, supplied amounts and borrowed amounts across Aave markets.
- Study liquidity shifts and reserve growth on a per-asset basis.
Start with Aavescan Today
Sign up for Aavescan Pro to access complete historical data and live rates.
Disclaimer: Information provided is educational and not financial advice. Always conduct your own research before using DeFi platforms.