> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gomaestro.org/llms.txt
> Use this file to discover all available pages before exploring further.

> Get recent trade data for a specific trading pair on a Cardano DEX with price and volume information.

# DEX and Pair Trades



## OpenAPI

````yaml cardano/market-price-api/openapi.json get /dexs/trades/{dex}/{pair}
openapi: 3.1.0
info:
  description: Market endpoints dedicated to Cardano DeFi protocols & Ingestor.
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.txt
  title: Cardano - Market Price API
  version: 0.1.0
servers:
  - description: Cardano Mainnet
    url: https://mainnet.gomaestro-api.org/v1/markets
  - description: Cardano Preprod
    url: https://preprod.gomaestro-api.org/v1/markets
  - description: Cardano Preview
    url: https://preview.gomaestro-api.org/v1/markets
security:
  - api-key: []
externalDocs:
  description: ''
  url: ''
paths:
  /dexs/trades/{dex}/{pair}:
    get:
      tags:
        - DEX
      summary: DEX and Pair Trades
      description: Returns raw trades for a specific DEX and token pair
      operationId: mkt-dex-trades
      parameters:
        - description: minswap
          in: path
          name: dex
          required: true
          schema:
            type: string
        - description: ADA-MIN
          in: path
          name: pair
          required: true
          schema:
            type: string
        - description: '2023-04-01'
          in: query
          name: from
          schema:
            type: string
        - description: '2023-05-15'
          in: query
          name: to
          schema:
            type: string
        - description: '10000'
          in: query
          name: limit
          schema:
            default: 5000
            maximum: 50000
            minimum: 1
            type: integer
        - description: desc
          in: query
          name: sort
          schema:
            enum:
              - asc
              - desc
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/api.DexTradesRespBody'
                type: array
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.APIError'
          description: Bad Request
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.APIError'
          description: Server Error
components:
  schemas:
    api.DexTradesRespBody:
      properties:
        a_to_b:
          description: 'Direction of trade (1: Coin B received, 0: Coin A received)'
          type: integer
        coin_a_price:
          description: Coin A price
          type: number
        coin_a_size:
          description: Coin A size
          type: number
        coin_b_price:
          description: Coin B price
          type: number
        coin_b_size:
          description: Coin B size
          type: number
        dex:
          description: DEX
          type: string
        pair:
          description: Pair
          type: string
        receiver_address:
          description: Receiver address
          type: string
        timestamp:
          description: Trade timestamp
          type: string
        transaction_hash:
          description: Transaction hash
          type: string
      type: object
    api.APIError:
      properties:
        error:
          description: Error returned from the API request
          example: Bad Request
          type: string
      type: object
  securitySchemes:
    api-key:
      description: Project API Key
      in: header
      name: api-key
      type: apiKey

````