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 of deposits backing active loans from the pool. When active loans increase, 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, deposit amounts and active loan 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 deposit amount in the underlying asset.
- totalBorrowed: Total active loan amount in the underlying asset.
- totalSuppliedUsd: Total deposit amount denominated in USD.
- totalBorrowedUsd: Total active loan 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: Active loans as a percentage of deposits. 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 deposited 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 deposits.
- totalOwed: Total active loan 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
Historical Incentives
Historical incentives are not included in the standard 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.
What To Use The Dataset For
- Analyze how supply and borrow rates have changed over time.
- Compare utilization, deposit amounts and active loan 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.