> ## 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 comprehensive reference data for futures instruments across exchanges, including details on base and quote symbols, price and volume limits, precision, contract terms, and trading availability.

<Tip>
  ### precisionVolume

  Occasionally, you may encounter a value of `0` for `precisionVolume`. This is due to the underlying exchange returning 0 for the instrument's trade size precision.

  We have noticed this behavior with several instruments on Kraken.
</Tip>


## OpenAPI

````yaml get /futures/exchanges/reference
openapi: 3.1.0
info:
  title: market-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets
security:
  - ApiKeyAuth: []
paths:
  /futures/exchanges/reference:
    get:
      summary: Reference
      description: >-
        Provides comprehensive reference data for futures instruments across
        exchanges, including details on base and quote symbols, price and volume
        limits, precision, contract terms, and trading availability.
      operationId: futures-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: underlying
          in: query
          description: >-
            **[Optional]** Filter for instruments whose underlying matches the
            value given.   **[Examples]** btc | ETH
          schema:
            type: string
        - name: expiration
          in: query
          description: >-
            **[Optional]** Filter for instruments that expire on the specified
            date.   **[Example]** 2024-08-01
          schema:
            type: string
            format: date-time
        - name: contractType
          in: query
          description: >-
            **[Optional]** Filter for instruments that match the contract type
            specified.   **[Examples]** yearly | quarterly | monthly | weekly |
            daily | perpetual | prediction
          schema:
            type: string
        - 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/futures/exchanges/reference?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yA8gE5gDmkZASksUk0tAIkylGpFiIkAVQjk4AB3kB7JliQIAogA8oAC3QRWSckVIVqIHAFskAMRVX0WIiCtgYMMJShKICEzTEDk4uAFbkviA08uhGRACMNORgAF5CAKwADJkAvkA
                        api-version: '2023-09-30'
                      data:
                        - exchange: binance
                          instrument: 1000BONKUSDC
                          baseSymbol: 1000BONK
                          quoteSymbol: USDC
                          market: futures
                          exchangeEnabled: true
                          limitsPriceMin: 0.000001
                          limitsPriceMax: 200
                          limitsVolumeMin: 1
                          limitsVolumeMax: 10000000
                          limitsMarketMin: 1
                          limitsMarketMax: 2000000
                          limitsLeverageMin: null
                          limitsLeverageMax: null
                          limitsLeverageSuperMax: null
                          limitsCostMin: null
                          limitsCostMax: null
                          precisionPrice: 0.000001
                          precisionVolume: 1
                          precisionBase: 1.e-8
                          precisionQuote: 1.e-8
                          listingTimestamp: null
                          contractUnderlying: 1000BONK
                          contractExpirationTimestamp: null
                          contractPeriod: perpetual
                          contractSize: null
                          contractSettleType: linear
                          contractSettleSymbol: null
              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/futures/exchanges/reference?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yA8gE5gDmkZASksUk0tAIkylGpFiIkAVQjk4AB3kB7JliQIAogA8oAC3QRWSckVIVqIHAFskAMRVX0WIiCtgYMMJShKICEzTEDk4uAFbkviA08uhGRACMNORgAF5CAKwADJkAvkA
                              api-version:
                                type: string
                                example: '2023-09-30'
                          data:
                            type: array
                            items:
                              type: object
                              properties:
                                exchange:
                                  type: string
                                  example: binance
                                instrument:
                                  type: string
                                  example: 1000BONKUSDC
                                baseSymbol:
                                  type: string
                                  example: 1000BONK
                                quoteSymbol:
                                  type: string
                                  example: USDC
                                market:
                                  type: string
                                  example: futures
                                exchangeEnabled:
                                  type: boolean
                                  example: true
                                  default: true
                                limitsPriceMin:
                                  type: number
                                  example: 0.000001
                                  default: 0
                                limitsPriceMax:
                                  type: integer
                                  example: 200
                                  default: 0
                                limitsVolumeMin:
                                  type: integer
                                  example: 1
                                  default: 0
                                limitsVolumeMax:
                                  type: integer
                                  example: 10000000
                                  default: 0
                                limitsMarketMin:
                                  type: integer
                                  example: 1
                                  default: 0
                                limitsMarketMax:
                                  type: integer
                                  example: 2000000
                                  default: 0
                                limitsLeverageMin: {}
                                limitsLeverageMax: {}
                                limitsLeverageSuperMax: {}
                                limitsCostMin: {}
                                limitsCostMax: {}
                                precisionPrice:
                                  type: number
                                  example: 0.000001
                                  default: 0
                                precisionVolume:
                                  type: integer
                                  example: 1
                                  default: 0
                                precisionBase:
                                  type: number
                                  example: 1.e-8
                                  default: 0
                                precisionQuote:
                                  type: number
                                  example: 1.e-8
                                  default: 0
                                listingTimestamp: {}
                                contractUnderlying:
                                  type: string
                                  example: 1000BONK
                                contractExpirationTimestamp: {}
                                contractPeriod:
                                  type: string
                                  example: perpetual
                                contractSize: {}
                                contractSettleType:
                                  type: string
                                  example: linear
                                contractSettleSymbol: {}
      deprecated: false
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````