# 4SEC Recent Liquidations API

> 4SEC Recent Liquidations API is a paid API for AI agents from api.foursec.xyz, paid per call via x402, $0.03/call, status down (last checked 2026-09-15).

Returns recent crypto liquidation events aggregated across multiple exchanges, including total USD value, count, and long-vs-short breakdown

## Facts

- Endpoint: GET https://api.foursec.xyz/liquidation/recent
- Price: $0.03/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/4sec-recent-liquidations-api-cffcc0db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tZXNEZrbl7qFICljWp2AO

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 4sec-recent-liquidations-api-cffcc0db
```

Example prompt: Pull the most recent crypto liquidation events and tell me the total USD value liquidated, how many liquidations happened, and whether longs or shorts got hit harder.

## When to prefer this

Choose this endpoint when you need a quick, aggregated snapshot of recent liquidation activity across multiple crypto exchanges in a single call, especially when you want long-vs-short breakdown and total USD value without building your own aggregation. Prefer this over individual exchange APIs when breadth of coverage matters more than depth on a single venue. Best suited for real-time monitoring, trading signal detection, or dashboards that need cross-market liquidation summaries.

## Known failure modes

- Payment failure: 402 response if USDC payment on Base is not provided or insufficient
- No data returned if there are no recent liquidation events in the window
- Rate limiting or service unavailability returning 5xx errors
- Malformed response if underlying exchange data feeds are disrupted

## How this service works

Real-time multi-DEX aggregated crypto market data. Pay per request with USDC on Base via x402 protocol.

## Output

Returns a JSON object containing an array of recent liquidation events (each with details about the liquidation), a long_vs_short breakdown object, the total USD value of all recent liquidations as a number, and the total count of liquidation events as an integer.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "example": {
  "data": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "long_vs_short": {
   "type": "object"
  },
  "total_value_usd": {
   "type": "number"
  },
  "total_liquidations": {
   "type": "integer"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/4sec-recent-liquidations-api-cffcc0db/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.foursec.xyz](https://www.zero.xyz/host/api.foursec.xyz/llms.txt)