Hyblock API
Terminal
Terminal
  1. Longs & Shorts
  • Authentication
  • Authentication(legacy)
  • Orderflow
    • Anchored CVD
      GET
    • Bot Tracker
      GET
    • Buy Sell Trade Count Ratio
      GET
    • Buy volume
      GET
    • Exchange Premium
      GET
    • Kline
      GET
    • Limit Order Average Size
      GET
    • Limit Order Count
      GET
    • Limit Order Count Ratio
      GET
    • Market Order Average Size
      GET
    • Market Order Count
      GET
    • Market Order Count Ratio
      GET
    • Participation Ratio
      GET
    • Previous Day Level
      GET
    • Previous Month Level
      GET
    • Previous Week Level
      GET
    • Sell volume
      GET
    • Slippage
      GET
    • Transfer Of Contracts
      GET
    • Volume delta
      GET
    • Volume ratio
      GET
  • Funding Rate
    • Funding Rate
  • Longs & Shorts
    • Anchored CLS
      GET
    • Anchored CLSD
      GET
    • Anchored Global Accounts
      GET
    • Anchored Top Trader Accounts
      GET
    • Anchored Top Trader Positions
      GET
    • Anchored Whale Retail Delta
      GET
    • Global Accounts
      GET
    • Net Long Short
      GET
    • Net Long Short Delta
      GET
    • Top Trader Accounts
      GET
    • Top Trader Positions
      GET
    • Trader Sentiment Gap
      GET
    • True Retail Long Short
      GET
    • Whale Position Dominance
      GET
    • Whale Retail Delta
      GET
  • Orderbook
    • Asks Increase Decrease
    • Best Bid Ask
    • Bid Ask
    • Bid Ask Delta
    • Bid Ask Ratio
    • Bid Ask Ratio Diff
    • Bid Ask Spread
    • Bids Increase Decrease
    • Combined Book
    • Market Imbalance Index
  • Global Metrics
    • Global Asks Increase Decrease
    • Global Bid Ask
    • Global Bid Ask Delta
    • Global Bid Ask Ratio
    • Global Bid Ask Ratio Inc Dec
    • Global Bids Increase Decrease
    • Global Buy Sell Trade Count Ratio
    • Global Combined Book
    • Global Buy Volume
    • Global Limit Order Average Size
    • Global Limit Order Count
    • Global Limit Order Count Ratio
    • Global Market Order Average Size
    • Global Market Order Count
    • Global Market Order Count Ratio
    • Global Open Interest Delta
    • Global Sell Volume
    • Global Volume Delta
    • Global Volume Ratio
  • Open Interest
    • Anchored OI Delta
    • Open Interest
    • Open Interest Delta
  • Options
    • Bvol
    • Dvol
  • Sentiment
    • Fear And Greed Index
    • Margin Lending Ratio
    • Premium P2P
    • WBTC Mint Burn
    • Twitter
    • Leaderboard Notional Profit
    • Leaderboard ROE Profit
    • User Bot Ratio
  • Liquidity
    • Anchored Liquidation Levels Count
    • Anchored Liquidation Levels Size
    • Top Trader Average Leverage Delta
    • Top Trader Average Leverage Used
    • Cumulative Liquidation Level
    • Liquidation Levels Count
    • Liquidation Levels Size
    • Liquidation
    • Liquidation Heatmap
    • Liquidation Levels
    • Liquidation Levels TV
    • Top Trader Margin Used
    • Top Trader Margin Used Delta
    • Squeeze Intensity
  • Profile Tool
    • Profiles Tool Data
  • Position Heatmap
    • Position Heatmap Data
  • Catalog
    • Catalog
  • System
    • Data Availability
    • Health Check
  • Schemas
    • AnchoredCLSDResponse
    • AnchoredCLSResponse
    • AnchoredCVDResponse
    • AnchoredGlobalAccountsResponse
    • AnchoredLiqLevelsCountResponse
    • AnchoredLiqLevelsSizeResponse
    • AnchoredOIDeltaResponse
    • AnchoredTopTraderAccountsResponse
    • AnchoredTopTraderPositionsResponse
    • AnchoredWhaleRetailDeltaResponse
    • AsksIncreaseDecreaseResponse
    • BestBidAskResponse
    • BidAskDeltaResponse
    • BidAskRatioDiffResponse
    • BidAskRatioResponse
    • BidAskResponse
    • BidsAskSpreadResponse
    • BidsIncreaseDecreaseResponse
    • BotTrackerResponse
    • BuySellTradeCountRatioResponse
    • BuyVolumeResponse
    • BvolResponse
    • CatalogResponse
    • CombinedBookResponse
    • CumulativeLiqLevelResponse
    • DataAvailabilityResponse
    • DvolResponse
    • ErrorResponse
    • ExchangePremiumResponse
    • FearAndGreedResponse
    • FundingRateResponse
    • GlobalAccountsResponse
    • GlobalAsksIncreaseDecreaseResponse
    • GlobalBidAskDeltaResponse
    • GlobalBidAskRatioIncreaseDecreaseResponse
    • GlobalBidAskRatioResponse
    • GlobalBidAskResponse
    • GlobalBidsIncreaseDecreaseResponse
    • GlobalCombinedBookResponse
    • KlinesResponse
    • LimitOrderAverageSizeResponse
    • LimitOrderCountRatioResponse
    • LimitOrderCountResponse
    • LiqLevelsCountResponse
    • LiqLevelsSizeResponse
    • LiquidationHeatmapResponse
    • LiquidationLevelResponse
    • LiquidationLevelsTVResponse
    • LiquidationResponse
    • MarketImbalanceIndexResponse
    • MarketOrderAverageSizeResponse
    • MarginLendingRatioResponse
    • MarketOrderCountRatioResponse
    • MarketOrderCountResponse
    • NetLongShortDeltaResponse
    • NetLongShortResponse
    • OpenInterestDeltaResponse
    • OpenInterestResponse
    • ParticipationRatioResponse
    • PositionHeatmapResponse
    • PreviousDayLevelResponse
    • PreviousMonthLevelResponse
    • PremiumP2PResponse
    • PreviousWeekLevelResponse
    • ProfileToolResponse
    • SellVolumeResponse
    • SlippageResponse
    • SqueezeIntensityResponse
    • TopTraderAccountsResponse
    • TopTraderAverageLeverageDeltaResponse
    • TopTraderAverageLeverageUsedResponse
    • TopTraderPositionsResponse
    • TopTraderMarginUsedDeltaResponse
    • TopTraderMarginUsedResponse
    • TraderSentimentGapResponse
    • TransferOfContractsResponse
    • TrueRetailLongShortResponse
    • VolumeDeltaResponse
    • VolumeRatioResponse
    • TwitterResponse
    • WBTCMintBurnResponse
    • WhalePositionDominanceResponse
    • WhaleRetailDeltaResponse
  1. Longs & Shorts

True Retail Long Short

GET
/trueRetailLongShort
Longs & Shorts
This metric shows the percentage of retail accounts in long versus short positions, with each account equally contributing one vote, regardless of position size.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.hyblockcapital.com/v2/trueRetailLongShort?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
OK
Bodyapplication/json

Example
{
    "data": [
        {
            "longPct": 59.6125,
            "openDate": 1783623600,
            "shortPct": 40.3875
        }
    ],
    "metadata": {
        "exchanges": [
            "binance_perp_stable"
        ],
        "unsupportedExchanges": [
            "okx_perp_stable"
        ]
    }
}
🟠400Bad Request
🟠422Unauthorized
🔴500Forbidden
Modified at 2026-08-11 07:23:22
Previous
Trader Sentiment Gap
Next
Whale Position Dominance
Built with