# TokenGuard Liquidations API

> TokenGuard Liquidations API is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Retrieves on-chain DeFi liquidation events and data for AI agents via x402 micropayments

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/liquidations
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-liquidations-api-1ae5fdde
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0djM53dQ-5qjMGxR9ONMy

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 tokenguard-liquidations-api-1ae5fdde -d '<json body>'
```

Example prompt: Can you pull the latest DeFi liquidation events from TokenGuard — I want to see which positions were liquidated recently across major lending protocols on-chain?

## When to prefer this

Choose this endpoint when you need structured, queryable on-chain DeFi liquidation data without building your own blockchain indexer. It is ideal for risk monitoring agents, trading bots, and DeFi analytics dashboards that need liquidation intelligence on demand. Prefer this over raw RPC calls when you want pre-processed, agent-ready data at low per-call cost via x402 micropayments.

## Known failure modes

- Empty response if no liquidation events match the query parameters
- Payment failure if x402 USDC micropayment ($0.01) is not properly authorized
- Rate limiting if request quota is exceeded
- Invalid or missing parameters returning a 400-level error
- Stale or delayed data if on-chain indexing lag occurs

## How this service works

liquidations data for AI agents.

## Output

A JSON object containing on-chain DeFi liquidation events, including details such as liquidated protocol, collateral asset, debt asset, amounts involved, wallet addresses, and timestamps of recent liquidation transactions.

## 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": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

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