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

# List Quotes

> Retrieves a list of quotes based on specified criteria.

This endpoint allows querying for quotes with filters for base and counter assets,
as well as the type of quote (BUY or SELL).

You can specify a provider (e.g., "coinsph", "ebury") to get quotes from a specific provider.
If no provider is specified, "coinsph" is used as the default.

Some providers (like Ebury) require additional parameters:
- counter_amount: The amount of the counter currency that will be sold or bought
- target_country: ISO 3166-1 alpha-2 country code for the destination (determines KYC requirements)



## OpenAPI

````yaml service-openapi GET /v1/service/transfer/quote
openapi: 3.0.0
info:
  title: Service API
  version: 0.0.0
servers:
  - url: https://api.nxos.io
    description: single server endpoint
    variables: {}
security: []
tags: []
paths:
  /v1/service/transfer/quote:
    get:
      summary: List quotes
      description: >-
        Retrieves a list of quotes based on specified criteria.


        This endpoint allows querying for quotes with filters for base and
        counter assets,

        as well as the type of quote (BUY or SELL).


        You can specify a provider (e.g., "coinsph", "ebury") to get quotes from
        a specific provider.

        If no provider is specified, "coinsph" is used as the default.


        Some providers (like Ebury) require additional parameters:

        - counter_amount: The amount of the counter currency that will be sold
        or bought

        - target_country: ISO 3166-1 alpha-2 country code for the destination
        (determines KYC requirements)
      operationId: Transfer_listQuotes
      parameters:
        - name: request
          in: query
          required: true
          description: The criteria for filtering quotes.
          schema:
            $ref: '#/components/schemas/QuoteRequest'
      responses:
        '200':
          description: An array of Quote objects matching the specified criteria.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Quote'
components:
  schemas:
    QuoteRequest:
      type: object
      required:
        - base_asset
        - counter_asset
        - type
      properties:
        base_asset:
          type: string
          description: >-
            The base asset code for the quote, including scale (e.g., "USDT:6",
            "USD:2").

            Always include the scale to avoid ambiguity about the number of
            decimal places.
        counter_asset:
          type: string
          description: >-
            The counter asset code for the quote, including scale (e.g.,
            "EUR:2", "INR:2").

            Always include the scale to avoid ambiguity about the number of
            decimal places.
        type:
          allOf:
            - $ref: '#/components/schemas/QuoteType'
          description: The type of quote, either "BUY" or "SELL".
        counter_amount:
          type: string
          description: >-
            The counter_amount to be quoted (required for some providers like
            Ebury).

            This is the amount of the counter currency that will be sold or
            bought.
        provider:
          type: string
          description: |-
            The provider to use for the quote (e.g., "coinsph", "ebury").
            Defaults to "coinsph" if not specified.
        target_country:
          type: string
          description: |-
            The target country code (ISO 3166-1 alpha-2) for the transfer.
            Required for Ebury quotes to determine KYC requirements.
      description: Represents the request parameters for listing quotes.
    Quote:
      type: object
      required:
        - quote_id
        - base_asset
        - counter_asset
        - base_asset_tier
        - exchange_rate
        - fee
        - targets
        - expires_at
        - created_at
      properties:
        quote_id:
          type: string
          description: Unique identifier for the quote.
        base_asset:
          type: string
          description: The base asset code for the quote.
        counter_asset:
          type: string
          description: The counter asset code for the quote.
        base_asset_tier:
          allOf:
            - $ref: '#/components/schemas/BaseAssetTier'
          description: >-
            The tier information for the base asset, including min and max
            amounts.
        exchange_rate:
          type: string
          description: The exchange rate for the quote.
        fee:
          allOf:
            - $ref: '#/components/schemas/QuoteFee'
          description: The fee information for the quote.
        targets:
          type: array
          items:
            $ref: '#/components/schemas/Target'
          description: An array of potential targets for the transfer.
        expires_at:
          type: string
          description: The expiration time of the quote in ISO 8601 format.
        created_at:
          type: string
          description: The creation time of the quote in ISO 8601 format.
      description: Represents a quote for currency exchange.
    QuoteType:
      type: string
      enum:
        - BUY
        - SELL
      description: Represents the type of quote.
    BaseAssetTier:
      type: object
      properties:
        min_amount:
          type: string
          description: The minimum amount for this tier, if applicable.
        max_amount:
          type: string
          description: The maximum amount for this tier, if applicable.
      description: Represents the tier information for the base asset.
    QuoteFee:
      type: object
      required:
        - basis_points
        - fixed
      properties:
        basis_points:
          type: string
          description: The fee in basis points (1/100th of a percent).
        fixed:
          type: string
          description: The fixed fee amount.
      description: Represents the fee structure for a quote.
    Target:
      type: object
      required:
        - target_code
        - name
        - type
      properties:
        target_code:
          type: string
          description: The unique code for the target.
        name:
          type: string
          description: The name of the target.
        type:
          type: string
          description: The type of the target (e.g., bank, cash location).
        metadata:
          type: object
          additionalProperties:
            type: string
          description: Additional metadata associated with the target.
      description: Represents a target for the transfer, such as a bank or cash location.

````