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.
- totalSupplyApr24h: 24 hour average supply APR (derived from index change) including supply incentives when present.
- totalBorrowApr24h: 24 hour average net borrow APR (derived from index change) 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.
- 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.
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.
- 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
- 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.
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.
