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

# Get volume and liquidity stats for a market

> Computes volume and liquidity analytics for a specific market from the
market_volume_timeseries collection. Returns volume traded in multiple
time windows (1h, 4h, 12h, 24h), volume as a percentage of total,
liquidity-to-volume ratio, and turnover ratio.




## OpenAPI

````yaml openapi.json get /demo/markets/{marketId}/volume-stats
openapi: 3.0.0
info:
  title: Nevua Markets API
  version: 0.0.1
  license:
    name: ISC
    url: https://opensource.org/licenses/ISC
servers:
  - url: https://api.nevua.markets
    description: Production
security: []
tags: []
paths:
  /demo/markets/{marketId}/volume-stats:
    get:
      tags:
        - Demo
      summary: Get volume and liquidity stats for a market
      description: |
        Computes volume and liquidity analytics for a specific market from the
        market_volume_timeseries collection. Returns volume traded in multiple
        time windows (1h, 4h, 12h, 24h), volume as a percentage of total,
        liquidity-to-volume ratio, and turnover ratio.
      operationId: demoGetVolumeStats
      parameters:
        - name: marketId
          in: path
          required: true
          schema:
            type: string
          description: The market ID
      responses:
        '200':
          description: Volume stats
          content:
            application/json:
              schema:
                type: object
                properties:
                  marketId:
                    type: string
                  totalVolume:
                    type: number
                    nullable: true
                    description: Latest total cumulative volume (null if missing)
                  latestLiquidity:
                    type: number
                    nullable: true
                    description: Most recent liquidity value (null if missing)
                  windows:
                    type: object
                    description: Volume stats per window (1h, 4h, 12h, 24h)
                    additionalProperties:
                      type: object
                      properties:
                        volumeTraded:
                          type: number
                          nullable: true
                          description: >-
                            Volume traded in this window (null if volume data
                            missing)
                        volumePercent:
                          type: number
                          nullable: true
                          description: >-
                            volumeTraded / totalVolume (null if totalVolume is 0
                            or missing)
                  liquidityToVolumeRatio:
                    type: number
                    nullable: true
                    description: liquidity / volume_24h
                  turnoverRatio:
                    type: number
                    nullable: true
                    description: volume_24h / liquidity
                  datapoints:
                    type: integer
                    description: Number of timeseries datapoints available
        '401':
          description: Unauthorized
        '404':
          description: No data found for this market
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````