Cumulative Liquidation Level

GET

/cumulativeLiqLevel

Liquidity

Shows the general statistics of predicted liquidation levels, including the number of open long and short liquidation levels by size and count and the differences between them.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://api.hyblockcapital.com/v2/oauth2/token

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.hyblockcapital.com/v2/cumulativeLiqLevel?coin=BTC&exchange=binance_perp_stable&leverage=all&timestamp=1780272000' \
--header 'x-api-key: <api-key>' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "data": [
        {
            "timestamp": 1783690020,
            "totalCountLiquidationDelta": 164,
            "totalLongLiquidationCount": 377,
            "totalLongLiquidationSize": 13274141681.379982,
            "totalShortLiquidationCount": 213,
            "totalShortLiquidationSize": 6554138289.679998,
            "totalSizeLiquidationDelta": 6720003391.699984
        }
    ],
    "metadata": {
        "exchanges": [
            "binance_perp_stable"
        ]
    }
}

🟠400Bad Request

🟠422Unauthorized

🔴500Forbidden

Modified at 2026-08-04 07:40:05

Top Trader Average Leverage Used

Liquidation Levels Count