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

# Instruments Most Traded

> This endpoint returns the most traded instruments on a selected exchange for a selected underlying currency, for a given date range. This endpoint also returns the VWAP (Volume-Weighted-Average-Price) and VWAP of implied volatility. The calculation for VWAP uses each available trade, weighted by contract sizes and applied to Price USD and/or Implied Volatility, for the given date range.



## OpenAPI

````yaml get /analytics/instruments/most-traded/tradfi
openapi: 3.1.0
info:
  title: derivatives-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets/derivatives
security:
  - sec0: []
paths:
  /analytics/instruments/most-traded/tradfi:
    get:
      summary: Instruments Most Traded
      description: >-
        This endpoint returns the most traded instruments on a selected exchange
        for a selected underlying currency, for a given date range. This
        endpoint also returns the VWAP (Volume-Weighted-Average-Price) and VWAP
        of implied volatility. The calculation for VWAP uses each available
        trade, weighted by contract sizes and applied to Price USD and/or
        Implied Volatility, for the given date range.
      operationId: tradfi-trades-flow-instruments-most-traded
      parameters:
        - name: currency
          in: query
          description: >
            **[Required]** The underlying currency for which there are listed
            option instruments. 

            **[Examples]** ` IBIT | COIN ` 
          required: true
          schema:
            type: string
            default: IBIT
        - name: startDate
          in: query
          description: >-
            **[Required]** Payload only includes data after this date
            (inclusive). 

            **[Formats]** `seconds | milliseconds | iso8601`

            **[Examples]** `1578531600 | 1578531600000 | 2024-11-25`
          schema:
            type: string
            format: date-time
            default: '2024-11-25'
        - name: endDate
          in: query
          description: >-
            **[Required]** Payload only includes data before this date
            (exclusive). 

            **[Formats]** `seconds | milliseconds | iso8601`

            **[Examples]** `1578531600 | 1578531600000 | 2024-11-26`
          schema:
            type: string
            default: '2024-11-26'
        - name: timeFormat
          in: query
          description: >-
            **[Optional]** Time format of the timestamps in the return payload.

            **[Defaults]** `milliseconds | ms* | iso | iso8601 | hr |
            human_readable`
          schema:
            type: string
            default: hr
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  title:
                    type: string
                  description:
                    type: string
                  payload:
                    type: object
              examples:
                Result:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      data:
                        - contractVolume: 19359
                          currency: IBIT
                          exchange: tradfi
                          instrument: IBIT-17JAN25-54-C
                          maxIv: 74.47000122070312
                          minIv: 53.66999816894531
                          vwapIv: 66.03
                          vwapPriceUsd: 5.64
                        - contractVolume: 18179
                          currency: IBIT
                          exchange: tradfi
                          instrument: IBIT-17JAN25-54-P
                          maxIv: 66.37000274658203
                          minIv: 60.0099983215332
                          vwapIv: 64.64
                          vwapPriceUsd: 5.03
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: {}
              schema:
                type: object
                properties: {}
      deprecated: false
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````