Top Trader Positions

GET

/topTraderPositions

Longs & Shorts

This measures the total number of top trader positions that are long (or short). The key difference here is that instead of looking at accounts, it instead looks at positions.

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/topTraderPositions?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

Top Trader Accounts

Trader Sentiment Gap