Anchored Top Trader Accounts - Hyblock API (Dev)

Measures top trader accounts, anchored daily, 4-hourly, or hourly (UTC timezone), capturing the total number of top trader accounts on Binance holding long or short positions. Top trader accounts are defined as those within the top 20% in terms of margin or balance, as classified by Binance, and do not necessarily represent the best traders or those with the highest profits. Each top trader account is counted as a single 'vote' to determine the percentage of accounts that are net long or net short. For example, if there are 100,000 top trader accounts and 60,000 are net long, the top trader accounts long percentage is 60%, and the short percentage is 40%. This endpoint provides insights into the market sentiment and directional bias among Binance's top trader accounts.

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