{"uid":"cap_nmaqYVdrYnD5bYbQ39Dm3","slug":"api-hyperd-ai-ab438000","name":"HyperD Liquidation Risk Checker","description":"Cross-protocol liquidation risk for a wallet's lending positions. Health factor, USD-at-risk, and recommendations across Aave V3, Compound v3, Spark Lend, and Morpho Blue. Pass ?chain=all for cross-chain aggregate.","url":"https://api.hyperd.ai/api/liquidation/risk?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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"enum":["base","ethereum","polygon","arbitrum","optimism","avalanche","bnb","all"],"type":"string","description":"Chain to check, or 'all' for cross-chain aggregate. Default 'base'."},"address":{"type":"string","description":"0x EVM wallet address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890"}}},"response":{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890","sources":["Aave V3 Pool contracts (direct on-chain reads via viem)"],"positions":[],"timestamp":"2026-06-05T23:42:05.750Z","disclaimer":"Liquidation risk is computed from current on-chain state. Prices and health factors change continuously. This is a snapshot, not a prediction. Recommendations are heuristic — verify before acting.","totalDebtUsd":0,"chainsChecked":["ethereum"],"compositeBand":"no_position","totalAtRiskUsd":0,"recommendations":[],"protocolsCovered":["aave-v3","compound-v3","spark","morpho-blue"],"protocolsTimedOut":[],"compositeRiskScore":0,"totalCollateralUsd":0,"protocolsNotCovered":[]}},"exampleRequest":{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890"},"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OGBN8LUVYoZ5fSIMHQfma","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns liquidation risk metrics — health factor, USD at risk, and recommendations — for a wallet's lending positions across Aave V3, Compound v3, Spark Lend, and Morpho Blue, with optional cross-chain aggregation.","exampleAgentPrompt":"Check my liquidation risk across all chains for wallet 0x4e5F3a8bCf8a2e1D3456789AbCdEf0123456789A — I want to see my health factor, how many dollars are at risk, and any recommendations across Aave, Compound, Spark, and Morpho.","exampleUseCases":null,"resultDescription":"Returns a structured object containing the wallet's health factor, total USD value at risk of liquidation, protocol-by-protocol breakdown of lending positions (Aave V3, Compound v3, Spark Lend, Morpho Blue), and actionable recommendations for reducing liquidation risk. When chain=all, aggregates across all supported chains.","failureModes":["Invalid or missing wallet address returns a 400 error","Unsupported chain value returns a validation error","Wallet with no lending positions returns empty or zero-risk result","Network timeouts from upstream DeFi protocols may cause partial data","Rate limiting or payment failure (402) if USDC payment not provided"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, cross-protocol liquidation risk snapshot for a DeFi wallet, especially when positions span multiple protocols (Aave, Compound, Spark, Morpho) and potentially multiple chains. Prefer this over individual protocol dashboards when you need a single aggregated health score and actionable recommendations in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:18.305Z","isFirstParty":false,"canonicalSlug":"api-hyperd-ai-ab438000"}