> ## Documentation Index > Fetch the complete documentation index at: https://docs.defiorbit.xyz/llms.txt > Use this file to discover all available pages before exploring further. # List Aave V3 Positions > Live Aave V3 lending/borrowing positions for a wallet from the lending indexer, one entry per chain, with calculations. Optional `market_id` and `target_health_factor` (default 1.5). **Credits:** 15 per matching wallet/chain result, before pagination. ## OpenAPI ````yaml /openapi.yaml get /v1/lending/aavev3 openapi: 3.1.0 info: title: DeFi Orbit API version: 1.0.0 description: Public REST API for DeFi Orbit positions, lending, portfolio, and usage. servers: - url: https://api.defiorbit.xyz security: - bearerAuth: [] tags: - name: Portfolio - name: Snapshots - name: Uniswap V3 - name: Aerodrome V3 - name: Orca - name: Aave V3 - name: Morpho - name: Kamino - name: Usage paths: /v1/lending/aavev3: get: tags: - Aave V3 summary: List Aave V3 Positions description: >- Live Aave V3 lending/borrowing positions for a wallet from the lending indexer, one entry per chain, with calculations. Optional `market_id` and `target_health_factor` (default 1.5). **Credits:** 15 per matching wallet/chain result, before pagination. operationId: get_v1_lending_aavev3 parameters: - name: wallet in: query required: true schema: type: string description: Wallet address. example: '0xbf7620d0377b0660a6cbaef5cdfe2e00eddc1495' x-default: '0xbf7620d0377b0660a6cbaef5cdfe2e00eddc1495' - name: market_id in: query required: false schema: type: string enum: - main - lido - horizon description: 'Omit for all markets. Values: `main`, `lido`, `horizon`.' - name: target_health_factor in: query required: false schema: type: number description: 'Target health factor. Default: 1.5.' default: 1.5 - name: chain_id in: query required: false schema: type: integer description: Chain ID. - name: page in: query required: false schema: type: integer description: 'Page. Default: 1.' default: 1 - name: limit in: query required: false schema: type: integer description: 'Maximum 25. Default: 10.' default: 10 maximum: 25 responses: '200': description: Successful response content: application/json: schema: allOf: - $ref: '#/components/schemas/RequestId' - type: object properties: data: type: array items: type: object properties: chain_id: type: integer wallet: type: string positions: type: array items: type: object properties: marketId: type: string healthFactor: type: string description: >- String. Aave divides liquidation-threshold-weighted collateral by debt. Morpho divides collateral × oracle price × LLTV by debt, to four decimals. Kamino divides liquidation LTV by LTV. MAX or ∞ when there is no debt. totalCollateralUSD: type: string totalDebtUSD: type: string netWorthUSD: type: string suppliedAssets: type: array items: type: object properties: symbol: type: string amountSuppliedUSD: type: string supplyAPY: type: string isCollateral: type: boolean required: - symbol - amountSuppliedUSD - supplyAPY - isCollateral borrowedAssets: type: array items: type: object properties: symbol: type: string amountBorrowedUSD: type: string borrowAPY: type: string required: - symbol - amountBorrowedUSD - borrowAPY required: - marketId - healthFactor - totalCollateralUSD - totalDebtUSD - netWorthUSD - suppliedAssets - borrowedAssets calculations: type: array items: type: object properties: targetHealthFactor: type: number description: >- Health factor used for safe-borrow and safe-withdraw figures. Default 1.5. healthFactor: type: string description: >- String. Aave divides liquidation-threshold-weighted collateral by debt. Morpho divides collateral × oracle price × LLTV by debt, to four decimals. Kamino divides liquidation LTV by LTV. MAX or ∞ when there is no debt. dailySupplyInterestUSD: type: string dailyBorrowInterestUSD: type: string netDailyInterestUSD: type: string safeBorrowAmountUSD: type: string safeWithdrawAmountUSD: type: string currentLtvPercentage: type: string netAPY: type: string positionLeverage: type: string weightedSupplyAPY: type: string weightedBorrowAPY: type: string borrowUtilizationRate: type: string required: - targetHealthFactor - healthFactor - dailySupplyInterestUSD - dailyBorrowInterestUSD - netDailyInterestUSD - safeBorrowAmountUSD - safeWithdrawAmountUSD - currentLtvPercentage - netAPY - positionLeverage - weightedSupplyAPY - weightedBorrowAPY - borrowUtilizationRate required: - chain_id - wallet - positions - calculations pagination: $ref: '#/components/schemas/Pagination' required: - data - pagination example: data: - chain_id: 8453 wallet: '0xbf7620d0377b0660a6cbaef5cdfe2e00eddc1495' positions: - marketId: main healthFactor: '1.42' totalCollateralUSD: '5085.89' totalDebtUSD: '2854.38' netWorthUSD: '2231.51' suppliedAssets: - symbol: WETH amountSuppliedUSD: '1706.67' supplyAPY: '1.63' isCollateral: true borrowedAssets: - symbol: USDC amountBorrowedUSD: '2854.38' borrowAPY: '4.48' calculations: - targetHealthFactor: 1.5 healthFactor: '1.42' dailySupplyInterestUSD: '0.08' dailyBorrowInterestUSD: '0.35' netDailyInterestUSD: '-0.27' safeBorrowAmountUSD: '200.00' safeWithdrawAmountUSD: '500.00' currentLtvPercentage: '56.12' netAPY: '-4.47' positionLeverage: '1.28' weightedSupplyAPY: '1.63' weightedBorrowAPY: '4.48' borrowUtilizationRate: '74.24' pagination: page: 1 limit: 10 total: 1 next_page: null prev_page: null request_id: req_... '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalError' components: schemas: RequestId: type: object required: - request_id properties: request_id: type: string description: Id to quote when you contact support. Pagination: type: object required: - page - limit - total - next_page - prev_page properties: page: type: integer limit: type: integer total: type: integer description: Matching rows, before this page is sliced. next_page: type: string nullable: true description: URL of the next page, or null on the last page. prev_page: type: string nullable: true description: URL of the previous page, or null on the first page. Error: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string message: type: string request_id: type: string responses: BadRequest: description: Missing or invalid parameter. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INVALID_PARAMETER message: page must be a positive integer. request_id: req_... Unauthorized: description: Missing, malformed, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INVALID_API_KEY message: Missing API key. request_id: req_... PaymentRequired: description: The organization does not have enough credits. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: Insufficient API credits. request_id: req_... Forbidden: description: The organization is suspended, or the endpoint or feature is disabled. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: ACCOUNT_SUSPENDED message: This organization is suspended. request_id: req_... TooManyRequests: description: The organization exceeded its requests-per-second limit. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer X-RateLimit-Limit: description: Requests per second for the organization. schema: type: integer X-RateLimit-Remaining: description: Requests left in the current window. schema: type: integer X-RateLimit-Reset: description: Unix time when the window resets. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMIT_EXCEEDED message: Rate limit exceeded. Please try again later. request_id: req_... InternalError: description: Unexpected server error, or pricing is not configured. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INTERNAL_ERROR message: An unexpected error occurred. request_id: req_... securitySchemes: bearerAuth: type: http scheme: bearer description: >- Paste your API key from the [dashboard](https://platform.defiorbit.xyz/dashboard/keys). The key starts with `do_sk_`. x-default: YOUR_API_KEY ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.