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 one asset in one market at one 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 market size and market-level historical changes over time.
- totalSupplied: Total supplied amount in the underlying asset.
- totalBorrowed: Total borrowed amount in the underlying asset.
- totalSuppliedUsd: Total supplied amount converted to USD by Aavescan.
- totalBorrowedUsd: Total borrowed amount converted to USD by Aavescan.
- supplyApr24h: Average supply APR over the previous 24 hours, derived from index changes by Aavescan.
- borrowApr24h: Average borrow APR over the previous 24 hours, derived from index changes by Aavescan.
- totalSupplyApr24h: 24 hour average supply APR including supply incentives when present.
- totalBorrowApr24h: 24 hour average net borrow APR after subtracting borrow incentives when present.
Rate and Index Fields
These fields describe supply rates, borrow rates and the indexes used to calculate historical interest through time.
Aavescan groups equivalent rate and index fields together so the dataset can be used consistently across Aave versions.
- liquidityRate / currentLiquidityRate / supplyApr: Supply APR at the snapshot timestamp.
- liquidityIndex / supplyIndex: Cumulative depositor index used to calculate historical supply yield between two timestamps.
- variableBorrowRate / currentVariableBorrowRate / borrowApr: Variable borrow APR at the snapshot timestamp.
- variableBorrowIndex / 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.
Incentives Fields
These fields show additional rewards attached to supplying or borrowing an asset.
- incentivesType: Incentives source for that snapshot, for example merkl.
- incentivesSupplyApr: Additional supply APR from incentive rewards.
- incentivesBorrowApr: Borrow-side incentive APR used to reduce the net borrow cost.
- incentivesRewardTokens: Reward token symbols attached to the incentive campaign.
- incentivesCampaignIds: Campaign identifiers for the active incentive programs on that date.
Aave V3 Fields
These fields appear for Aave V3 reserves.
- currentStableBorrowRate: 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.
For APY calculations, read Calculating Crypto Interest Rates
How to Use the Dataset
- Analyze how supply and borrow rates have changed over time.
- Compare utilization, supplied amounts and borrowed amounts across Aave markets.
- Study incentive periods, liquidity shifts and reserve growth on a per-asset basis.
Why Use Aavescan?
Aavescan offers tools to:
- Access live deposit and borrow rates.
- Download historical data in CSV format for Excel, Google Sheets and Python.
- Compare rates across Aave and DeFi markets.
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.