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

# Pairs Historical

> Retrieves historical daily metrics for the specified pair (for example DAI_WETH).



## OpenAPI

````yaml get /metrics/exchanges/{exchange}/pairs/{pair}/historical
openapi: 3.1.0
info:
  title: Defi Market API
  version: '2'
servers:
  - url: https://api.amberdata.com/market/defi
security:
  - sec0: []
paths:
  /metrics/exchanges/{exchange}/pairs/{pair}/historical:
    get:
      summary: Pairs Historical
      description: >-
        Retrieves historical daily metrics for the specified pair (for example
        DAI_WETH).
      operationId: defi-metrics-pairs-historical
      parameters:
        - name: exchange
          in: path
          description: >-
            Exchange for which to return the global metrics - can be specified
            as:<BR/>- a name: `uniswapv2`<BR/>- an id:
            `0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f`
          schema:
            type: string
            default: uniswapv2
          required: true
        - name: pair
          in: path
          description: >-
            Pair for which to return the metrics, for example:<BR/>-
            `0xa478c2975ab1ea89e8196811f51a7b7ade33eb11` (DAI_WETH)
          schema:
            type: string
            default: '0xa478c2975ab1ea89e8196811f51a7b7ade33eb11'
          required: true
        - 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-01T00:00:00`
          schema:
            type: string
            format: date-time
        - 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-02T00:00:00`
          schema:
            type: string
            format: date-time
        - 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:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 200
                  title:
                    type: string
                    example: OK
                  description:
                    type: string
                    example: Successful request
                  payload:
                    type: array
                    items:
                      type: object
                      properties:
                        exchangeId:
                          type: string
                          example: '0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f'
                        timestamp:
                          type: string
                          example: '2020-12-29T06:00:00.000Z'
                        address:
                          type: string
                          example: '0x6b175474e89094c44da98b954eedeac495271d0f'
                        feesNative:
                          type: string
                          example: '143.946130507571397825'
                        feesUSD:
                          type: string
                          example: '144.013821392561330123'
                        liquidityTotalNative:
                          type: string
                          example: '103973505.181589129290317518'
                        liquidityTotalUSD:
                          type: string
                          example: '104022398.879227475227263226'
                        pairsTradedTotal:
                          type: integer
                          example: 1
                        tradesTotal:
                          type: integer
                          example: 3445
                        priceNative:
                          type: string
                          example: '0.00075603290509702245'
                        volumeTotalNative:
                          type: string
                          example: '47982.043502523799274881'
                        volumeTotalUSD:
                          type: string
                          example: '48004.607130853776707797'
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      x-default: API_KEY
      name: x-api-key

````