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

# Get Quotes By Chain And Address

> Get CEX/DEX quotes using token chain/address pairs.

Resolves both tokens via `dex.getToken` and runs the same quote flow as v2 quote endpoint.



## OpenAPI

````yaml https://api-partner.houdiniswap.com/v2/openapi.json get /quotes/byChainAddress
openapi: 3.0.0
info:
  title: houdiniswap-backend
  version: 2.1.1
  description: Houdiniswap Backend
  license:
    name: ISC
  contact: {}
servers:
  - url: https://api-partner.houdiniswap.com/v2
security: []
paths:
  /quotes/byChainAddress:
    get:
      tags:
        - Quotes
      summary: Get Quotes By Chain And Address
      description: >-
        Get CEX/DEX quotes using token chain/address pairs.


        Resolves both tokens via `dex.getToken` and runs the same quote flow as
        v2 quote endpoint.
      operationId: GetQuotesByChainAddress
      parameters:
        - description: >-
            Amount of the `from` token to swap as a decimal float in the token's
            display units

            (e.g. `1.5` BTC, `250.75` USDT) — not a base-units / wei integer
            like `100000000000000`.

            Must be strictly greater than 0 and at most the maximum BSON Double
            value

            (`Number.MAX_VALUE` ≈ 1.7976931348623157e308).
          in: query
          name: amount
          required: true
          schema:
            format: double
            type: number
            minimum: 0
            maximum: 1.7976931348623157e+308
        - in: query
          name: fromChain
          required: true
          schema:
            type: string
        - in: query
          name: toChain
          required: true
          schema:
            type: string
        - in: query
          name: fromTokenAddress
          required: false
          schema:
            type: string
        - in: query
          name: toTokenAddress
          required: false
          schema:
            type: string
        - description: Slippage percentage, only used for decentralized swaps.
          in: query
          name: slippage
          required: false
          schema:
            format: double
            type: number
            minimum: 0
            maximum: 100
        - in: query
          name: useXmr
          required: false
          schema:
            type: boolean
        - description: >-
            Maximum price deviation percentage when rotating wallets. Only used
            if rotatePayoutWallets is true. Default 5
          in: query
          name: deviationThreshold
          required: false
          schema:
            format: double
            type: number
            minimum: 0
            maximum: 100
        - description: >-
            Number of recent orders to check for path rotation. Only used if
            rotatePayoutWallets is true. Default 10
          in: query
          name: rotationLookback
          required: false
          schema:
            format: double
            type: number
            minimum: 1
            maximum: 100
        - in: query
          name: rotatePayoutWallets
          required: false
          schema:
            type: boolean
        - in: query
          name: types
          required: false
          schema:
            items:
              $ref: '#/components/schemas/QuoteType'
            type: array
        - in: query
          name: swaps
          required: false
          schema:
            items:
              $ref: '#/components/schemas/ExchangeType'
            type: array
        - description: |-
            Allowlist for the in-leg of anonymous (private, 2-hop) paths.
            When set, only these providers may be used as the in-leg.
            Ignored for STANDARD and DEX quote types.
          in: query
          name: inLegIncludedSwaps
          required: false
          schema:
            items:
              type: string
            type: array
        - description: >-
            Providers excluded from the in-leg of anonymous (private, 2-hop)
            paths.

            Does not affect the out-leg. Ignored for STANDARD and DEX quote
            types.
          in: query
          name: inLegExcludedSwaps
          required: false
          schema:
            items:
              type: string
            type: array
        - description: |-
            Allowlist for the out-leg of anonymous (private, 2-hop) paths.
            When set, only these providers may be used as the out-leg.
            Ignored for STANDARD and DEX quote types.
          in: query
          name: outLegIncludedSwaps
          required: false
          schema:
            items:
              type: string
            type: array
        - description: >-
            Providers excluded from the out-leg of anonymous (private, 2-hop)
            paths.

            Does not affect the in-leg. Ignored for STANDARD and DEX quote
            types.
          in: query
          name: outLegExcludedSwaps
          required: false
          schema:
            items:
              type: string
            type: array
        - in: query
          name: senderAddress
          required: false
          schema:
            type: string
        - in: query
          name: receiverAddress
          required: false
          schema:
            type: string
        - in: query
          name: sort
          required: false
          schema:
            $ref: '#/components/schemas/QuoteSort'
        - in: query
          name: sortOrder
          required: false
          schema:
            $ref: '#/components/schemas/SortDirection'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuoteResultV2'
        '404':
          description: Token not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - apiKey: []
components:
  schemas:
    QuoteType:
      enum:
        - private
        - standard
        - dex
      type: string
    ExchangeType:
      type: string
      enum:
        - ch
        - cl
        - cn
        - el
        - le
        - se
        - ss
        - sz
        - sp
        - eb
        - nx
        - cc
        - qx
        - tc
        - sw
        - dl
        - ad
        - wh
        - cf
        - un
        - jp
        - mn
        - rd
        - ps
        - cs
        - kd
        - ct
        - zx
        - wc
        - su
        - bd
        - tt
        - sd
        - bg
        - ab
    QuoteSort:
      enum:
        - amountOut
        - amountOutUsd
        - duration
      type: string
    SortDirection:
      enum:
        - asc
        - desc
      type: string
    QuoteResultV2:
      properties:
        quotes:
          items:
            $ref: '#/components/schemas/QuoteV2'
          type: array
        total:
          type: number
          format: double
      required:
        - quotes
        - total
      type: object
      additionalProperties: false
    ErrorResponse:
      properties:
        message:
          type: string
        code:
          type: string
        requestId:
          type: string
      required:
        - message
        - code
      type: object
      additionalProperties: false
    ValidationError:
      properties:
        message:
          type: string
        code:
          type: string
        requestId:
          type: string
        fields:
          $ref: '#/components/schemas/FieldErrors'
      required:
        - message
        - code
        - fields
      type: object
      additionalProperties: false
    QuoteV2:
      properties:
        swap:
          type: string
        quoteId:
          type: string
        duration:
          type: number
          format: double
        gas:
          type: number
          format: double
        gasUsd:
          type: number
          format: double
        amountIn:
          type: number
          format: double
        amountOut:
          type: number
          format: double
        amountOutUsd:
          type: number
          format: double
        feeUsd:
          type: number
          format: double
        bridgeFeeUsd:
          type: number
          format: double
        netAmountOut:
          type: number
          format: double
        error:
          type: string
        swapName:
          type: string
        type:
          $ref: '#/components/schemas/QuoteType'
        filtered:
          type: boolean
          default: false
        supportsSignatures:
          type: boolean
        logoUrl:
          type: string
        markupSupported:
          type: boolean
        slippageSupported:
          type: boolean
        apiMarkupValue:
          type: number
          format: double
        markupType:
          type: string
          enum:
            - absolute
            - percentage
            - bp
        restrictedCountries:
          items:
            type: string
          type: array
        rewardsAvailable:
          type: boolean
        min:
          type: number
          format: double
        max:
          type: number
          format: double
        rateId:
          type: string
        fixed:
          type: boolean
        validUntil:
          type: string
        requiresApproval:
          type: boolean
        isPriority:
          type: boolean
        refundAddress:
          type: string
      type: object
      additionalProperties: false
    FieldErrors:
      properties: {}
      type: object
      additionalProperties:
        properties:
          value: {}
          message:
            type: string
        required:
          - message
        type: object
  securitySchemes:
    apiKey:
      type: apiKey
      name: Authorization
      in: header

````