# BlockRun Whale Liquidation Orders

> BlockRun Whale Liquidation Orders is a paid API for AI agents from blockrun.ai, paid per call via x402, $0.0085/call, status unknown (last checked 2026-09-14).

Fetches large liquidation orders (whale liquidations) from crypto derivatives markets in real time.

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/surf/market/liquidation/order
- Price: $0.0085/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-whale-liquidation-orders-34e35f77
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OD9sCFGBGb2AY7-iMQjxc

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 blockrun-whale-liquidation-orders-34e35f77
```

Example prompt: Show me the largest liquidation orders happening right now in crypto markets — I want to see which whale positions are getting wiped out.

## When to prefer this

Use this endpoint when you need real-time data on large (whale-scale) forced liquidations in crypto derivatives markets, particularly for trading signals, market sentiment analysis, or monitoring systemic risk events. Prefer over general market data APIs when the specific focus is on large liquidation cascades.

## Known failure modes

- No liquidation data available if markets are quiet or no large liquidations have occurred recently
- Rate limiting or payment failure if USDC balance is insufficient for the $0.0075 per call fee
- Empty data set if no whale-sized liquidations meet the threshold at query time
- API timeout if upstream market data source is unavailable

## How this service works

Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.

## Output

Returns a list of large liquidation orders from crypto derivatives markets, including details such as asset, liquidation size, direction (long/short), exchange, and timestamp of the forced liquidations.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockrun-whale-liquidation-orders-34e35f77/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blockrun.ai](https://www.zero.xyz/host/blockrun.ai/llms.txt)