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

> Provides metadata for available options contracts on supported exchanges, including exchange names, contract symbols, and data types (Order Book Events, Ticker, Trades, etc.) with associated data coverage periods.



## OpenAPI

````yaml get /options/exchanges/information
openapi: 3.1.0
info:
  title: market-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets
security:
  - ApiKeyAuth: []
paths:
  /options/exchanges/information:
    get:
      summary: Instruments
      description: >-
        Provides metadata for available options contracts on supported
        exchanges, including exchange names, contract symbols, and data types
        (Order Book Events, Ticker, Trades, etc.) with associated data coverage
        periods.
      operationId: options-exchanges-pairs
      parameters:
        - name: exchange
          in: query
          description: >-
            **[Optional]** Only return data for the given exchange(s) (comma
            separated)
          schema:
            type: string
            default: deribit
        - name: instrument
          in: query
          description: Only return data for the given pair.
          schema:
            type: string
        - name: includeInactive
          in: query
          description: >-
            **[Optional]** If true, endpoint returns all instruments, including
            delisted ones. **[Defaults]** `True | False*`.
          schema:
            type: boolean
        - 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
        - name: size
          in: query
          description: >-
            **[Optional]** The number of records per page (only available when
            `includeInactive=true`).
          schema:
            type: integer
            format: int32
        - name: Accept-Encoding
          in: header
          required: true
          description: ''
          schema:
            type: string
            default: gzip, deflate, br
        - name: api-version
          in: header
          schema:
            type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Success:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      metadata:
                        next: >-
                          https://api.amberdata.com/markets/options/exchanges/information?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yAqhOXAA6sD2ATlkggKIAPKAAt0EAOZJyRUhWogcAWyQAxbkvRYiIJWBgwwlKBwgIZNYhq06AVuVMgardFKIBGGuTAAvAoQBWAAYggF8gA
                        api-version: '2023-09-30'
                      data:
                        - exchange: bybit
                          instrument: BTC-16AUG24-50000-C
                          openInterest:
                            startDate: 1721895646123
                            endDate: 1722297559023
                          orderBookSnapshot:
                            startDate: 1721895180679
                            endDate: 1722370735780
                          orderBookEvent:
                            startDate: 1721899231080
                            endDate: 1721946070781
                          ticker:
                            startDate: 1721895381123
                            endDate: 1722370799223
              schema:
                oneOf:
                  - title: Success
                    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:
                              next:
                                type: string
                                example: >-
                                  https://api.amberdata.com/markets/options/exchanges/information?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yAqhOXAA6sD2ATlkggKIAPKAAt0EAOZJyRUhWogcAWyQAxbkvRYiIJWBgwwlKBwgIZNYhq06AVuVMgardFKIBGGuTAAvAoQBWAAYggF8gA
                              api-version:
                                type: string
                                example: '2023-09-30'
                          data:
                            type: array
                            items:
                              type: object
                              properties:
                                exchange:
                                  type: string
                                  example: bybit
                                instrument:
                                  type: string
                                  example: BTC-16AUG24-50000-C
                                openInterest:
                                  type: object
                                  properties:
                                    startDate:
                                      type: integer
                                      example: 1721895646123
                                      default: 0
                                    endDate:
                                      type: integer
                                      example: 1722297559023
                                      default: 0
                                orderBookSnapshot:
                                  type: object
                                  properties:
                                    startDate:
                                      type: integer
                                      example: 1721895180679
                                      default: 0
                                    endDate:
                                      type: integer
                                      example: 1722370735780
                                      default: 0
                                orderBookEvent:
                                  type: object
                                  properties:
                                    startDate:
                                      type: integer
                                      example: 1721899231080
                                      default: 0
                                    endDate:
                                      type: integer
                                      example: 1721946070781
                                      default: 0
                                ticker:
                                  type: object
                                  properties:
                                    startDate:
                                      type: integer
                                      example: 1721895381123
                                      default: 0
                                    endDate:
                                      type: integer
                                      example: 1722370799223
                                      default: 0
      deprecated: false
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````