# lending-liquidations

> lending-liquidations is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: GET https://payai.agentstools.dev/lending/liquidations
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lending-liquidations-4747010a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__yKU9m0Fur6DzMLTlAoT2

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 lending-liquidations-4747010a
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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).

## Output

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.

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lending-liquidations-4747010a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)