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

> Returns essential reference details for Spot market trading pairs on supported exchanges, including symbols, market status, price and volume limits, cost and leverage constraints, precision requirements, and listing metadata.

<Tip>
  By default, instrument names are normalized to the `"base_quote"` format. If you wish to see the original exchange-native instrument names and details, set the `includeOriginalReference` parameter to `true` in your request. The response will then include an `originalReference` object with the exchange's native data for each instrument.
</Tip>


## OpenAPI

````yaml get /spot/exchanges/reference
openapi: 3.1.0
info:
  title: market-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets
security:
  - ApiKeyAuth: []
paths:
  /spot/exchanges/reference:
    get:
      summary: Reference
      description: >-
        Returns essential reference details for Spot market trading pairs on
        supported exchanges, including symbols, market status, price and volume
        limits, cost and leverage constraints, precision requirements, and
        listing metadata.
      operationId: spot-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 pairs, including
            delisted ones. **[Defaults]** `True | False*`.
          schema:
            type: boolean
        - name: includeOriginalReference
          in: query
          description: >-
            **[Optional]** If true, endpoint returns originalReference.
            **[Defaults]** `True | False*`.
          schema:
            type: boolean
        - 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/spot/exchanges/reference?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yA8gE5gDmkZASksUk0tAIkylGpFiIkAVQjk4AB3kB7JliQIAogA8oAC3QRWSckVIVqIHAFskAMRVX0WIiCtgYMMJShKICEzTEDk4uAFbkviA08uhGRACMNORgAF5CAKwADJkAvkA
                        api-version: '2023-09-30'
                      data:
                        - exchange: arkham
                          instrument: ada_usdt
                          baseSymbol: ada
                          quoteSymbol: usdt
                          market: spot
                          exchangeEnabled: true
                          limitsPriceMin: 0.0001
                          limitsPriceMax: 1000
                          limitsVolumeMin: 0.1
                          limitsVolumeMax: 900000
                          limitsMarketMin: null
                          limitsMarketMax: null
                          limitsLeverageMin: null
                          limitsLeverageMax: 0
                          limitsLeverageSuperMax: null
                          limitsCostMin: 5
                          limitsCostMax: null
                          precisionPrice: 0.0001
                          precisionVolume: 0.1
                          precisionBase: null
                          precisionQuote: null
                          listingTimestamp: null
              schema:
                oneOf:
                  - title: Success
                    type: object
                    properties:
                      status:
                        type: integer
                        example: 200
                      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/spot/exchanges/reference?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yA8gE5gDmkZASksUk0tAIkylGpFiIkAVQjk4AB3kB7JliQIAogA8oAC3QRWSckVIVqIHAFskAMRVX0WIiCtgYMMJShKICEzTEDk4uAFbkviA08uhGRACMNORgAF5CAKwADJkAvkA
                              api-version:
                                type: string
                                example: '2023-09-30'
                          data:
                            type: array
                            items:
                              type: object
                              properties:
                                exchange:
                                  type: string
                                  example: arkham
                                instrument:
                                  type: string
                                  example: ada_usdt
                                baseSymbol:
                                  type: string
                                  example: ada
                                quoteSymbol:
                                  type: string
                                  example: usdt
                                market:
                                  type: string
                                  example: spot
                                exchangeEnabled:
                                  type: boolean
                                  example: true
                                limitsPriceMin:
                                  type: number
                                  example: 0.0001
                                limitsPriceMax:
                                  type: number
                                  example: 1000
                                limitsVolumeMin:
                                  type: number
                                  example: 0.1
                                limitsVolumeMax:
                                  type: number
                                  example: 900000
                                limitsMarketMin:
                                  type: number
                                  nullable: true
                                  example: null
                                limitsMarketMax:
                                  type: number
                                  nullable: true
                                  example: null
                                limitsLeverageMin:
                                  type: number
                                  nullable: true
                                  example: null
                                limitsLeverageMax:
                                  type: number
                                  example: 0
                                limitsLeverageSuperMax:
                                  type: number
                                  nullable: true
                                  example: null
                                limitsCostMin:
                                  type: number
                                  example: 5
                                limitsCostMax:
                                  type: number
                                  nullable: true
                                  example: null
                                precisionPrice:
                                  type: number
                                  example: 0.0001
                                precisionVolume:
                                  type: number
                                  example: 0.1
                                precisionBase:
                                  type: number
                                  nullable: true
                                  example: null
                                precisionQuote:
                                  type: number
                                  nullable: true
                                  example: null
                                listingTimestamp:
                                  type: string
                                  nullable: true
                                  example: null
      deprecated: false
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````