Positions Heatmap Data - Hyblock API (Dev)

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

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://auth-api.dev.hyblockcapital.com/oauth2/token

Scopes:

all-Access to all

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

Responses

🟢200OK

application/json

Request was successful

Body

Example

{
    "data": [
        {
            "endingPrice": 21493.6,
            "size": 0,
            "startingPrice": 21443.6,
            "timestamp": 1694433600
        }
    ],
    "metadata": {
        "exchanges": [
            "binance_perp_stable"
        ]
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠422Unprocessable Entity

🟠429Too Many Requests

🔴500Internal Server Error