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

# Get all order books (best bid/ask)

> Returns the current best bid and ask for all tracked futures symbols.

## Price Format
Prices are raw fixed-point integer values. Divide by 1,000,000,000 for display:
- `6010250000000` → `$6010.25`



## OpenAPI

````yaml /api-reference/md-openapi.json get /md/orderbook
openapi: 3.0.3
info:
  contact:
    name: Hyperprop
    url: https://hyperprop.com
  description: >-
    # Hyperprop Market Data API


    Real-time futures market data streaming.


    ## Overview


    - **REST endpoints** for current ticker prices, OHLC, order books

    - **WebSocket** for real-time streaming with channel subscriptions

    - **JWT authentication** + CME entitlements


    ## Price Format


    Prices are **raw fixed-point integer values** (i64):

    ```text

    displayPrice = rawPrice / 1_000_000_000

    // 6010250000000 → $6010.25

    ```


    ## Authentication


    All WebSocket connections require a JWT token:

    ```http

    wss://api.hyperprop.com/md/ws/stream?token=YOUR_JWT_TOKEN

    ```


    ## CME Entitlements


    Access requires an accepted CME market data agreement and an active
    entitlement for the requested product.


    | Exchange | Symbols |

    |----------|---------|

    | CME | ES, NQ, RTY |

    | CBOT | ZC, ZS, ZW, ZB, ZN |

    | NYMEX | CL, NG, RB |

    | COMEX | GC, SI, HG |


    ## WebSocket Usage


    Connect to `/md/ws/stream` and subscribe to channels:


    ```javascript

    const ws = new
    WebSocket('wss://api.hyperprop.com/md/ws/stream?token=JWT_TOKEN');


    ws.onopen = () => {
      // Subscribe to ticker channel
      ws.send(JSON.stringify({
        action: 'subscribe',
        channel: 'ticker',
        symbols: ['ES', 'NQ']
      }));
    };


    ws.onmessage = (e) => {
      const msg = JSON.parse(e.data);
      if (msg.type === 'Price') {
        console.log(`${msg.data.symbol}: $${(msg.data.price / 1e9).toFixed(2)}`);
      }
    };

    ```
  license:
    name: Proprietary
  title: Hyperprop Market Data API
  version: 0.1.0
servers:
  - url: https://api.hyperprop.com
    description: Production
security: []
tags:
  - description: Health checks and server information
    name: System
  - description: Current ticker prices
    name: Tickers
  - description: OHLC candlestick data
    name: OHLC
  - description: Best bid/ask prices (top of book)
    name: Order Book
  - description: Historical market data (OHLC bars)
    name: Historical
  - description: Real-time streaming via WebSocket
    name: WebSocket
paths:
  /md/orderbook:
    get:
      tags:
        - Order Book
      summary: Get all order books (best bid/ask)
      description: >-
        Returns the current best bid and ask for all tracked futures symbols.


        ## Price Format

        Prices are raw fixed-point integer values. Divide by 1,000,000,000 for
        display:

        - `6010250000000` → `$6010.25`
      operationId: getAllOrderBooks
      responses:
        '200':
          content:
            application/json:
              example:
                books:
                  - ask_price: 29528500000000
                    ask_size: 8
                    bid_price: 29528250000000
                    bid_size: 12
                    contract: NQU6
                    spread: 250000000
                    symbol: NQ
                    timestamp: 1786046460123
                count: 1
                success: true
              schema:
                $ref: '#/components/schemas/AllOrderBooksResponse'
          description: Current order books for all symbols
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Order book service unavailable
components:
  schemas:
    AllOrderBooksResponse:
      description: REST response for all order books
      properties:
        books:
          items:
            $ref: '#/components/schemas/OrderBookData'
          type: array
        count:
          minimum: 0
          type: integer
        success:
          type: boolean
      required:
        - success
        - count
        - books
      type: object
    ErrorResponse:
      description: Error response
      example:
        code: AUTH_REQUIRED
        error: Unauthorized
        message: Valid JWT token required
      properties:
        code:
          description: Error code for programmatic handling
          type: string
        error:
          description: Error type
          type: string
        message:
          description: Human-readable error message
          type: string
      required:
        - error
        - code
        - message
      type: object
    OrderBookData:
      description: Best bid/ask data (top of book) - MBP-1
      properties:
        ask_price:
          description: Best ask price (raw fixed-point value, divide by 1e9)
          format: int64
          type: integer
        ask_size:
          description: Best ask size
          format: int32
          minimum: 0
          type: integer
        bid_price:
          description: Best bid price (raw fixed-point value, divide by 1e9)
          format: int64
          type: integer
        bid_size:
          description: Best bid size
          format: int32
          minimum: 0
          type: integer
        contract:
          description: Full contract symbol (e.g., "ESH6")
          type: string
        spread:
          description: Spread (ask - bid) in raw units
          format: int64
          type: integer
        symbol:
          description: Base symbol (e.g., "ES", "NQ")
          type: string
        timestamp:
          description: Timestamp in nanoseconds
          format: int64
          minimum: 0
          type: integer
      required:
        - symbol
        - contract
        - timestamp
        - bid_price
        - bid_size
        - ask_price
        - ask_size
        - spread
      type: object

````

## Related topics

- [Get order book for a specific symbol](/market-data-api/order-book/get-order-book-for-a-specific-symbol.md)
- [GET /depth/history — rolling order-book depth history.](/market-data-api/historical/get-depthhistory-—-rolling-order-book-depth-history.md)
- [Get current ticker prices](/market-data-api/tickers/get-current-ticker-prices.md)
- [WebSocket Stream (Documentation Only)](/market-data-api/websocket/websocket-stream-documentation-only.md)
- [Introduction](/introduction.md)