This API retrieves information about all of the actions that occurred on the protocol within a certain timespan.
Time Range Limit
The maximum time range (difference between endDate and startDate) is 60 days.
Not specifying startDate and endDate
If the startDate and endDate query parameters are not provided, the API will return the data from the previous 24 hours.
Understanding Actions in Aave
There are many different types of actions in Aave, as you'll see in the action property for each item of the payload.data array. The guide below will help you understand the possible actions.
For Aave v2 and v3, all actions in the API response share the following data structure
| property | type |
|---|---|
| action | string |
| timestamp | string | number |
| blockNumber | number |
| transactionHash | string |
| logIndex | number |
| marketId | string |
| market | string |
| asset | string |
| assetId | string |
| assetSymbol | string |
| amount | number |
| user | string |
UseReserveAsCollateral (v2)
The user has opted to use their AAVE deposits as collateral for any borrowing activity they may undertake.
{
"action": "UseReserveAsCollateral",
"timestamp": "2022-07-03 00:00:44 000",
"blockNumber": 15066174,
"transactionHash": "0xe8b5ad85e3b101c90d043768140320f54002acaedc604168eaed437af6624a72",
"logIndex": 95,
"assetId": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
"assetSymbol": "AAVE",
"marketId": "0xb53c1a33016b2dc2ff3653530bff1848a515c8c5",
"market": "main",
"reserveAsCollateralEnabled": true,
"user": "0xc86722c4b3a75bc60903b523375ab46b1094ccd2"
}
Deposit (v2)
user deposits AAVE into the protocol. The protocol will send aTokens to onBehalfOf.
amount is measured in AAVE i.e. the value has been normalized with the decimal count for assetId.
{
"action": "Deposit",
"timestamp": "2022-07-03 00:00:44 000",
"blockNumber": 15066174,
"transactionHash": "0xe8b5ad85e3b101c90d043768140320f54002acaedc604168eaed437af6624a72",
"logIndex": 96,
"assetId": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
"assetSymbol": "AAVE",
"marketId": "0xb53c1a33016b2dc2ff3653530bff1848a515c8c5",
"market": "main",
"amount": 0.011121,
"user": "0xc86722c4b3a75bc60903b523375ab46b1094ccd2",
"onBehalfOf": "0xc86722c4b3a75bc60903b523375ab46b1094ccd2"
}
Withdraw (v2)
user withdraws WETH from the protocol.
amount is measured in WETH i.e. the value has been normalized with the decimal count for assetId.
{
"action": "Withdraw",
"timestamp": "2022-07-03 00:04:24 000",
"blockNumber": 15066187,
"transactionHash": "0xb3a347631e0925502daf5beabde2eee4b2bf0d1c0527b4361af94247c4890aa7",
"logIndex": 617,
"assetId": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"assetSymbol": "WETH",
"marketId": "0xb53c1a33016b2dc2ff3653530bff1848a515c8c5",
"market": "main",
"amount": 0.25,
"user": "0xcc9a0b7c43dc2a5f023bb9b738e45b0ef6b06e04",
"to": "0xcc9a0b7c43dc2a5f023bb9b738e45b0ef6b06e04"
}
LiquidationCall (v2)
liquidator has liquidated liquidatee who had borrowed principalAmount of principalAssetId. The collateral for the borrowed amount was collateralAmount of collateralAssetId.
principalAmount is measured in units of USDC i.e. the value has been normalized with the decimal count for principalAssetId.
collateralAmount is measured in units of WETH i.e. the value has been normalized with the decimal count for collateralAssetId.
{
"action": "LiquidationCall",
"timestamp": "2022-08-09 09:23:53 000",
"transactionHash": "0x911ceee10ac4ec1ffd4090c9ff8bdefa4c436e53f1b29fa4af94f08e68da9dd9",
"collateralAssetId": "0x7ceb23fd6bc0add59e62ac25578270cff1b9f619",
"collateralAssetSymbol": "WETH",
"collateralAmount": 0.000892019360310137,
"principalAssetId": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
"principalAssetSymbol": "USDC",
"principalAmount": 1.5,
"marketId": "0xd05e3e715d945b59290df0ae8ef85c1bdb684744",
"market": "main",
"liquidatee": "0x8a37d8565fea82cbf2fd7309082b119e48fceab7",
"liquidator": "0x45ae0b1f75d1e053df943fea711dafb08afd10df"
}
| property | type |
|---|---|
| liquidator | string |
| liquidatee | string |
| collateralAssetSymbol | string |
| collateralAssetId | string |
| collateralAmount | number |
| principalAssetId | string |
| principalAssetSymbol | string |
| principalAmount | number |
Repay (v2)
user repays borrowed UNI back to the protocol.
amount is measured in UNI i.e. the value has been normalized with the decimal count for assetId.
{
"action": "Repay",
"timestamp": "2022-07-03 00:25:56 000",
"blockNumber": 15066291,
"transactionHash": "0x63a8b09aff565fa856c7a889805e8ef94d0d1d4dc1f289328601787c17e5c275",
"logIndex": 722,
"assetId": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
"assetSymbol": "UNI",
"marketId": "0xb53c1a33016b2dc2ff3653530bff1848a515c8c5",
"market": "main",
"amount": 2004.0027084060312,
"user": "0x4ef3d7b3f313bef38c5d4db0acf103c49f085206",
"repayer": "0x4ef3d7b3f313bef38c5d4db0acf103c49f085206"
}
Borrow (v2)
user has borrowed DAI from the protocol.
amount is measured in DAI i.e. the value has been normalized with the decimal count for assetId.
This borrowed amount has a Stable interest rate as seen in borrowRateMode.
The amount debt indicates how much user owes when including the interest rate.
{
"action": "Borrow",
"timestamp": "2022-08-01 01:56:11 000",
"blockNumber": 15253806,
"transactionHash": "0xe0956ea55a7137b729ae1f9a5075afa2de8a8c4f63b1cbfe231d266b52af950f",
"logIndex": 350,
"assetId": "0x6b175474e89094c44da98b954eedeac495271d0f",
"assetSymbol": "DAI",
"marketId": "0xb53c1a33016b2dc2ff3653530bff1848a515c8c5",
"market": "main",
"amount": 210,
"borrowRate": 0.10878110591798286,
"borrowRateMode": "Stable",
"debt": 210,
"user": "0x11df4ba2a7cf889dbcb3fc3a41f4469e4b7d70cd",
"onBehalfOf": "0x11df4ba2a7cf889dbcb3fc3a41f4469e4b7d70cd"
}
UseReserveAsCollateral (v3)
The user has not opted to use their USDT deposits as collateral for any borrowing activity they may undertake. This is indicated by reserveAsCollateralEnabled.
{
"action": "UseReserveAsCollateral",
"timestamp": "2022-07-03 01:17:44 000",
"blockNumber": 30271264,
"transactionHash": "0x7302fb592e354a7d59b028f0cc62486dc653397fd919bf5021c1140a0d58af4a",
"logIndex": 529,
"assetId": "0xc2132d05d31c914a87c6611c10748aeb04b58e8f",
"assetSymbol": "USDT",
"marketId": "0xa97684ead0e402dc232d5a977953df7ecbab3cdb",
"market": "main",
"reserveAsCollateralEnabled": false,
"user": "0xfd896db057f260adce7fd1fd48c6623e023406cd"
}
Supply
user deposits USDC into the protocol.
amount is measured in USDC i.e. the value has been normalized with the decimal count for assetId.
{
"action": "Supply",
"timestamp": "2022-08-01 06:29:04 000",
"blockNumber": 19093827,
"transactionHash": "0xe35a550d51a70159c8c025f54dde22e9d48d6a2bae6cf8f4c307cbb640d6de22",
"logIndex": 7,
"assetId": "0xff970a61a04b1ca14834a43f5de4533ebddb5cc8",
"assetSymbol": "USDC",
"marketId": "0xa97684ead0e402dc232d5a977953df7ecbab3cdb",
"market": "main",
"amount": 1218.814651,
"eMode": "Stablecoins",
"user": "0x107a6578ab250f79f9763fc825e8d6cab0d33c6a",
"onBehalfOf": "0x107a6578ab250f79f9763fc825e8d6cab0d33c6a"
}
Withdraw (v3)
user withdraws DAI from the protocol.
amount is measured in DAI i.e. the value has been normalized with the decimal count for assetId.
{
"action": "Withdraw",
"timestamp": "2022-08-02 03:18:29 000",
"blockNumber": 31418075,
"transactionHash": "0x93844d035899ec29592593ce5288765b69369680331667b289ff2aba908031f7",
"logIndex": 145,
"assetId": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
"assetSymbol": "DAI",
"marketId": "0xa97684ead0e402dc232d5a977953df7ecbab3cdb",
"market": "main",
"amount": 11.424311183807943,
"eMode": "Stablecoins",
"user": "0x6f89d672ee4c5200b47f1d6ad90c4e2ac76403ff",
"to": "0x6f89d672ee4c5200b47f1d6ad90c4e2ac76403ff"
}
LiquidationCall (v3)
liquidator has liquidated an user who had borrowed principalAmount of principalAssetId. The collateral for the borrowed amount was collateralAmount of collateralAssetId.
principalAmount is measured in units of USDC i.e. the value has been normalized with the decimal count for principalAssetId.
collateralAmount is measured in units of AAVE i.e. the value has been normalized with the decimal count for collateralAssetId.
{
"action": "LiquidationCall",
"timestamp": 1660890469000,
"blockNumber": 32061280,
"transactionHash": "0x733b6b3fbb7c0d5bd1efa3bf214669ad4e8b1d17e6610b836f01260ab76be98c",
"logIndex": 72,
"collateralAssetId": "0xd6df932a45c0f255f85145f286ea0b292b21c90b",
"collateralAssetSymbol": "AAVE",
"collateralAmount": 76.2606347539024,
"principalAssetId": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
"principalAssetSymbol": "USDC",
"principalAmount": 6439.093207,
"marketId": "0xa97684ead0e402dc232d5a977953df7ecbab3cdb",
"market": "main",
"liquidator": "0x0000000eb7d8244007da6cd63a512ec69494b231"
}
| property | type |
|---|---|
| liquidator | string |
| collateralAssetSymbol | string |
| collateralAssetId | string |
| collateralAmount | number |
| principalAssetId | string |
| principalAssetSymbol | string |
| principalAmount | number |
Repay (v3)
user repays borrowed SUSHI back to the protocol.
amount is measured in SUSHI i.e. the value has been normalized with the decimal count for assetId.
{
"action": "Repay",
"timestamp": "2022-08-01 21:27:59 000",
"blockNumber": 31408342,
"transactionHash": "0xc2cc89f0aa3dd907c26207d0f646c47eae30a5d6e9952416383c3f2cb912709c",
"logIndex": 6,
"assetId": "0x0b3f868e0be5597d5db7feb59e1cadbb0fdda50a",
"assetSymbol": "SUSHI",
"marketId": "0xa97684ead0e402dc232d5a977953df7ecbab3cdb",
"market": "main",
"amount": 37.75909906061239,
"user": "0x8f6ea2a2a97ea939c885d3ec0087110962220a30",
"repayer": "0x8f6ea2a2a97ea939c885d3ec0087110962220a30",
"useATokens": false
}
Borrow (v3)
user has borrowed DAI from the protocol.
amount is measured in DAI i.e. the value has been normalized with the decimal count for assetId.
{
"action": "Borrow",
"timestamp": "2022-08-01 09:05:53 000",
"blockNumber": 31387828,
"transactionHash": "0x5fe6ebc737c20ba3c49182c13eea4086f0da12a8c5b7f6390803ea1ee2fe7eb7",
"logIndex": 27,
"assetId": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
"assetSymbol": "DAI",
"marketId": "0xa97684ead0e402dc232d5a977953df7ecbab3cdb",
"market": "main",
"amount": 89565.3201800187,
"eMode": "Stablecoins",
"borrowRate": 0.021916209100217913,
"borrowRateMode": 2,
"debt": 0,
"user": "0x42c79c16ba4e6f76b51fa9c522b6abd8741ecb9c",
"onBehalfOf": "0xab01006b561b7f85c9ac9027b00a6ddb7b0cf93b"
}