# Coinglass Liquidation Events Snapshot

> Coinglass Liquidation Events Snapshot is a paid API for AI agents from api.ssh.autos, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-14).

Fetches the latest crypto liquidation events from Coinglass, filtered by symbol, exchange, and minimum USD value, returning up to 10 results.

## Facts

- Endpoint: POST https://api.ssh.autos/v1/crypto/coinglass/liquidations?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coinglass-liquidation-events-snapshot-c1447b13
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Fsjen-D905am8YKcAlsGc

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 coinglass-liquidation-events-snapshot-c1447b13 -d '<json body>'
```

Example prompt: Pull the latest Coinglass liquidation events for BTC and ETH on Binance and Bybit, only show me liquidations above $50,000, and return up to 10 results.

## When to prefer this

Use this endpoint when you need a quick, real-time snapshot of recent crypto liquidation events filtered by specific assets and exchanges. It is ideal for monitoring forced position closures in derivatives markets without building your own Coinglass scraper. Prefer this over general market data APIs when you specifically need liquidation data with USD-size filtering. Best for reactive monitoring, alerting, or feeding into trading signal pipelines.

## Known failure modes

- No matching liquidation events found (empty records array with succeeded_empty status)
- Invalid symbol or exchange string causing no results
- Exceeding maxItems limit on symbols or exchanges arrays (max 3 each)
- minUsd value out of allowed range (0–1,000,000,000)
- Payment failure via x402 protocol returning 402 error
- API timeout or upstream Coinglass data unavailability

## How this service works

Live web and public-record data: marketplaces, real estate, social media, job listings, company registries and government tenders. Pay per call in USDC over x402 with no account, subscribe on the Apify Store, or buy a finished, sourced report.

## Output

Returns a JSON object with a 'records' array containing up to 10 liquidation event entries (symbol, exchange, amount in USD, direction, timestamp, etc.) and a 'summary' object with status and record count. If no results match, records is empty and status is 'succeeded_empty'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "minUsd": {
   "type": "number",
   "title": "Minusd",
   "default": 0,
   "maximum": 1000000000,
   "minimum": 0
  },
  "symbols": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "Symbols",
   "maxItems": 3
  },
  "exchanges": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "Exchanges",
   "maxItems": 3
  },
  "maxResults": {
   "type": "integer",
   "title": "Maxresults",
   "default": 10,
   "maximum": 10,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "records": [],
  "summary": {
   "status": "succeeded_empty",
   "records": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coinglass-liquidation-events-snapshot-c1447b13/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ssh.autos](https://www.zero.xyz/host/api.ssh.autos/llms.txt)
