> ## 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 detailed metadata for available trading pairs on supported Spot market exchanges, including exchange names, trading instruments, and available data types (OHLCV, Order Book Snapshots, Order Book Events, Ticker, and Trades) with respective data availability periods.



## OpenAPI

````yaml get /spot/exchanges/information
openapi: 3.1.0
info:
  title: market-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets
security:
  - ApiKeyAuth: []
paths:
  /spot/exchanges/information:
    get:
      summary: Instruments
      description: >-
        Provides detailed metadata for available trading pairs on supported Spot
        market exchanges, including exchange names, trading instruments, and
        available data types (OHLCV, Order Book Snapshots, Order Book Events,
        Ticker, and Trades) with respective data availability periods.
      operationId: get-market-exchanges
      parameters:
        - name: exchange
          in: query
          description: only return data for the given exchanges (comma separated)
          schema:
            type: string
        - name: instrument
          in: query
          description: Only return data for the given pair.
          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: includeInactive
          in: query
          description: >-
            **[Optional]** If true, endpoint returns all instruments, including
            delisted ones.  **[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/information?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcWATnEgDTjTzICqEAznAA4sD2JWSCAogB5QAFuggBzJIyIAzdDEaUQOALZIAYp2XosREMrAwYYBVHYQEUqtM3bdAK0ZmQVFuglEAjFUZgAXgUIAVgAGYIBfIA
                        api-version: '2023-09-30'
                      data:
                        - exchange: binance
                          instrument: 1000cat_bnb
                          active: true
                          ohlcv:
                            startDate: 1734393600000
                            endDate: 1739750400000
                          orderBookSnapshot:
                            startDate: 1734427800000
                            endDate: 1739895780000
                          orderBookEvent:
                            startDate: 1734426029092
                            endDate: 1739895599692
                          ticker:
                            startDate: 1734426147738
                            endDate: 1739895595115
                          trade:
                            startDate: 1734426214300
                            endDate: 1739894107524
                        - exchange: binance
                          instrument: 1000cat_fdusd
                          active: true
                          ohlcv:
                            startDate: 1734393600000
                            endDate: 1739750400000
                          orderBookSnapshot:
                            startDate: 1734427800000
                            endDate: 1739895780000
                          orderBookEvent:
                            startDate: 1734426029293
                            endDate: 1739895599593
                          ticker:
                            startDate: 1734426145880
                            endDate: 1739895592405
                          trade:
                            startDate: 1734426221718
                            endDate: 1739895250067
              schema:
                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: {}
                      data:
                        type: object
                        properties:
                          gdax:
                            type: object
                            properties:
                              00_usd:
                                type: object
                                properties:
                                  ohlc:
                                    type: object
                                    properties:
                                      startDate:
                                        type: integer
                                        example: 1665508560000
                                        default: 0
                                      endDate:
                                        type: integer
                                        example: 1722369180000
                                        default: 0
                                  order_book_update:
                                    type: object
                                    properties:
                                      startDate:
                                        type: integer
                                        example: 1665507779045
                                        default: 0
                                      endDate:
                                        type: integer
                                        example: 1722368954000
                                        default: 0
                                  order_book:
                                    type: object
                                    properties:
                                      startDate:
                                        type: integer
                                        example: 1665510000000
                                        default: 0
                                      endDate:
                                        type: integer
                                        example: 1722369300000
                                        default: 0
                                  ticker:
                                    type: object
                                    properties:
                                      startDate:
                                        type: integer
                                        example: 1665508608000
                                        default: 0
                                      endDate:
                                        type: integer
                                        example: 1722366995000
                                        default: 0
                                  trade:
                                    type: object
                                    properties:
                                      startDate:
                                        type: integer
                                        example: 1665508608000
                                        default: 0
                                      endDate:
                                        type: integer
                                        example: 1722366995000
                                        default: 0
      deprecated: false
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````