Global Accounts

GET

/globalAccounts

Longs & Shorts

This measures the total number of accounts that are long or short on given exchange like Binance. So for example, if there are 1million accounts on Binance and 600k of them are net long, then the global accounts long% is 60% (and short% = 40%). Each account gets one 'vote'.

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

curl --location --request GET 'https://api.dev.hyblockcapital.com/v2/globalAccounts?coin&exchange&timeframe&limit&startTime&endTime&sort&advanceFilter' \
--header 'Authorization: Bearer <token>' \
--header 'x-api-key: <api-key>'

Responses

🟢200OK

application/json

Request was successful

Body

Example

{
    "data": [
        {
            "longPct": 54.87,
            "lsRatio": 1.2158,
            "openDate": 1691657100,
            "shortPct": 45.129
        }
    ],
    "metadata": {
        "exchanges": [
            "binance_perp_stable"
        ]
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠422Unprocessable Entity

🟠429Too Many Requests

🔴500Internal Server Error

Modified at 2025-12-31 05:42:54

Anchored Top Trader Positions

Anchored Global Accounts