# 4SEC Liquidation Heatmap API

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

Returns real-time liquidation cluster data and cascade risk assessment for a given crypto trading symbol across multiple DEXes.

## Facts

- Endpoint: GET https://api.foursec.xyz/liquidation/heatmap/%7Bsymbol%7D
- Price: $0.05/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/4sec-liquidation-heatmap-api-06af4ce8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_w79vu5CcOI0ZVs3ce0-o6

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-liquidation-heatmap-api-06af4ce8
```

Example prompt: Show me the liquidation heatmap and cascade risk for BTC — I want to see where the major liquidation clusters are sitting right now.

## When to prefer this

Choose this endpoint when you need real-time, multi-DEX aggregated liquidation heatmap data for a specific crypto asset, particularly when assessing cascade liquidation risk before entering or exiting a leveraged position. Prefer this over generic price feeds when liquidation cluster density and cascade risk are the primary concern. The pay-per-request x402 model makes it suitable for on-demand queries without subscription overhead.

## Known failure modes

- Invalid or unsupported symbol returns an error or empty response
- Payment failure via x402/USDC results in 402 Payment Required
- Symbol path parameter missing causes a 404 or 400 error
- Network latency or DEX data feed delays may result in stale data
- Rate limiting if too many requests are sent in quick succession

## 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 the queried symbol, the current market price, a cascade_risk classification string (e.g. low/medium/high), and an array of liquidation_clusters representing price levels where leveraged positions are concentrated and at risk of being liquidated.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "example": {
  "symbol": {
   "type": "string"
  },
  "cascade_risk": {
   "type": "string"
  },
  "current_price": {
   "type": "number"
  },
  "liquidation_clusters": {
   "type": "array"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/4sec-liquidation-heatmap-api-06af4ce8/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)