Live Aave Markets

GET /v2/latest

Live lending data for Aave markets. Returns live supply APR, borrow APR, total supplied and total borrowed for every supported Aave market, refreshed every 5 minutes. Low latency available on request.

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

Aave Daily History

GET /v2/csv?market=&reserveAddress=

Entire history of Aave markets. Returns the entire history of an Aave market with daily snapshots including supply APR, borrow APR, total supplied and total borrowed from market launch to the present day in CSV format. See response fields for all field definitions.

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

Aave Hourly History

GET /v2/hourly-history/{marketSlug}?reserveAddress=&from=&to=

Hourly history for Aave markets. Returns hourly snapshots including supply APR, borrow APR, total supplied and total borrowed for intraday analysis. All markets are supported with up to 1 year of hourly history (entire history is included and available on request). Use the to and from params to fetch up to 30 days at a time. See response fields for all field definitions.

Example: curl "https://api.aavescan.com/v2/hourly-history/aave-v3-ethereum?reserveAddress=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48&from=2026-01-01&to=2026-01-30&apiKey=YOUR_KEY"

Live Stablecoin Yields

GET /v2/twigscan/latest

Live data for stablecoin yields (ecosystem). Returns live supply APR and total supplied for the stablecoin vaults featured on Twigscan including Ethena sUSDe, Morpho, Compound and Sky sUSDS, refreshed every 5 minutes. Low latency available on request.

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

Stablecoin Yields History

GET /v2/twigscan/daily/{vaultSlug}

Historical data for stablecoin yields (ecosystem). Returns the entire history of supply APR and total supplied for the stablecoin vaults featured on Twigscan including Ethena sUSDe, Morpho, Compound, Sky and Aave.

Example: curl "https://api.aavescan.com/v2/twigscan/daily/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

Incentives for Aave by Merkl. Returns active supply and borrow incentives including reward APRs, reward tokens and incentive metadata, refreshed hourly. Low latency available on request.

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, refreshed hourly. Low latency available on request.

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

Aave History (hourly snapshots)

GET /v2/hourly-snapshots/{marketSlug}

Hourly snapshots of Aave market data. Returns 30 days of hourly snapshots for every asset in the market. See response fields for field definitions.

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

Aave History (daily snapshots)

GET /v2/daily-snapshots/{marketSlug}

Daily snapshots for an entire Aave market. Returns one year of daily snapshots for every asset in the market. See response fields for field definitions.

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

Response fields

Hourly and daily snapshot endpoints return a list of snapshots representing the lending market at each timestamp. Snapshots include the following fields:

• reserve: The asset/reserve contract address.
• symbol: Symbol of the underlying asset.
• totalSuppliedUsd: Total supplied amount in USD.
• totalBorrowedUsd: Total borrowed amount in USD.
• supplyApr24h: Average supply APR over the previous 24 hours.
• borrowApr24h: Average borrow APR over the previous 24 hours.
• liquidityIndex: Cumulative depositor index used to calculate historical supply yield between two timestamps. Use the liquidityIndex to calculate a moving average of the supply APR. Learn more.
• currentLiquidityRate: The supply APR at the snapshot timestamp. This field describes the supply rate at a certain point in time. It is recommended to use the liquidityIndex to calculate a moving average for most use cases. Learn more.
• variableBorrowIndex: Cumulative borrow index used to calculate historical variable borrow interest. Use the variableBorrowIndex to calculate a moving average of the borrow APR. Learn more.
• currentVariableBorrowRate: The variable borrow APR at the snapshot timestamp. This field describes the borrow rate at a certain point in time. It is recommended to use the variableBorrowIndex to calculate a moving average for most use cases. Learn more.
• currentStableBorrowRate: The stable borrow APR at the snapshot timestamp.
• totalAToken: Total supplied liquidity denominated in the underlying asset. Multiply by the asset price to get the total USD value of supplied assets.
• totalStableDebt: Total outstanding stable rate debt denominated in the underlying asset.
• totalVariableDebt: Total outstanding variable rate debt denominated in the underlying asset. Multiply debt by the asset price to get the total USD value of borrows.
• price: The USD oracle price for the asset at the snapshot timestamp.

You can derive total USD values directly from these fields:

• Total supplied USD: totalAToken * price
• Total borrowed USD: (totalStableDebt + totalVariableDebt) * price

Send an email to contact@aavescan.com for any assistance.

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/latest"
params = {"apiKey": "YOUR_KEY"}
response = requests.get(url, params=params)
data = response.json()
print(data)