# Vextorium DeFi Liquidations

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

Fetches recent DeFi liquidation events across EVM networks, with breakdown by collateral asset, protocol, and total USD value liquidated over a configurable time window.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/defi-liquidations?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-defi-liquidations-23d3b243
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kTlyb6OaP6HeWxso68H6m

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-defi-liquidations-23d3b243 -d '<json body>'
```

Example prompt: Show me the DeFi liquidation activity on Ethereum and Arbitrum over the last 12 hours, broken down by collateral asset — I want to know which assets are being liquidated most and the total USD value.

## When to prefer this

Choose this endpoint when you need structured, aggregated DeFi liquidation data across major EVM networks (Base, Ethereum, Arbitrum, Optimism, Polygon) with collateral breakdowns, without having to parse raw on-chain events yourself. It is ideal for risk monitoring dashboards, market stress detection, and protocol health analysis. Prefer it over raw blockchain RPC calls when you need multi-protocol, multi-network aggregation in a single pay-per-call request.

## Known failure modes

- Invalid or unsupported network name returns an error
- Hours value outside 1–24 range returns a validation error
- Unknown or mistyped asset symbol may return empty results rather than an error
- Network outage or RPC issues may result in incomplete data
- No liquidations in the time window returns empty arrays with zero totals

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

Returns a JSON object with the protocol name, total number of liquidation events, total USD value liquidated, a breakdown of liquidated collateral by asset (with per-asset event count and USD value), and an array of recent liquidation events each containing the transaction URL, collateral and debt assets, network, and USD value.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "hours": {
   "type": "integer",
   "maximum": 24,
   "minimum": 1,
   "description": "Time window in hours (1-24)"
  },
  "symbol": {
   "type": "string",
   "description": "Optional asset filter, e.g. WETH, cbBTC, USDC"
  },
  "network": {
   "enum": [
    "base",
    "ethereum",
    "arbitrum",
    "optimism",
    "polygon"
   ],
   "type": "string",
   "description": "Network (omit for all five)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "protocol": "Aave v3",
  "num_events": 3,
  "by_collateral": [
   {
    "asset": "WETH",
    "value_usd": 1100.2,
    "num_events": 2
   }
  ],
  "recent_events": [
   {
    "tx": "https://basescan.org/tx/0x...",
    "debt": "USDC",
    "network": "base",
    "value_usd": 820.5,
    "collateral": "WETH"
   }
  ],
  "total_liquidated_usd": 1250.4
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-defi-liquidations-23d3b243/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)