{"uid":"cap_apIu2GZRmlCcMlhWRdmHg","slug":"aave-health-factor-68e5b689","name":"Aave Health Factor","description":"Aave V3 position of any wallet: collateral, debt and remaining borrowing power in USD, LTV, liquidation threshold, health factor and how far collateral can fall before liquidation. Use for liquidation alerts.","url":"https://bess-x402.onrender.com/v1/defi/aave-health?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"ethereum, base, arbitrum, optimism or polygon"},"address":{"type":"string","description":"Wallet address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ufbgg4ueXTRkKW_0zNmFB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the Aave V3 DeFi position for any wallet: collateral, debt, LTV, liquidation threshold, health factor, and how far collateral can fall before liquidation.","exampleAgentPrompt":"What's the current Aave V3 health factor and liquidation risk for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum — how much collateral do they have, what's their debt, and how far can the collateral fall before liquidation?","exampleUseCases":[{"title":"Liquidation alert for a personal wallet","prompt":"Set up a check on my Aave V3 position at 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B on Arbitrum — tell me my current health factor and how much my collateral can drop before I get liquidated."},{"title":"Risk assessment for a DeFi portfolio tracker","prompt":"Pull the Aave V3 position details for 0x1234567890abcdef1234567890abcdef12345678 on Base: I need the collateral value, total debt, LTV, and health factor so I can flag any accounts close to liquidation."},{"title":"Borrowing capacity check before taking a loan","prompt":"Before I borrow more on Aave, can you check my remaining borrowing power and current health factor for wallet 0xDeaDbeefdEAdbeefdEadbEEFdeadbeEFdEaDbeeF on Polygon?"}],"resultDescription":"Returns a structured JSON object with the wallet's total collateral in USD, total debt in USD, available borrowing power in USD, current loan-to-value ratio, liquidation threshold, health factor (a ratio where values below 1.0 trigger liquidation), and the percentage drop in collateral value that would cause liquidation.","failureModes":["Invalid or malformed wallet address returns a 400 error","Unsupported chain name returns an error — only ethereum, base, arbitrum, optimism, polygon are valid","Wallet with no Aave V3 position returns zeroed-out values or a 404","RPC node outage on the target chain may cause a 503 or timeout","Missing required 'address' query parameter returns a validation error","x402 payment failure or insufficient USDC balance results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need real-time Aave V3 position data (health factor, collateral, debt, LTV) for a specific wallet across major EVM chains. Ideal for liquidation monitoring agents, DeFi risk dashboards, or pre-borrow safety checks. Prefer this over on-chain RPC calls directly when you want a single structured response without writing Solidity ABI queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:42.930Z","isFirstParty":false,"canonicalSlug":"aave-health-factor-68e5b689"}