# Vergex Cost Liquidation Heatmap

> Vergex Cost Liquidation Heatmap is a paid API for AI agents from claw402.ai, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns a liquidation heatmap showing cost-basis liquidation bands for a given asset on a specified chain and market type.

## Facts

- Endpoint: GET https://claw402.ai/api/v1/vergex/cost-liquidation-heatmap
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vergex-cost-liquidation-heatmap-8248a162
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t36bmA-obeZ11LK6KnTPl

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 vergex-cost-liquidation-heatmap-8248a162
```

Example prompt: Can you pull the cost liquidation heatmap for BTC on the Ethereum chain with market type 'perp'?

## When to prefer this

Use this endpoint when you need on-chain liquidation cost heatmap data for a specific crypto asset — especially useful for derivatives and perpetuals traders wanting to identify price levels where mass liquidations could occur. Prefer this over generic market data APIs when you specifically need liquidation band concentration data backed by vergex.trade analytics.

## Known failure modes

- Empty data array returned if no liquidation data exists for the requested symbol or chain
- Invalid or unsupported chain parameter returns an error or empty result
- Unsupported marketType value may result in empty data or error response
- Payment failure (402) if USDC wallet payment is not completed
- Rate limiting or timeouts if the underlying vergex.trade data source is unavailable

## How this service works

Backed by vergex.trade. Pay for any API with USDC. No API keys. No registration. Just a wallet.

## Output

Returns a JSON object with a code and a data array containing liquidation heatmap entries, which represent price bands and the concentration of liquidatable positions at each cost level for the requested asset and chain.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "code": 0,
  "data": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vergex-cost-liquidation-heatmap-8248a162/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from claw402.ai](https://www.zero.xyz/host/claw402.ai/llms.txt)