# Vextorium Aave v3 DeFi Liquidations

> Vextorium Aave v3 DeFi Liquidations is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-01).

Returns on-chain Aave v3 liquidation data across Base, Ethereum, Arbitrum, Optimism, and Polygon for a given time window, including total USD liquidated, event counts, breakdowns by network/collateral/debt asset, and recent liquidation events with explorer links.

## Facts

- Endpoint: POST https://api.vextorium.com/liquidaciones-pago?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-aave-v3-defi-liquidations-05cffa94
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0Wdw3yZzQo1-rb7NdeMYm

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 vextorium-aave-v3-defi-liquidations-05cffa94 -d '<json body>'
```

Example prompt: Pull Aave v3 liquidation stats for all chains over the last 12 hours and break it down by network and collateral asset — I want to see total USD liquidated and the most recent events with their transaction links.

## When to prefer this

Use this endpoint when you need real-time or near-real-time Aave v3 liquidation data directly read from on-chain events across multiple EVM networks. Prefer it over general DeFi dashboards when you need programmatic access to liquidation breakdowns by collateral/debt asset and network, or when building liquidation monitoring workflows for agents. It is particularly useful when filtering by a specific asset like WETH or cbBTC across one or all supported chains.

## Known failure modes

- Invalid time window (horas outside 1-24 range) returns a validation error
- Unknown asset symbol filter (simbolo) may return zero results rather than an error
- Network enum value typo returns a schema validation error
- On-chain RPC issues for a specific network may result in partial data with a warning field (aviso)
- No liquidations in the selected window returns zero counts and empty arrays

## How this service works

DeFi liquidations read on-chain from Aave v3 on Base, Ethereum, Arbitrum, Optimism and Polygon: total USD liquidated, event count, breakdown by network, collateral and debt asset, and latest events with explorer links. Window 1-24h, optional asset filter.

## Output

Returns a JSON object with total USD liquidated, total event count, a per-network breakdown (USD and event count per chain), a collateral asset breakdown, a debt asset breakdown, a list of recent liquidation events (each with explorer URL, assets, and USD value), the time window used, coverage start timestamps per network, the applied asset filter if any, and metadata fields like protocol name and data source.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [],
     "properties": {
      "red": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon"
       ],
       "type": "string",
       "description": "Network (omit for all five)"
      },
      "horas": {
       "type": "integer",
       "maximum": 24,
       "minimum": 1,
       "description": "Time window in hours (1-24)"
      },
      "simbolo": {
       "type": "string",
       "description": "Optional asset filter, e.g. WETH, cbBTC, USDC"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "nota": {
       "type": [
        "string",
        "null"
       ]
      },
      "aviso": {
       "type": [
        "string",
        "null"
       ]
      },
      "redes": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "string",
         "null"
        ]
       }
      },
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "por_red": {
       "type": [
        "object",
        "null"
       ],
       "description": "Totals per network",
       "additionalProperties": {
        "type": "object",
        "properties": {
         "valor_usd": {
          "type": "number"
         },
         "num_eventos": {
          "type": "integer"
         }
        }
       }
      },
      "por_deuda": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "activo": {
          "type": "string"
         },
         "valor_usd": {
          "type": "number"
         },
         "num_eventos": {
          "type": "integer"
         }
        }
       }
      },
      "protocolo": {
       "t
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "protocolo": "Aave v3",
  "num_eventos": 3,
  "por_colateral": [
   {
    "activo": "WETH",
    "valor_usd": 1100.2,
    "num_eventos": 2
   }
  ],
  "eventos_recientes": [
   {
    "tx": "https://basescan.org/tx/0x...",
    "red": "base",
    "deuda": "USDC",
    "colateral": "WETH",
    "valor_usd": 820.5
   }
  ],
  "total_liquidado_usd": 1250.4
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-aave-v3-defi-liquidations-05cffa94/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)