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

# Pair Volume Historical

> Retrieves the daily volume of pairs on each exchange.



## OpenAPI

````yaml get /exchanges/{exchange}/pairs/volumes/historical
openapi: 3.1.0
info:
  title: Market Metrics
  version: '2'
servers:
  - url: https://api.amberdata.com/market/metrics
security:
  - sec0: []
paths:
  /exchanges/{exchange}/pairs/volumes/historical:
    get:
      summary: Pair Volume Historical
      description: Retrieves the daily volume of pairs on each exchange.
      operationId: market-metrics-exchanges-pairs-volumes-historical
      parameters:
        - name: exchange
          in: path
          description: The exchange for which to retrieve the requested data.
          schema:
            type: string
            default: gdax
          required: true
        - name: pair
          in: query
          description: >-
            **[Optional]** The pair for which to retrieve the most current
            data.<BR/>**[Default]** All available pairs.
          schema:
            type: string
            default: btc_usd
        - name: direction
          in: query
          description: >-
            **[Optional]** The order in which to return the results, ordered by
            volumeUSD (ascending or descending). By default, records are
            returned in descending order, so the records with the largest volume
            are returned first.
          schema:
            type: string
            default: desc
        - name: startDate
          in: query
          description: >-
            **[Optional]** Payload only includes data after this date
            (inclusive).<BR>**[Formats]** `seconds | milliseconds |
            iso8601`<BR>**[Examples]** `1578531600 | 1578531600000 |
            2020-09-01T01:00:00`
          schema:
            type: string
        - name: endDate
          in: query
          description: >-
            **[Optional]** Payload only includes data before this date
            (exclusive).<BR>**[Formats]** `seconds | milliseconds |
            iso8601`<BR>**[Examples]** `1578531600 | 1578531600000 |
            2020-09-01T01:00:00`
          schema:
            type: string
        - name: timeFormat
          in: query
          description: >-
            **[Optional]** Time format of the timestamps in the return
            payload.<BR/>**[Defaults]** `milliseconds | ms* | iso | iso8601 | hr
            | human_readable`
          schema:
            type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      metadata:
                        startDate: 2022-03-10 00:00:00 000
                        endDate: 2022-03-11 10:00:00 000
                      data:
                        - exchange: gdax
                          pair: btc_usd
                          timestamp: 2022-03-10 00:00:00 000
                          volumeUSD: '820976607.01839280'
                        - exchange: gdax
                          pair: btc_usd
                          timestamp: 2022-03-11 00:00:00 000
                          volumeUSD: '616422583.44034633'
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 200
                    default: 0
                  title:
                    type: string
                    example: OK
                  description:
                    type: string
                    example: Successful request
                  payload:
                    type: object
                    properties:
                      metadata:
                        type: object
                        properties:
                          startDate:
                            type: string
                            example: 2022-03-10 00:00:00 000
                          endDate:
                            type: string
                            example: 2022-03-11 10:00:00 000
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            exchange:
                              type: string
                              example: gdax
                            pair:
                              type: string
                              example: btc_usd
                            timestamp:
                              type: string
                              example: 2022-03-10 00:00:00 000
                            volumeUSD:
                              type: string
                              example: '820976607.01839280'
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      x-default: API-KEY
      name: x-api-key

````