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

    Orderbook

    Orderbook API Endpoints Documentation#

    This document provides an overview of all Orderbook-tagged API endpoints available in the Hyblock Professional API v2.

    Table of Contents#

    Bid/Ask Metrics
    Orderbook Dynamics
    Market Imbalance

    Bid/Ask Metrics#

    Bid Ask#

    Endpoint: GET /v2/bidAsk
    Description: A bid (or limit buy) is a "passive" buyer who advertises the price and size they would like to buy at. An asks (or limit sell) is a "passive" seller who advertises the price and size they would like to sell at.
    Summary: Bid Ask

    Bid Ask Ratio#

    Endpoint: GET /v2/bidAskRatio
    Description: Bid Ask Ratio is an oscillator that ranges from -1 to 1. The mathematical formula is (Bids - Asks) / (Bids + Asks).
    Summary: Bid Ask Ratio

    Bid Ask Delta#

    Endpoint: GET /v2/bidAskDelta
    Description: Evaluate the immediate disparity between buy and sell orders.
    Summary: Bid Ask Delta

    Bid Ask Ratio Diff#

    Endpoint: GET /v2/bidAskRatioDiff
    Description: Change in orderbook bid ask ratio over a specified period of time.
    Summary: Bid Ask Ratio Diff

    Bids Ask Spread#

    Endpoint: GET /v2/bidsAskSpread
    Description: The bid-ask spread represents the difference between the best bid (highest price a buyer is willing to pay) and the best ask (lowest price a seller is willing to accept). Tracking the spread provides insights into market liquidity, trading costs, and potential slippage. A narrower spread typically signals higher liquidity and lower transaction costs, while a wider spread can indicate lower liquidity or heightened volatility.
    Summary: Bids Ask Spread

    Combined Book#

    Endpoint: GET /v2/combinedBook
    Description: A consolidated perspective of the market's orderbook dynamics.
    Summary: Combined Book

    Best Bid Ask#

    Endpoint: GET /v2/bestBidAsk
    Description: Represents the total limit buy size (best bid) and limit sell size (best ask) at the closest price levels to the last traded price. These are the first executable price levels on each side of the orderbook.
    Summary: Best Bid Ask

    Orderbook Dynamics#

    Bids Increase Decrease#

    Endpoint: GET /v2/bidsIncreaseDecrease
    Description: Change in orderbook Bids over a specific time period. The mathematical formula is Current Bid - Previous Bid
    Summary: Bids Increase Decrease

    Asks Increase Decrease#

    Endpoint: GET /v2/asksIncreaseDecrease
    Description: Change in orderbook Asks over a specific time period. The mathematical formula is Current Ask - Previous Ask
    Summary: Asks Increase Decrease

    Market Imbalance#

    Market Imbalance Index#

    Endpoint: GET /v2/marketImbalanceIndex
    Description: A proprietary Hyblock indicator that combines orderflow (aggressive volume) and orderbook (passive liquidity) imbalances to quantify overall market pressure. The index oscillates between -1 and 1, indicating net sell pressure or buy side pressure. Positive values indicate net demand dominance. Negative values indicate net supply side dominance.
    Summary: Market Imbalance Index

    Common Parameters#

    Most endpoints accept the following common query parameters:
    exchange: Exchange identifier (e.g., binance_perp_stable)
    coin: Cryptocurrency symbol (e.g., BTC, ETH)
    timeframe: Time interval (1m, 5m, 15m, 1h, 4h, 1d)
    limit: Number of data points to return (default: 50)
    startTime: Start timestamp (Unix timestamp)
    endTime: End timestamp (Unix timestamp)
    sort: Sort order (asc or desc)

    Authentication#

    All endpoints require authentication via:
    API Key: x-api-key header
    OAuth2: Bearer token

    Rate Limits#

    Rate Limit: 600 requests per minute
    Burst Limit: 10 concurrent requests

    Base URL#

    All endpoints are prefixed with /v2/ and should be accessed via the base API URL.
    For detailed request/response schemas and examples, please refer to the OpenAPI specification at /v2/openapi.json or visit the interactive API documentation.
    Modified at 2025-12-30 13:14:40
    Previous
    Trader Sentiment Gap
    Next
    Bid Ask
    Built with