# Seneschal DeFi Liquidation Opportunities

> Seneschal DeFi Liquidation Opportunities is a paid API for AI agents from api.seneschal.space, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

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.

## Facts

- Endpoint: GET https://api.seneschal.space/v1/premium/opportunities
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-seneschal-space-df1bc360
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AjXpFpsiOThD4JZN_1ndz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-seneschal-space-df1bc360
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-seneschal-space-df1bc360/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.seneschal.space](https://www.zero.xyz/host/api.seneschal.space/llms.txt)