{"uid":"cap_PbRHYPW-FVFpQk5D8s-0J","slug":"seneschal-at-risk-count-d917ce49","name":"Seneschal At-Risk Count","description":"Single-fact: how many borrowers have HF < max_hf and debt >= min_debt_usd right now? Returns {count, total_debt_usd}.","url":"https://api.seneschal.space/v1/q/at-risk-count","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","properties":{"max_hf":{"type":"string","description":"Health-factor ceiling (default 1.05)."},"protocol":{"type":"string","description":"Optional protocol filter (aave|morpho|spark|compound)."},"min_debt_usd":{"type":"string","description":"Minimum debt in USD (default 0)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"integer"},"total_debt_usd":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"count":14,"total_debt_usd":1825000}},"example":{"request":{"properties":"at-risk-count"},"response":{"count":3066,"max_hf":1.05,"protocol":null,"min_debt_usd":0,"total_debt_usd":78654252846003.08}},"exampleRequest":{"properties":"at-risk-count"},"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_51sWtVlls2uLLjMculQS3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current count of Ethereum positions at risk of liquidation, providing free liquidation telemetry for DeFi monitoring.","exampleAgentPrompt":"How many Ethereum DeFi positions are currently at risk of liquidation right now? Pull the latest at-risk count from Seneschal's liquidation telemetry.","exampleUseCases":[{"title":"Risk dashboard for DeFi portfolio manager","prompt":"Monitor liquidation pressure on Ethereum right now—how many positions are actually at risk of getting liquidated across the network? I need this stat to assess overall market health before making any moves."},{"title":"Alert system for lending protocol operators","prompt":"What's the current count of at-risk DeFi positions on Ethereum mainnet? Set up alerts so I know whenever this number spikes above a certain threshold overnight."},{"title":"Real-time data feed for trading desk","prompt":"Give me a live snapshot of how many Ethereum borrowing positions are underwater or close to liquidation. I want to track this metric every few minutes to spot emerging systemic risk."}],"resultDescription":"A count or snapshot of Ethereum mainnet positions currently at risk of liquidation, drawn from Seneschal's block-builder-level telemetry data.","failureModes":["Invalid or malformed query properties parameter returns error","Service unavailable if block builder telemetry feed is down","Payment required (402) if x402 USDC balance is insufficient","Rate limiting if called too frequently without payment"],"whenToPreferThis":"Use this endpoint when you need a real-time count of at-risk Ethereum liquidation positions sourced from a block builder with privileged mempool visibility. Prefer it over generic DeFi analytics when you need low-latency, block-builder-level data at very low per-call cost ($0.001 USDC).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:44:12.696Z","isFirstParty":false}