Skip to main content

LenderDataEntry

Fused lender entry combining sub-account position data with aggregated summary metrics.

lenderstringrequired

Lender identifier

Example: AAVE_V3
chainIdstringrequired

Chain ID

Example: 1
accountstringrequired

User account address

Example: 0xbadA9c382165b31419F4CC0eDf0Fa84f80A3C8E5
data object[]required

Sub-account position data

  • Array [
  • accountIdstringrequired

    Sub-account identifier (e.g., "0" for default, NFT ID for Init)

    Example: 0
    healthnumbernullable

    Health factor (null if no debt). Values > 1 are healthy, < 1 at risk of liquidation.

    Example: 1.85
    borrowCapacityUSDnumber

    Total USD borrowable while maintaining health >= 1

    Example: 3000
    balanceData objectrequired

    Aggregated balance data for a sub-account.

    depositsnumber

    Total deposits in USD

    Example: 10000.5
    debtnumber

    Total debt in USD

    Example: 5000.25
    adjustedDebtnumber

    Debt adjusted for borrow factors

    Example: 5500
    collateralnumber

    Collateral value in USD

    Example: 9000
    collateralAllActivenumber

    Collateral if all assets were enabled

    Example: 10000.5
    borrowDiscountedCollateralnumber

    Collateral discounted by borrow factors

    Example: 8000
    borrowDiscountedCollateralAllActivenumber

    Discounted collateral if all enabled

    Example: 9000
    navnumber

    Net asset value (deposits - debt)

    Example: 5000.25
    deposits24hnumber

    Deposits 24h ago (for change calculation)

    Example: 9800
    debt24hnumber

    Debt 24h ago

    Example: 4900
    nav24hnumber

    NAV 24h ago

    Example: 4900
    rewards object

    Pending rewards by token

    property name*any

    Pending rewards by token

    aprData objectrequired

    APR breakdown for a sub-account.

    aprnumber

    Net APR (deposit - borrow)

    Example: 2.5
    depositAprnumber

    Weighted deposit APR

    Example: 3.5
    borrowAprnumber

    Weighted borrow APR

    Example: 5.2
    rewardAprnumber

    Total reward APR

    Example: 1.2
    rewardDepositAprnumber

    Reward APR on deposits

    Example: 0.8
    rewardBorrowAprnumber

    Reward APR on borrows

    Example: 0.4
    intrinsicAprnumber

    Intrinsic yield APR (e.g., stETH staking)

    Example: 0
    intrinsicDepositAprnumber

    Intrinsic yield APR portion from deposits

    Example: 0
    intrinsicBorrowAprnumber

    Intrinsic yield APR portion from borrows

    Example: 0
    rewards object

    Reward token details

    property name*any

    Reward token details

    positions object[]required

    Individual asset positions in this sub-account

  • Array [
  • marketUidstring

    Unique market identifier (format: {lender}:{chainId}:{address})

    Example: AAVE_V3:1:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
    depositsstring

    Deposit amount in token units (wei)

    Example: 1000000000000000000
    debtstring

    Variable debt in token units

    Example: 0
    debtStablestring

    Stable debt in token units

    Example: 0
    depositsUSDnumber

    Deposits in USD

    Example: 2500
    debtUSDnumber

    Variable debt in USD

    Example: 0
    debtStableUSDnumber

    Stable debt in USD

    Example: 0
    collateralEnabledboolean

    Whether this asset is enabled as collateral

    Example: true
    claimableRewardsnumber

    Claimable rewards in USD

    Example: 0.5
    withdrawablestring

    Max tokens withdrawable while maintaining health >= 1. Equals full deposit balance if collateral is not enabled.

    Example: 0.5
    borrowablestring

    Max tokens borrowable against remaining credit line. Zero if borrowing is disabled, reserve is frozen, or debt is disabled for the active mode.

    Example: 100
  • ]
  • userConfig objectrequired

    User configuration for a sub-account.

    selectedModeinteger

    E-Mode category (0 = none)

    Example: 0
    idstring

    Config identifier

    Example: 0
    isWhitelistedboolean

    Whether user is whitelisted (for permissioned markets)

  • ]
  • totalDepositsUSDnumber

    Total deposits in USD

    Example: 10000
    totalDebtUSDnumber

    Total debt in USD

    Example: 5000
    netWorthnumber

    Net worth (deposits - debt)

    Example: 5000
    netWorth24hnumber

    Net worth 24h ago

    Example: 4900
    depositAprnumber

    Weighted deposit APR

    Example: 3.5
    borrowAprnumber

    Weighted borrow APR

    Example: 5.2
    netAprnumber

    Net APR (deposit - borrow, weighted)

    Example: 1.8
    rewardAprnumber

    Reward APR

    Example: 1.2
    healthFactornumbernullable

    Health factor (null if no debt)

    Example: 1.85
    leveragenumber

    Leverage ratio (deposits / netWorth)

    Example: 2
    collateralnumber

    Collateral value in USD

    Example: 9000
    LenderDataEntry
    {
    "lender": "AAVE_V3",
    "chainId": "1",
    "account": "0xbadA9c382165b31419F4CC0eDf0Fa84f80A3C8E5",
    "data": [
    {
    "accountId": "0",
    "health": 1.85,
    "borrowCapacityUSD": 3000,
    "balanceData": {
    "deposits": 10000.5,
    "debt": 5000.25,
    "adjustedDebt": 5500,
    "collateral": 9000,
    "collateralAllActive": 10000.5,
    "borrowDiscountedCollateral": 8000,
    "borrowDiscountedCollateralAllActive": 9000,
    "nav": 5000.25,
    "deposits24h": 9800,
    "debt24h": 4900,
    "nav24h": 4900,
    "rewards": {}
    },
    "aprData": {
    "apr": 2.5,
    "depositApr": 3.5,
    "borrowApr": 5.2,
    "rewardApr": 1.2,
    "rewardDepositApr": 0.8,
    "rewardBorrowApr": 0.4,
    "intrinsicApr": 0,
    "intrinsicDepositApr": 0,
    "intrinsicBorrowApr": 0,
    "rewards": {}
    },
    "positions": [
    {
    "marketUid": "AAVE_V3:1:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "deposits": "1000000000000000000",
    "debt": "0",
    "debtStable": "0",
    "depositsUSD": 2500,
    "debtUSD": 0,
    "debtStableUSD": 0,
    "collateralEnabled": true,
    "claimableRewards": 0.5,
    "withdrawable": "0.5",
    "borrowable": "100"
    }
    ],
    "userConfig": {
    "selectedMode": 0,
    "id": "0",
    "isWhitelisted": true
    }
    }
    ],
    "totalDepositsUSD": 10000,
    "totalDebtUSD": 5000,
    "netWorth": 5000,
    "netWorth24h": 4900,
    "depositApr": 3.5,
    "borrowApr": 5.2,
    "netApr": 1.8,
    "rewardApr": 1.2,
    "healthFactor": 1.85,
    "leverage": 2,
    "collateral": 9000
    }