> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hypedexer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Liquidity report

> Liquidity summary per day or week (window max 365 days): spread, median USD resting in the top 20 stored levels and their median reach in bps, median depth within 10 and 50 bps (only when the recorded book reaches that far for at least half of the period), average slippage for 100k and 1M USD over measurable minutes, coverage, plus the hour-of-day profile (UTC) of the recorded book notional. Coverage: April 2024 to February 2026 from our market data archive (`data_source: archive`, top ~20 levels per side), and continuously since 23 September 2026 from the full order book replayed from our own Hyperliquid node (`data_source: node`, every resting order). No book data between 10 February and 23 September 2026.



## OpenAPI

````yaml /api-reference/openapi.json get /market/liquidity-report/{coin}
openapi: 3.0.3
info:
  title: 'Hypedexer API: Indexed Data'
  version: 1.0.0
  description: >-
    API to query indexed Hyperliquid trading data.


    This API provides access to stored/indexed trading data:

    - **Fills**: Executed orders and fills (Spot-only or All = Spot + Perp)

    - **Analytics**: Aggregations and statistics based on indexed data

    - **Completed Trades**: Trade objects and their related fills

    - **Users**: User overviews, performance and activity

    - **Social Trading**: Per-trader equity curve, PnL calendar, account
    leverage and top trades

    - **Funding**: Funding rate history, user funding payments, predicted rates

    - **Liquidations**: Liquidation events with filters

    - **Overview**: Market dashboard metrics (volume, fees, traders, PnL)

    - **Spot**: Spot token metadata, pairs, and auctions

    - **TWAPs**: TWAP orders, execution stats and fills

    - **Vaults**: Vault details, summaries, equity, ledger


    > Note: No live streaming. Responses are computed from indexed data.
servers:
  - url: https://api.hypedexer.com
    description: Production, routed to the nearest region (EU or JP)
security:
  - ApiKeyAuth: []
tags:
  - name: Fills
    description: Fills endpoints.
  - name: Analytics
    description: Aggregations and stats.
  - name: Completed Trades
    description: Trades and fills.
  - name: Users
    description: User profiles.
  - name: Funding
    description: Funding rates and payments (HL-compatible).
  - name: Liquidations
    description: Liquidation events.
  - name: Overview
    description: Market dashboard metrics.
  - name: Spot
    description: Spot token metadata, pairs and auctions.
  - name: TWAPs
    description: TWAP orders, stats and fills.
  - name: Vaults
    description: Vault details, summaries, equity and ledger.
  - name: Social Trading
    description: >-
      Per-trader equity, PnL calendar, performance, account leverage and top
      trades.
  - name: Market history
    description: >-
      Historical Hyperliquid market microstructure: best bid/offer aggregates
      and spread statistics (April 2024 to February 2026), and the order book
      reconstructed minute by minute: April 2024 to February 2026 from our
      archive (top ~20 levels per side) and, since 23 September 2026, the full
      order book replayed from our own node. Served from the EU region.
paths:
  /market/liquidity-report/{coin}:
    get:
      tags:
        - Market history
      summary: Liquidity report
      description: >-
        Liquidity summary per day or week (window max 365 days): spread, median
        USD resting in the top 20 stored levels and their median reach in bps,
        median depth within 10 and 50 bps (only when the recorded book reaches
        that far for at least half of the period), average slippage for 100k and
        1M USD over measurable minutes, coverage, plus the hour-of-day profile
        (UTC) of the recorded book notional. Coverage: April 2024 to February
        2026 from our market data archive (`data_source: archive`, top ~20
        levels per side), and continuously since 23 September 2026 from the full
        order book replayed from our own Hyperliquid node (`data_source: node`,
        every resting order). No book data between 10 February and 23 September
        2026.
      parameters:
        - name: coin
          in: path
          description: Coin symbol (e.g. BTC, @107 for a spot pair, xyz:TSLA for HIP-3)
          schema:
            type: string
          required: true
        - name: start_time
          in: query
          description: Start time (ISO UTC)
          schema:
            type: string
            format: date-time
          required: true
        - name: end_time
          in: query
          description: End time (ISO UTC); default = start + 30 days
          schema:
            type: string
            format: date-time
        - name: period
          in: query
          description: Aggregation period
          schema:
            type: string
            default: day
            enum:
              - day
              - week
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
              example:
                success: true
                message: 'Liquidity report for SOL: 1 weeks'
                data:
                  coin: SOL
                  start_time: '2025-09-01T00:00:00Z'
                  end_time: '2025-09-08T00:00:00Z'
                  period: week
                  deepest_hour_utc: 19
                  shallowest_hour_utc: 14
                  periods:
                    - period_start: '2025-09-01'
                      minutes: 10080
                      coverage_pct: 100
                      spread_bps_avg: 0.5276
                      spread_bps_median: 0.4915
                      book_notional_median_usd: 11580786.51
                      book_span_bps_median: 9.58
                      depth_10bps_median_usd: null
                      band_10bps_complete_pct: 1.7
                      depth_50bps_median_usd: null
                      band_50bps_complete_pct: 0
                      slip_100k_bps: 0.7244
                      slip_100k_measurable_pct: 100
                      slip_1m_bps: 1.9958
                      slip_1m_measurable_pct: 100
                  by_hour_utc:
                    - hour_utc: 0
                      book_notional_median_usd: 11036780.18
                      spread_bps_avg: 0.5267
                    - hour_utc: 1
                      book_notional_median_usd: 11358848.3
                      spread_bps_avg: 0.5307
                total_count: null
                execution_time_ms: 168.12
                next_cursor: null
                has_more: null
        '400':
          description: >-
            Invalid window or parameter (for example a window larger than the
            interval allows)
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Your Hypedexer API key. Create one in the console at
        https://app.hypedexer.com. `Authorization: Bearer <key>` and the
        `api_key` query parameter are accepted as well.

````