> ## 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.

# Order book at a point in time

> The order book as of the end of a given minute (`source=minute`, up to 20 levels per side) or the nearest full snapshot at or before that time (`source=snapshot`, up to 50 levels per side, about every 10 minutes on archive data and every 12 minutes on node data). `data_source` tells which dataset answered (`archive` or `node`). 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. Returns 404 when no book exists for the coin in the 24 hours before `at`.



## OpenAPI

````yaml /api-reference/openapi.json get /market/book/{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/book/{coin}:
    get:
      tags:
        - Market history
      summary: Order book at a point in time
      description: >-
        The order book as of the end of a given minute (`source=minute`, up to
        20 levels per side) or the nearest full snapshot at or before that time
        (`source=snapshot`, up to 50 levels per side, about every 10 minutes on
        archive data and every 12 minutes on node data). `data_source` tells
        which dataset answered (`archive` or `node`). 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. Returns 404 when no book exists for the coin in the 24
        hours before `at`.
      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: at
          in: query
          description: >-
            Timestamp (ISO UTC); the book as of the end of that minute is
            returned
          schema:
            type: string
            format: date-time
          required: true
        - name: levels
          in: query
          description: Levels per side (max 20 from minute states, 50 from full snapshots)
          schema:
            type: integer
            default: 20
            minimum: 1
            maximum: 50
        - name: source
          in: query
          description: >-
            minute = end-of-minute reconstructed state (default); snapshot =
            nearest full snapshot at or before `at` (~every 10 min)
          schema:
            type: string
            default: minute
            enum:
              - minute
              - snapshot
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
              examples:
                node:
                  summary: Full book (node data, September 2026)
                  value:
                    success: true
                    message: Book for ETH at 2026-09-23 18:40:00 (minute)
                    data:
                      coin: ETH
                      source: minute
                      time: '2026-09-23T18:40:00'
                      mid_px: 2660.95
                      spread_bps: 0.3758056333261018
                      levels_bid: 6870
                      levels_ask: 3953
                      book_span_bid_bps: 7.33
                      book_span_ask_bps: 7.33
                      book_notional_bid_usd: 9432583.95
                      book_notional_ask_usd: 9994522.37
                      secs_since_snapshot: 667
                      pruned: 0
                      data_source: node
                      bids:
                        - px: 2660.9
                          sz: 86.0191
                        - px: 2660.8
                          sz: 43.9009
                        - px: 2660.7
                          sz: 81.0383
                      asks:
                        - px: 2661
                          sz: 57.502
                        - px: 2661.1
                          sz: 26.6904
                        - px: 2661.2
                          sz: 54.2979
                    total_count: null
                    execution_time_ms: 89.42
                    next_cursor: null
                    has_more: null
                archive:
                  summary: Archive (November 2025)
                  value:
                    success: true
                    message: Book for BTC at 2025-11-01 12:00:00 (minute)
                    data:
                      coin: BTC
                      source: minute
                      time: '2025-11-01T12:00:00'
                      mid_px: 110149.5
                      spread_bps: 0.09078570488290914
                      levels_bid: 20
                      levels_ask: 20
                      book_span_bid_bps: 1.77
                      book_span_ask_bps: 1.77
                      book_notional_bid_usd: 2557595.5
                      book_notional_ask_usd: 1899752.08
                      secs_since_snapshot: 0
                      pruned: 0
                      bids:
                        - px: 110149
                          sz: 9.39104
                        - px: 110148
                          sz: 1.7631700000000001
                        - px: 110147
                          sz: 1.95268
                      asks:
                        - px: 110150
                          sz: 1.22088
                        - px: 110151
                          sz: 0.00011
                        - px: 110152
                          sz: 0.05737
                    total_count: null
                    execution_time_ms: 148.95
                    next_cursor: null
                    has_more: null
        '400':
          description: >-
            Invalid window or parameter (for example a window larger than the
            interval allows)
        '404':
          description: No book state in the 24 hours before `at`
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.

````