Top Trader Accounts

GET

/topTraderAccounts

Longs & Shorts

This measures the total number of top trader accounts that are long (or short). Note, top traders do not necessarily mean the best traders or those with the highest profits, but rather classifies top traders as accounts with the top20% in margin. This indicator is similar to Global Long Accounts with the only difference being that it focuses on the top 20% accounts.

Request

Authorization

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 'https://api.hyblockcapital.com/v2/topTraderAccounts?coin=BTC&exchange=binance_perp_stable&timeframe=1m&startTime=1782777600&endTime=1782864000&limit=50&sort=asc&advanceFilter=none' \
--header 'x-api-key: <api-key>'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "data": [
        {
            "longPct": 57.16,
            "lsRatio": 1.33426704015,
            "openDate": 1783686600,
            "shortPct": 42.84
        }
    ],
    "metadata": {
        "exchanges": [
            "binance_perp_stable"
        ]
    }
}

🟠400Bad Request

🟠422Unauthorized

🔴500Forbidden

Modified at 2026-08-11 07:23:22

Net Long Short Delta

Top Trader Positions