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

# Compare DEX Routes

> Prices a swap against every supported DEX and returns the valid routes ordered by output amount.



## OpenAPI

````yaml /api-reference/openapi.json post /quotes/routes
openapi: 3.0.0
info:
  description: |-
    DEX aggregation and swap-quote API for EVM chains.
    Maintains a catalogue of blockchains, tokens, DEXes and liquidity
    pools, and serves executable swap quotes built from on-chain AMM data.
  title: uatu API
  contact: {}
  version: 0.1.0
servers:
  - url: https://api.uatu.dev
    description: Hosted API
  - url: http://localhost:8080
    description: Self-hosted instance (set PORT in your environment)
security: []
tags:
  - name: quotes
    description: Price a swap and get the calldata needed to execute it.
  - name: catalogue
    description: Discover the chains, tokens, DEXes and pools uatu knows about.
paths:
  /quotes/routes:
    post:
      tags:
        - quotes
      summary: Compare DEX Routes
      description: >-
        Prices a swap against every supported DEX and returns the valid routes
        ordered by output amount.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/uatu.QuoteRequest'
        description: request body to compare DEX quotes
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/server.APIResponse'
                  - type: object
                    properties:
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/uatu.RouteQuote'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/server.APIResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/server.APIResponse'
components:
  schemas:
    uatu.QuoteRequest:
      type: object
      required:
        - amount
        - chain
        - chainId
        - recipientAddress
        - tokenIn
        - tokenOut
      properties:
        amount:
          type: string
        chain:
          type: string
        chainId:
          type: integer
        recipientAddress:
          type: string
        tokenIn:
          type: string
        tokenOut:
          type: string
    server.APIResponse:
      type: object
      required:
        - message
      properties:
        code:
          type: integer
        data: {}
        message:
          type: string
    uatu.RouteQuote:
      type: object
      properties:
        amountIn:
          type: string
        amountOut:
          type: string
        deadline:
          type: integer
        route:
          $ref: '#/components/schemas/uatu.Route'
        tokenIn:
          $ref: '#/components/schemas/uatu.Token'
        tokenOut:
          $ref: '#/components/schemas/uatu.Token'
    uatu.Route:
      type: object
      properties:
        dex:
          type: string
        fees:
          description: Fees is the route fee in the input token's smallest unit.
          type: string
        logo:
          type: string
        name:
          type: string
    uatu.Token:
      type: object
      properties:
        address:
          type: string
        blockchainId:
          type: integer
        decimals:
          type: integer
        logo:
          type: string
        name:
          type: string
        slug:
          type: string
        symbol:
          type: string

````