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

# Open Interest

> This endpoint returns the total asset open interest for both futures and perpetuals across the various exchanges. The open interest is returns in raw coin amounts and millions of dollars.



## OpenAPI

````yaml get /analytics/futures-perpetuals/open-interest-total
openapi: 3.1.0
info:
  title: derivatives-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets/derivatives
security:
  - sec0: []
paths:
  /analytics/futures-perpetuals/open-interest-total:
    get:
      summary: Open Interest
      description: >-
        This endpoint returns the total asset open interest for both futures and
        perpetuals across the various exchanges. The open interest is returns in
        raw coin amounts and millions of dollars.
      operationId: derivatives-futures-perpetuals-open-interest-total
      parameters:
        - name: asset
          in: query
          description: >-
            **[Required]** The underlying currency for which there are futures
            contracts/instruments. 

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

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

            **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`
          required: true
          schema:
            type: string
            format: date-time
            default: '2024-05-21'
        - name: endDate
          in: query
          description: >-
            **[Required]** Payload only includes data before this date
            (exclusive). 

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

            **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`
          required: true
          schema:
            type: string
            default: '2024-06-01'
        - 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
      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: object
                    properties:
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            exchange:
                              type: string
                              example: huobi
                              description: >-
                                The exchange where the open interest data is
                                from
                            timestamp:
                              type: string
                              example: 1715385600000
                              description: The timestamp for the open interest data point
                            coin:
                              type: number
                              example: 2422.5065079067244
                              description: The open interest amount in raw coin units
                            usd:
                              type: number
                              example: 147.31088485102083
                              description: The open interest amount in millions of USD
              examples:
                Result:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      data:
                        - exchange: huobi
                          timestamp: 1715385600000
                          coin: 2422.5065079067244
                          usd: 147.31088485102083
                        - exchange: kraken
                          timestamp: 1715385600000
                          coin: 3127.0053168195695
                          usd: 190.48881954960004
                        - exchange: bitmex
                          timestamp: 1715385600000
                          coin: 6929.464631763672
                          usd: 372.08792198369997
                        - exchange: deribit
                          timestamp: 1715385600000
                          coin: 25049.827686538036
                          usd: 1547.513314212
                        - exchange: okex
                          timestamp: 1715385600000
                          coin: 43135.73797192597
                          usd: 2635.6437946363894
                        - exchange: bybit
                          timestamp: 1715385600000
                          coin: 76781.5822092026
                          usd: 4669.033820516301
                        - exchange: binance
                          timestamp: 1715385600000
                          coin: 111446.26808003098
                          usd: 6787.6393313128
                        - exchange: cme
                          timestamp: 1715385600000
                          coin: 133229.59999999995
                          usd: 8186.2328186800005
                        - exchange: huobi
                          timestamp: 1715299200000
                          coin: 2243.9724956417745
                          usd: 141.33601091870173
                        - exchange: kraken
                          timestamp: 1715299200000
                          coin: 3210.220565067225
                          usd: 203.0752266112
                        - exchange: bitmex
                          timestamp: 1715299200000
                          coin: 6749.902349060866
                          usd: 374.4837635761
        '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

````