Aavescan API

Fetch live and historical lending data for Aave and the wider DeFi ecosystem including Ethena, Morpho, Compound, Sky and Spark.

Get API access

[
  {
    "timestamp": "2024-05-01T00:00:00Z",
    "supplyAPR": 0.0342,
    "borrowAPR": 0.0279,
    "totalSupplied": 48234567.12,
    "totalBorrowed": 33561187.42,
    "symbol": "USDC"
  }
]

10+ endpoints covering live yields, borrow rates, market sizes, oracle prices, interest rate models and historical data stretching back to 2020 DeFi Summer. Precise data sourced directly from onchain.

Live Aave Markets

GET /v2/reserves/latest

Live lending data for Aave markets. Returns live supply APR, borrow APR, total supplied and total borrowed for every supported Aave market.

Example: curl "https://api.aavescan.com/v2/reserves/latest?apiKey=YOUR_KEY"

Live DeFi Ecosystem Markets

GET /v2/ecosystem/latest

Live data for ecosystem markets. Returns live supply APR, borrow APR, total supplied and total borrowed for ecosystem markets includng Ethena sUSDe, Morpho, Compound, Sky sUSDS and Spark.

Example: curl "https://api.aavescan.com/v2/ecosystem/latest?apiKey=YOUR_KEY"

Aave History (hourly snapshots)

GET /v2/hourly-snapshots/{marketSlug}

Hourly snapshots of Aave market data. Returns 30 days of hourly snapshots including historical rates and market sizes.

Example: curl "https://api.aavescan.com/v2/hourly-snapshots/aave-v3-ethereum?apiKey=YOUR_KEY"

Aave History (daily snapshots)

GET /v2/csv/?market=&reserveAddress=

Entire history of Aave markets. Daily snapshots including rates and market sizes from market launch to the present day. Includes liquidity index and borrow index for precise calculation of lending market interest.

Example: curl "https://api.aavescan.com/v2/csv?market=aave-v3-ethereum&reserveAddress=0xdac17f958d2ee523a2206206994597c13d831ec7&apiKey=YourApiKey"

Ecosystem History (daily snapshots)

GET /v2/ecosystem/daily-snapshots/{ecosystemSlug}

Historical data for ecosystem markets. One year of daily snapshots including historical rates and market sizes for ecosystem markets including Ethena sUSDe, Morpho, Compound Sky sUSDS and Spark.

Example: curl "https://api.aavescan.com/v2/ecosystem/daily-snapshots/ethena-susde?apiKey=YOUR_KEY"

Assets

GET /v2/assets

Provides metadata for every tracked asset. Returns token names, symbols, decimals and contract addresses.

Example: curl "https://api.aavescan.com/v2/assets?apiKey=YOUR_KEY"

Oracle Pricing

GET /v2/pricing/latest

Latest oracle price for every tracked token. Returns token addresses and their current oracle price, oracle source and update timestamp.

Example: curl "https://api.aavescan.com/v2/pricing/latest?apiKey=YOUR_KEY"

Incentives

GET /v2/incentives/latest

Live incentives for Aave by ACI and Merkl. Returns active supply and borrow incentives including reward APRs, reward tokens and incentive metadata.

Example: curl "https://api.aavescan.com/v2/incentives/latest?apiKey=YOUR_KEY"

Interest Rate Model

GET /v2/market-configurations

Interest rate models for Aave markets. Returns slopes and optimal utilization for Aave markets which can be used for liquidity simulations.

Example: curl "https://api.aavescan.com/v2/market-configurations?apiKey=YOUR_KEY"

API key

API keys are included with the Advanced plan. Your API key will be sent to the email associated with your account.

Code examples

Here's a minimal Python example that fetches the latest Aave market rates using the requests library. Pass your key as the apiKey query parameter when calling the API.

# Note: brotli must be installed to handle br decompression
# >>> pip install brotli requests

import requests

url = "https://api.aavescan.com/v2/reserves/latest"
params = {"apiKey": "YOUR_KEY"}
response = requests.get(url, params=params)
data = response.json()
print(data)