{"uid":"cap__yKU9m0Fur6DzMLTlAoT2","slug":"lending-liquidations-4747010a","name":"lending-liquidations","description":"On-chain DeFi liquidation telemetry for Base lending protocols: recent LiquidationCall events decoded by us from public Base event logs — count, total debt repaid and collateral seized (USD), estimated liquidation bonus, per-protocol and per-asset breakdown, and the recent events (user, liquidator, collateral, debt).","url":"https://payai.agentstools.dev/lending/liquidations","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":[],"properties":{"window":{"type":"string","description":"Look-back window, e.g. 1h / 6h / 12h (default 6h, max ~12h)"},"protocol":{"enum":["aave-v3"],"type":"string","description":"Lending protocol to scan (default all sources)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gO4rFvcJB0Zw2tsK2KqYP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns on-chain DeFi liquidation telemetry for Base lending protocols, including recent LiquidationCall event counts, USD values of debt repaid and collateral seized, estimated liquidation bonuses, and per-protocol/per-asset breakdowns.","exampleAgentPrompt":"Can you pull the latest liquidation telemetry from Base lending protocols — I want to see how many LiquidationCall events happened in the last 6 hours on Aave v3, including total debt repaid, collateral seized, and any recent individual events?","exampleUseCases":[{"title":"DeFi risk desk liquidation monitor","prompt":"Show me all liquidation activity on Base lending markets over the last 12 hours — I need the total debt repaid, collateral seized in USD, and the estimated liquidation bonuses earned."},{"title":"Aave v3 protocol health check","prompt":"Pull the recent liquidation events for Aave v3 on Base from the last hour — I want to see which users got liquidated, who the liquidators were, and what collateral and debt assets were involved."},{"title":"Per-asset liquidation breakdown analysis","prompt":"Give me a breakdown of which assets are being liquidated the most on Base DeFi protocols right now — show me the per-asset collateral seized and debt repaid figures for the default 6-hour window."}],"resultDescription":"Returns a structured object with: total count of LiquidationCall events in the requested window, aggregate USD values of debt repaid and collateral seized, estimated liquidation bonus percentage, per-protocol and per-asset breakdowns of those figures, and a list of recent individual liquidation events each containing the affected user address, liquidator address, collateral asset, and debt asset.","failureModes":["Invalid window parameter format (e.g. '2d' exceeding max ~12h) returns an error","Unsupported protocol value (only 'aave-v3' is a valid enum) returns validation error","On-chain data indexing lag may cause recent events (last few minutes) to be missing","No liquidation events in window returns zero counts but still succeeds","Network outage or RPC failure on Base may result in stale or incomplete data"],"whenToPreferThis":"Use this endpoint when you need decoded, aggregated DeFi liquidation telemetry specifically for Base network lending protocols without running your own event log decoder. It is ideal for real-time risk monitoring, protocol health dashboards, or alerting workflows where you need USD-normalized figures and per-asset/per-protocol breakdowns in a single call. Prefer this over raw RPC calls when you want pre-decoded LiquidationCall events with USD valuation and bonus estimation already computed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:33.804Z","isFirstParty":false}