{"uid":"cap_nltjhP8diz7RdbuWI-pkp","slug":"defi-oracle-liquidation-risk-calculator-a6f61cc4","name":"DeFi Oracle Liquidation Risk Calculator","description":"DeFi data for AI agents — yield rates, swap routes, IL calculator, liquidation risk, MEV scanner, TVL tracking. Powered by DeFiLlama + on-chain RPC data. Pay with USDC on Base via x402.","url":"https://oraclius.vercel.app/api/liquidation-risk","method":"POST","headers":{},"bodySchema":{"type":"object","required":["borrow_token","collateral_token"],"properties":{"borrow_token":{"type":"string"},"collateral_token":{"type":"string"},"borrow_amount_usd":{"type":"number"},"collateral_value_usd":{"type":"number"},"liquidation_threshold":{"type":"number"}}},"responseSchema":{"type":"object","properties":{"chain":{"type":"string"},"borrow":{"type":"string"},"position":{"type":"object"},"collateral":{"type":"string"},"risk_level":{"type":"string"},"liquidation":{"type":"object"},"recommendations":{"type":"array","items":{"type":"string"}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XXEdchMEslAFEsVKfkvtZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates liquidation risk for a DeFi lending/borrowing position given collateral and borrow token details, returning risk level and recommendations","exampleAgentPrompt":"What's my liquidation risk if I borrow $5000 USDC using $8000 worth of ETH as collateral, with a liquidation threshold of 0.8?","exampleUseCases":null,"resultDescription":"Returns the chain, borrow and collateral token symbols, a structured position object, a risk_level string (e.g. low/medium/high/critical), a liquidation object with price thresholds and health factor details, and an array of actionable recommendations to reduce risk.","failureModes":["Missing required borrow_token or collateral_token returns 400 validation error","Unknown or unsupported token symbols may return empty or null price data","If on-chain RPC data is unavailable the endpoint may return stale or error response","Extremely illiquid token pairs may lack price feeds resulting in incomplete liquidation calculation","Payment failure via x402/USDC on Base will block access with 402 response"],"whenToPreferThis":"Use this endpoint when an AI agent needs to evaluate whether a specific DeFi lending position is safe or at risk of liquidation — particularly when the agent has position details like collateral value, borrow amount, and token pair. Prefer this over generic DeFi data APIs when you need actionable risk recommendations and liquidation price thresholds in a single call. Powered by DeFiLlama and live on-chain data, making it more reliable than purely off-chain estimates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:34.075Z","isFirstParty":false}