---
title: WGO Liquidation Endpoints
description: BTC and ETH realized liquidation history and sampled potential liquidation zones.
---

# Liquidation endpoints

## Realized liquidations

```text
GET /api/wgo/v1/derivatives/{asset}/liquidations
```

Returns already-realized long and short liquidations, newest bucket first.

| Parameter | Required | Values | Default |
| --- | --- | --- | --- |
| `asset` | yes | `BTC`, `ETH` | — |
| `interval` | no | `1h`, `1d` | `1h` |
| `limit` | no | `1`–`2000` | `168` |

```bash
curl -H "Authorization: Bearer $MOBIUSQUANT_TOKEN" \
  "https://api.mobiusquant.ai/api/wgo/v1/derivatives/BTC/liquidations?interval=1h&limit=24"
```

```json
{
  "asset": "BTC",
  "interval": "1h",
  "count": 1,
  "data": [
    {
      "asset": "BTC",
      "interval": "1h",
      "bucket_start": "2026-08-23T16:00:00+00:00",
      "long_liquidation_usd": "120000.25",
      "short_liquidation_usd": "80000.50",
      "total_liquidation_usd": "200000.75"
    }
  ]
}
```

`bucket_start` is UTC. Amount fields are decimal strings denominated in USD.

## Potential liquidation zones

```text
GET /api/wgo/v1/derivatives/{asset}/liquidation-map
```

Returns the latest estimate derived from a sampled set of publicly visible positions.
It takes no query parameters.

```json
{
  "asset": "BTC",
  "snapshot": {
    "asset": "BTC",
    "snapshot_at": "2026-08-23T16:00:00+00:00",
    "mark_price": "117000",
    "open_interest_native": "12345.67",
    "coverage": {
      "account_value_threshold_usd": "0",
      "position_notional_threshold_usd": "0",
      "bucket_width_bps": 25,
      "max_distance_bps": 5000,
      "leaderboard_accounts": 43525,
      "selected_accounts": 2500,
      "scanned_accounts": 2489,
      "failed_accounts": 11,
      "positions_seen": 742,
      "positions_included": 86
    },
    "long_notional_usd": "154665100",
    "short_notional_usd": "73527648",
    "buckets": [
      {
        "side": "long",
        "price_low": "108225",
        "price_high": "108517.5",
        "liquidation_notional_usd": "42000000",
        "position_count": 3,
        "distance_bps": "737.18"
      }
    ]
  }
}
```

`distance_bps` is the absolute distance from the snapshot mark price. A `long` bucket
is below the mark price and a `short` bucket is above it. When no snapshot exists,
`snapshot` is `null`.

::: warning Sample estimate, not a full-market map
The response covers valid positions found in the current scan population. Fixed
account-value and per-position notional filters are disabled; the zero values in
`coverage` document that behavior. It is not a complete liquidation order book or
a guaranteed liquidation price.
Position changes, added collateral, and market moves can change the result.
Always report the `coverage` object together with any conclusion.
:::