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

# Reference

> Provides essential reference details for options contracts on supported exchanges, including contract symbols, underlying assets, strike prices, expiration dates, settlement types, price and volume limits, and precision requirements.



## OpenAPI

````yaml get /options/exchanges/reference
openapi: 3.1.0
info:
  title: market-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets
security:
  - ApiKeyAuth: []
paths:
  /options/exchanges/reference:
    get:
      summary: Reference
      description: >-
        Provides essential reference details for options contracts on supported
        exchanges, including contract symbols, underlying assets, strike prices,
        expiration dates, settlement types, price and volume limits, and
        precision requirements.
      operationId: options-exchanges-reference
      parameters:
        - name: exchange
          in: query
          description: >-
            **[Optional]** Only return data for the given exchange(s) (comma
            separated)
          schema:
            type: string
        - 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: size
          in: query
          description: >-
            **[Optional]** The number of records per page (only available when
            `includeInactive=true`).
          schema:
            type: integer
            format: int32
        - name: startDate
          in: query
          description: >-
            **[Optional]** Payload only includes instruments which have
            expiration after this date (inclusive). **[Formats]** `seconds |
            milliseconds | iso8601` **[Examples]** `1578531600 | 1578531600000 |
            2020-09-01T01:00:00`
          schema:
            type: string
            format: date-time
        - name: endDate
          in: query
          description: >-
            **[Optional]** Payload only includes instruments which have
            expiration before this date (exclusive). **[Formats]** `seconds |
            milliseconds | iso8601` **[Examples]** `1578531600 | 1578531600000 |
            2020-09-01T01:00:00`
          schema:
            type: string
            format: date-time
        - name: includeOriginalReference
          in: query
          description: >-
            **[Optional]** If true, endpoint returns originalReference.
            **[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: 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/reference?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yA8gE5gDmkZASksUk0tAIkylGpFiIkAVQjk4AB3kB7JliQIAogA8oAC3QRWSckVIVqIHAFskAMRVX0WIiCtgYMMJShKICEzTEDk4uAFbkviA08uhGRACMNORgAF5CAKwADJkAvkA
                        api-version: '2023-09-30'
                      data:
                        - exchange: bybit
                          instrument: BTC-16AUG24-50000-C
                          baseSymbol: BTC
                          quoteSymbol: USDC
                          market: options
                          exchangeEnabled: true
                          limitsPriceMin: 5
                          limitsPriceMax: 10000000
                          limitsVolumeMin: null
                          limitsVolumeMax: null
                          limitsMarketMin: 0.01
                          limitsMarketMax: 500
                          limitsLeverageMin: null
                          limitsLeverageMax: null
                          limitsLeverageSuperMax: null
                          limitsCostMin: null
                          limitsCostMax: null
                          precisionPrice: 5
                          precisionVolume: 0.01
                          precisionBase: null
                          precisionQuote: null
                          listingTimestamp: 1721894400000
                          contractUnderlying: BTC
                          contractExpirationTimestamp: 1723795200000
                          contractPeriod: weekly
                          contractSize: null
                          contractSettleType: option
                          contractSettleSymbol: USDC
                          optionType: call
                          optionStrikePrice: 50000
              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/reference?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yA8gE5gDmkZASksUk0tAIkylGpFiIkAVQjk4AB3kB7JliQIAogA8oAC3QRWSckVIVqIHAFskAMRVX0WIiCtgYMMJShKICEzTEDk4uAFbkviA08uhGRACMNORgAF5CAKwADJkAvkA
                              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
                                baseSymbol:
                                  type: string
                                  example: BTC
                                quoteSymbol:
                                  type: string
                                  example: USDC
                                market:
                                  type: string
                                  example: options
                                exchangeEnabled:
                                  type: boolean
                                  example: true
                                  default: true
                                limitsPriceMin:
                                  type: integer
                                  example: 5
                                  default: 0
                                limitsPriceMax:
                                  type: integer
                                  example: 10000000
                                  default: 0
                                limitsVolumeMin: {}
                                limitsVolumeMax: {}
                                limitsMarketMin:
                                  type: number
                                  example: 0.01
                                  default: 0
                                limitsMarketMax:
                                  type: integer
                                  example: 500
                                  default: 0
                                limitsLeverageMin: {}
                                limitsLeverageMax: {}
                                limitsLeverageSuperMax: {}
                                limitsCostMin: {}
                                limitsCostMax: {}
                                precisionPrice:
                                  type: integer
                                  example: 5
                                  default: 0
                                precisionVolume:
                                  type: number
                                  example: 0.01
                                  default: 0
                                precisionBase: {}
                                precisionQuote: {}
                                listingTimestamp:
                                  type: integer
                                  example: 1721894400000
                                  default: 0
                                contractUnderlying:
                                  type: string
                                  example: BTC
                                contractExpirationTimestamp:
                                  type: integer
                                  example: 1723795200000
                                  default: 0
                                contractPeriod:
                                  type: string
                                  example: weekly
                                contractSize: {}
                                contractSettleType:
                                  type: string
                                  example: option
                                contractSettleSymbol:
                                  type: string
                                  example: USDC
                                optionType:
                                  type: string
                                  example: call
                                optionStrikePrice:
                                  type: integer
                                  example: 50000
                                  default: 0
      deprecated: false
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````