AAVE V3 (DeFi Lending)

AAVE is a decentralized lending protocol where users can deposit assets to earn interest or borrow against their collateral.

Supported Networks: ETH, POLYGON, AVAX, ARB, OP, BASE, GNOSIS, SCROLL, BSC, ZK, LINEA

Parameters:

Event Types:

Deposit

Users supply assets to the protocol to earn interest.

Endpoint: GET /v1/aave_v3/events/deposit

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/aave_v3/events/deposit?network=ETH&block_start=24000000&block_end=24010000"

Example Data:

Withdraw

Users remove their supplied assets from the protocol.

Endpoint: GET /v1/aave_v3/events/withdraw

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/aave_v3/events/withdraw?network=ETH&block_start=24000000&block_end=24010000"

Example Data:

Borrow

Users take out loans using their deposited assets as collateral.

Endpoint: GET /v1/aave_v3/events/borrow

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/aave_v3/events/borrow?network=ETH&block_start=24000000&block_end=24010000"

Example Data:

Repay

Users pay back their borrowed amounts.

Endpoint: GET /v1/aave_v3/events/repay

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/aave_v3/events/repay?network=ETH&block_start=24000000&block_end=24100000"

Example Data:

Flash Loan

Instant uncollateralized loans that must be repaid within the same transaction. Used for arbitrage, collateral swaps, and liquidations.

Endpoint: GET /v1/aave_v3/events/flashloan

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/aave_v3/events/flashloan?network=ETH&block_start=24000000&block_end=24100000"

Example Data:

Liquidation

When a borrower’s collateral value falls below the liquidation threshold, liquidators can repay part of the debt and receive discounted collateral.

Endpoint: GET /v1/aave_v3/events/liquidation

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/aave_v3/events/liquidation?network=ETH&block_start=24000000&block_end=24100000"

Example Data:

Example: AAVE Prime Market on Ethereum

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/aave_v3/events/deposit?network=ETH&block_start=24000000&block_end=24010000&eth_market_type=Prime"

Example: AAVE deposits involving exchange addresses

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/aave_v3/events/deposit?network=ETH&block_start=24000000&block_end=24010000&involving_category=exchange"

Aggregate Queries

Bucket AAVE events into time or block intervals with summary statistics.

Endpoint: GET /v1/aave_v3/events/{event_type}/aggregate

Requires group_by (time or block_number) and period (e.g., 2h, 1d, 10000).

Aggregatable event types: deposit (agg_amount, agg_value_usd*), withdraw (agg_amount, agg_value_usd*), borrow (agg_amount, mean_borrow_rate, agg_value_usd*), repay (agg_amount, agg_value_usd*), flashloan (agg_amount, agg_value_usd*), liquidation (agg_debt_to_cover, agg_liquidated_collateral_amount, agg_value_usd*)

* agg_value_usd is only present when with_value=true is passed in the request.

Example: Hourly deposit volume

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/aave_v3/events/deposit/aggregate?network=ETH&block_start=21000000&block_end=21100000&group_by=time&period=1h"

Sample Aggregate Results (deposit):

Sample Aggregate Results (borrow):

Quota & Limits

AAVE V3 endpoints use a block-based quota model. Cost formula: max(100, round(block_range × network_discount × aggregate_discount)).

Check response headers X-RateLimit-Remaining and X-Request-Cost to monitor usage.