Request a Quote

Before you begin, it is highly recommended to review the Trade start page, as it explains some of the terms used here as well, in case you haven't seen it yet.

What does this endpoint do?

The objective of this endpoint is to allow users to request a quote for currency conversions. The generated quote has a predefined lifetime, within which it must be accepted for the conversion to be successful. If the time limit is exceeded, the quote will be rejected.

Upon using this endpoint, it returns the equivalent amount in the target currency for the specified value in the provided currency, as well as an identifier to be used in subsequent operations. This type of quote operation is known as Over-The-Counter (OTC).

In other words, the baseCurrencySize and quoteCurrencySize represent the comparative value between the two currencies being traded. For example, if you are buying U.S. dollars (USD) with Brazilian reais (BRL), and one U.S. dollar equals five reais, the baseCurrencySize in the request should be set to 1, and the quoteCurrencySize should be set to 0. In any case, both parameters cannot be filled at the same time.

Here are some example use cases to better illustrate how to use this endpoint:

• Case 1: You want to sell 49.67 USDT and buy Brazilian reais (BRL) to find out how much BRL will be traded. The payload could look like the following:

{
    "baseCurrency": "USDT",
    "quoteCurrency": "BRL",
    "baseCurrencySize": 49.67,
    "quoteCurrencySize": 0,
    "side": "sell"
}

{
    "baseCurrency": "BRL",
    "quoteCurrency": "USDT",
    "baseCurrencySize": 0,
    "quoteCurrencySize": 49.67,
    "side": "buy"
}

• Case 2: You want to sell USDT and buy the equivalent amount of 100.00 BRL, knowing how much USDT is required for the transaction. The payload could be as follows:

{
    "baseCurrency": "USDT",
    "quoteCurrency": "BRL",
    "baseCurrencySize": 0,
    "quoteCurrencySize": 100,
    "side": "sell"
}

{
    "baseCurrency": "BRL",
    "quoteCurrency": "USDT",
    "baseCurrencySize": 100,
    "quoteCurrencySize": 0,
    "side": "buy"
}

It is important to note that the typical flow of this endpoint involves using the provided quote in the Make a Trade endpoint for currency conversion. However, this endpoint can also be used in other flows.

If you provide the optional parameters (taxId and taxIdCountry), they will be validated during the "Make a Trade" process to ensure they match those from the requested quote.