---
title: "Liquidation clusters"
method: GET
path: "/api/v1/clusters"
tags: ["Derivatives"]
---

# Liquidation clusters

`GET /api/v1/clusters`

## Request

- Base URL: `https://marginpad.io`
- URL: `https://marginpad.io/api/v1/clusters`
- Auth: none declared

Modelled price levels where liquidation liquidity is estimated to sit right now: {clusters:[{price, side, est_notional}]}, with updatedAt as the measurement time. These are ESTIMATES from a model, not observed events. Passthrough from the liquidation collector: this route returns the raw object, NOT the { ok, data, ts } envelope.

## Query parameters

- `symbol` string, required

## Response `200`

ok

---

[API](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api.md) · [All operations](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api/revisions/27d21fcd0bf0?raw)