UserPositionResponse

User lending positions as a flat array with portfolio summary and per-chain breakdowns.

items object[]

Flat array of lender entries sorted by net worth (descending). Each entry fuses position data with aggregated summary metrics.

Array [

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)

]

balanceData objectrequired

Summary-level balance data (without discounted/adjusted fields).

depositsnumber

Total deposits in USD

Example: 10000.5

debtnumber

Total debt in USD

Example: 5000.25

collateralnumber

Collateral value in USD

Example: 9000

collateralAllActivenumber

Collateral if all assets were enabled

Example: 10000.5

navnumber

Net asset value (deposits - debt)

Example: 5000.25

deposits24hnumber

Deposits 24h ago

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

Summary-level APR breakdown.

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

leveragenumber

Leverage ratio (deposits / nav)

Example: 2

]

summary object

Portfolio-wide totals with per-chain breakdowns. Per-lender summaries are fused into each LenderDataEntry in the items array.

balanceData object

Summary-level balance data (without discounted/adjusted fields).

depositsnumber

Total deposits in USD

Example: 10000.5

debtnumber

Total debt in USD

Example: 5000.25

collateralnumber

Collateral value in USD

Example: 9000

collateralAllActivenumber

Collateral if all assets were enabled

Example: 10000.5

navnumber

Net asset value (deposits - debt)

Example: 5000.25

deposits24hnumber

Deposits 24h ago

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 object

Summary-level APR breakdown.

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

leveragenumber

Overall leverage ratio (deposits / nav)

Example: 2

activeLendersinteger

Number of lenders with positions

Example: 3

activeChainsinteger

Number of chains with positions

Example: 2

chains object[]

Per-chain totals. Per-lender data is fused into the top-level items array.

Array [

chainIdstring

Chain ID

Example: 1

totalDepositsUSDnumber

Total deposits on this chain in USD

Example: 20000

totalDebtUSDnumber

Total debt on this chain in USD

Example: 10000

netWorthnumber

Net worth on this chain

Example: 10000

lenderCountinteger

Number of active lenders on this chain

Example: 2

]

UserPositionResponse

{
  "items": [
    {
      "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
          }
        }
      ],
      "balanceData": {
        "deposits": 10000.5,
        "debt": 5000.25,
        "collateral": 9000,
        "collateralAllActive": 10000.5,
        "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": {}
      },
      "leverage": 2
    }
  ],
  "summary": {
    "balanceData": {
      "deposits": 10000.5,
      "debt": 5000.25,
      "collateral": 9000,
      "collateralAllActive": 10000.5,
      "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": {}
    },
    "leverage": 2,
    "activeLenders": 3,
    "activeChains": 2,
    "chains": [
      {
        "chainId": "1",
        "totalDepositsUSD": 20000,
        "totalDebtUSD": 10000,
        "netWorth": 10000,
        "lenderCount": 2
      }
    ]
  }
}