Portfolio & Returns

Definition

This data provides a detailed overview of a specific wallet address's activity and position within popular decentralized lending protocols. For a given user's address participating in any of these lending platforms, we give the ability to look at the total amount they've deposited into the protocol, total amount of collateral they've supplied to the protocol, total amount they've borrowed, total amount they can still borrow, the difference between total collateral and total borrowed, total amount of protocol incentives they've generated by participating in the protocol, total amount of protocol incentives they have not yet claimed, a risk metric that indicates how close they are to being liquidated, the maximum loan value, the limit at which they are considered under-collateralized, and the collection of all lending and borrowing positions that this address holds broken down by asset


Details

Having all this data accessible via a single API endpoint is immensely valuable for several reasons:

  • Comprehensive Oversight: It provides a holistic view of an address's activity within a specific decentralized lending protocol. This allows for efficient monitoring and management of risk, lending, and borrowing activities.
  • Risk Management: With metrics like the risk of liquidation, maximum loan value, and the limit of undercollateralization, users or automated systems can make timely decisions to prevent liquidation or optimize returns.
  • Incentive Tracking: Information on generated and unclaimed protocol incentives enables users to claim rewards optimally, thereby maximizing yield.

This kind of data aggregation simplifies complex DeFi interactions, making it easier for users to engage with lending protocols more effectively.


API Endpoints

[/defi/lending/{protocolId}/wallets/{address}/portfolio]


Availability

Our Lending Wallets endpoint is available via REST API for historical (time series) data, which goes back to the creation date of the lending protocol and of course the date a user first began participating in the lending protocol.

We support Aave v2 & v3, Compound v2 & v3 and MakerDAO on Ethereum, Polygon, Avalanche, Arbitrum and Optimism.


Frequently Asked Questions

  • What is DeFi Lending?
    • DeFi (Decentralized Finance) lending refers to the practice of lending assets through blockchain-based platforms without the need for traditional financial intermediaries like banks. Some of the more popular Lending platforms being Aave, Compound and MakerDAO.
  • What is collateral?
    • Collateral is the asset you lock up in a smart contract when you take out a loan. If you fail to repay, the collateral can be liquidated to cover the debt. If the value of your collateral drops below a certain threshold, it may be sold off automatically to repay your loan.
  • How is the Interest Rate determined?
    • Interest rates on DeFi lending platforms are often determined algorithmically, based on supply and demand for a particular asset.