Anchored Whale Retail Delta - Hyblock API (Dev)

Measures whale vs retail delta anchored daily, 4-hourly, or hourly (UTC timezone), calculating the difference between the long percentage of top trader positions ('whales') and the long percentage of global accounts ('retail') on Binance. Top trader positions are those within the top 20% in terms of margin or balance, as classified by Binance. For example, if top trader positions have a long percentage of 65% and global accounts have a long percentage of 55%, the whale-retail delta is +10. This endpoint provides insights into the divergence in market sentiment between Binance's top traders positions and the broader retail account base.

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": [
        {
            "cumulativeWhaleRetailDelta": -0.7599999999999909,
            "openDate": 1755070200
        }
    ],
    "metadata": {
        "exchanges": [
            "binance_perp_stable"
        ]
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠422Unprocessable Entity

🟠429Too Many Requests

🔴500Internal Server Error