Anchored Top Trader Positions - Hyblock API (Dev)

Measures top trader positions, anchored daily, 4-hourly, or hourly (UTC timezone), capturing the total number of top trader positions on Binance that are long or short. Top trader positions are defined as those within the top 20% in terms of margin or balance, as classified by Binance. Unlike account-based metrics, this endpoint focuses on individual positions (size). For example, if top trader positions hold

100, 000 p os i t i o n s an d

60,000 are long, the top trader positions long percentage is 60%, and the short percentage is 40%. This endpoint provides insights into the market sentiment and directional bias reflected in the positions of Binance's top traders.

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": [
        {
            "cumulativeLongPct": 2.8700000000000045,
            "cumulativeShortPct": -2.8699999999999903,
            "openDate": 1755069000
        }
    ],
    "metadata": {
        "exchanges": [
            "binance_perp_stable"
        ]
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠422Unprocessable Entity

🟠429Too Many Requests

🔴500Internal Server Error