{"uid":"cap_AjXpFpsiOThD4JZN_1ndz","slug":"api-seneschal-space-df1bc360","name":"Seneschal DeFi Liquidation Opportunities","description":"Top at-risk borrowers across Aave + Morpho + Spark with realised market success-rate, average actual profit-USD, and the builder most likely to land each market. Sorted by expected EV. Pure SQL, no live RPC.","url":"https://api.seneschal.space/v1/premium/opportunities","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"as_of_ms":1765532000000,"opportunities":[{"hf":0.98,"addr":"0x1234…","debt_usd":125000,"protocol":"aave","likely_builder":"titan","expected_value_usd":310.5}]}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"_truncated":true,"_originalSize":128530}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.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_mB_dluLvpn33OVxnIJqCr","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 top at-risk borrowers across Aave, Morpho, and Spark ranked by expected value, including realized market success rate, average actual profit in USD, and the most likely winning builder for each position.","exampleAgentPrompt":"Show me the top at-risk borrowers across Aave, Morpho, and Spark right now — ranked by expected liquidation profit — including the historical success rate, average actual USD profit, and which builder is most likely to land each one.","exampleUseCases":[{"title":"Pre-trade liquidation opportunity research","prompt":"Before I fire up my liquidation bot, pull me the highest EV borrower positions across Aave, Morpho, and Spark — I want to see historical success rates and average USD profit so I know which ones are actually worth targeting."},{"title":"Builder competition intelligence for searchers","prompt":"Which builders have been winning the most liquidations on Aave and Morpho lately? Show me the top at-risk positions right now alongside which builder is most likely to land each one, so I can decide where to focus my strategy."},{"title":"Spark undercollateralized position ranking","prompt":"Give me a ranked list of the most undercollateralized borrowers on Spark today, sorted by expected profit, with the realized success rate and average actual payout baked in so I can prioritize which positions to watch."}],"resultDescription":"A ranked list of at-risk borrower positions across Aave, Morpho, and Spark, each annotated with: expected EV score, realized market success rate (historical), average actual profit in USD, and the builder most likely to win that liquidation opportunity. Data is derived from pure SQL analytics with no live RPC calls.","failureModes":["Stale data if underlying SQL snapshot is outdated — no live RPC means positions may have shifted","Empty result set if no borrowers currently meet at-risk thresholds","Payment failure (402) if x402 USDC payment not included or insufficient","Rate limiting if too many calls in rapid succession","Schema mismatch if caller expects live on-chain state rather than SQL-derived analytics"],"whenToPreferThis":"Choose this endpoint when you need a pre-ranked, analytics-driven view of liquidation opportunities across the three major DeFi lending protocols (Aave, Morpho, Spark) with historical profitability context. Prefer it over live RPC alternatives when you want EV-sorted opportunities with builder competition intelligence baked in, and don't need millisecond-fresh on-chain state. Ideal for searchers and liquidation bots doing pre-trade research rather than execution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:39:21.285Z","isFirstParty":false}