Position Heatmap Data

GET

/positionHeatmap

Position Heatmap

The Positions Heatmap API endpoint tracks open interest, net longs, net shorts, and net long-short delta across price buckets, visualizing where traders are opening or closing positions. It provides insights into market sentiment, support/resistance zones, and potential trapped traders, with data reflecting the most recent timestamp only for up-to-date market positioning.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.hyblockcapital.com/v2/positionHeatmap?coin=BTC&exchange=binance_perp_stable&graphType=netLongs&lookback=12h&timestamp=1780272000' \
--header 'x-api-key: <api-key>'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "data": [
        {
            "endingPrice": 64600,
            "size": 17156349.895562846,
            "startingPrice": 64470.8
        }
    ],
    "metadata": {
        "exchanges": [
            "binance_perp_stable"
        ],
        "unsupportedExchanges": [
            "okx_perp_stable"
        ]
    }
}

🟠400Bad Request

🟠422Unauthorized

🔴500Forbidden

Modified at 2026-08-11 07:23:22

Position Heatmap

Catalog