Liquidation map (price × leverage tier)

GET 
/api/v1/liquidation/map

Coinglass-style liquidation map for one perpetual pair. Returns a price-grid breakdown of where leveraged positions would be liquidated, split by leverage tier (10x / 25x / 50x / 100x) and side (long below current price, short above). Built from current OI + last-24h candle entries + a fixed leverage-cohort prior. Read the assumptions field in the response for the modelling disclaimer. Cached server-side (~5s) so back-to-back polls are cheap.

Request

Query Parameters

exchange string
Exchange
Default value: binance
base stringrequired

Base asset

quote string
Quote asset
Default value: USDT

Header Parameters

X-DTMX-APIKEY stringrequired

Your DataMaxi+ API key

Responses

200

OK

application/json

Schema

Schema

assumptions

object

entrySamples integer

entryWindow string

longShareOfOi number

mmr number

tiers

object[]

Array [

leverage integer

share number

]

base string

buckets

object[]

Array [

l100xUsd number

l10xUsd number

l25xUsd number

l50xUsd number

price number

side string

totalUsd number

]

cumulativeLongUsd number

Cumulative totals — separately surfaced so the FE doesn't have to re-sum to drive the cumulative line series (Coinglass-style).

cumulativeShortUsd number
currentPrice number
exchange string
generatedAt integer
quote string
symbol string
totalOiUsd number

Example (from schema)

{
  "assumptions": {
    "entrySamples": 0,
    "entryWindow": "string",
    "longShareOfOi": 0,
    "mmr": 0,
    "tiers": [
      {
        "leverage": 0,
        "share": 0
      }
    ]
  },
  "base": "string",
  "buckets": [
    {
      "l100xUsd": 0,
      "l10xUsd": 0,
      "l25xUsd": 0,
      "l50xUsd": 0,
      "price": 0,
      "side": "string",
      "totalUsd": 0
    }
  ],
  "cumulativeLongUsd": 0,
  "cumulativeShortUsd": 0,
  "currentPrice": 0,
  "exchange": "string",
  "generatedAt": 0,
  "quote": "string",
  "symbol": "string",
  "totalOiUsd": 0
}

400

Bad Request

application/json

Schema

Schema

error string

error specifies the error message

Example (from schema)

{
  "error": "string"
}

500

Internal Server Error

application/json

Schema

Schema

error string

error specifies the error message

Example (from schema)

{
  "error": "string"
}

Loading...