# SperaxOS getLiquidationsByProtocol

> SperaxOS getLiquidationsByProtocol is a paid API for AI agents from chat.sperax.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-12).

Returns liquidation events and data for a specified DeFi lending protocol (e.g. Aave v3, Compound v3, Maker)

## Facts

- Endpoint: POST https://chat.sperax.io/api/x402/tools/liquidations/getLiquidationsByProtocol?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-getliquidationsbyprotocol-e25dd774
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LOibSDOTzzQPHQrcPLYMU

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 speraxos-getliquidationsbyprotocol-e25dd774 -d '<json body>'
```

Example prompt: Pull the latest liquidation events for Aave v3 from SperaxOS — I want to see which positions got wiped and what collateral was involved.

## When to prefer this

Use this endpoint when you need on-demand, AI-powered liquidation data for a specific DeFi lending protocol without managing API keys. Ideal for agents that pay per request with USDC on Base via x402, and need protocol-specific liquidation intelligence rather than broad market data. Prefer this over generic blockchain explorers when you want structured, ready-to-use DeFi liquidation records for Aave, Compound, Maker, or similar protocols.

## Known failure modes

- Unknown or unsupported protocol name returns empty results or error
- Payment via x402/USDC fails if wallet has insufficient funds
- Protocol name typo or wrong format (e.g. 'aavev3' instead of 'aave-v3') may return no results
- Network or upstream data provider outage causes timeout
- Rate limiting or payment verification failure

## How this service works

AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.

## Output

A list of liquidation events for the specified DeFi protocol, likely including liquidated positions, collateral types, liquidation amounts, borrower and liquidator addresses, and timestamps of each liquidation event.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "protocol": {
   "type": "string",
   "description": "Protocol name (e.g. \"aave-v3\", \"compound-v3\", \"maker\")"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-getliquidationsbyprotocol-e25dd774/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chat.sperax.io](https://www.zero.xyz/host/chat.sperax.io/llms.txt)