# ByKaranteli Bulk Liquidations & Derivatives Data

> ByKaranteli Bulk Liquidations & Derivatives Data is a paid API for AI agents from bykaranteli.com, paid per call via x402, $15/call, status unknown (last checked 2026-09-14).

Returns a bulk dataset of crypto derivatives metrics including multi-venue liquidation models, real liquidation prints, funding rates, open interest, options gamma, ETF flows, and CFTC positioning.

## Facts

- Endpoint: GET https://bykaranteli.com/api/x402/bulk-liquidations
- Price: $15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bykaranteli-bulk-liquidations-derivatives-data-9938eab3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cP967cXA80IGs_sAQP2en

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 bykaranteli-bulk-liquidations-derivatives-data-9938eab3
```

Example prompt: Pull me the latest bulk liquidations dataset from ByKaranteli — I want the cross-venue liquidation model, funding rates, open interest, and CFTC positioning all in one shot.

## When to prefer this

Choose this endpoint when you need a comprehensive, pre-aggregated derivatives dataset covering multiple venues (Binance, Bybit, OKX, Gate, etc.) in a single call, especially when you need liquidation model data alongside funding rates, open interest, gamma, ETF flows, and CFTC positioning together. Prefer it over individual venue APIs or piecemeal data sources when building dashboards, running quantitative analysis, or assessing market-wide liquidation risk without stitching together multiple feeds.

## Known failure modes

- Payment not received or invalid x402 payment header — returns 402 Payment Required
- Invalid or malformed properties filter parameter — may return empty rows array
- Rate limiting or service unavailability — returns non-ok response
- Stale data if upstream exchange sockets are temporarily disconnected

## How this service works

Six-venue liquidation model with real liquidation prints overlaid, funding rates, open interest, options gamma, ETF flows and CFTC positioning. Free.

## Output

Returns a JSON object with ok: true, a count of rows (up to 500), a dataset label ('bulk-liquidations'), and a rows array containing multi-venue liquidation model data, real liquidation prints, funding rates, open interest, options gamma, ETF flows, and CFTC Commitments of Traders positioning data.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "rows": [],
  "count": 500,
  "dataset": "bulk-liquidations"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bykaranteli-bulk-liquidations-derivatives-data-9938eab3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bykaranteli.com](https://www.zero.xyz/host/bykaranteli.com/llms.txt)