🚧
Important:
The approximated value is not the guaranteed value the customer will receive if they create the trade. However, the approximated quote strives to be as close to the actual final quote as possible based on the available data.

Request Parameters

These are all the available query parameters for the Approximate quote endpoint and their description (Note: depending on the type of the quote you want to fetch, you will not use all the available parameters in your requests):

Property	Type	Description
baseAmount	float	Amount to get a price quote for. Used forFees-on-top buy quotes and sell quotes. It's the amount the customer specified to spend for the trade. Denominated in `baseCurrency`.
baseCurrency	string	Currency to get a quote for.
sendAmount	float	Amount to get a price quote for. Used only when fetching theFees Included buy quote. Denominated in `sendCurrency`.
sendCurrency	string	Currency of the `sendAmount`.
quoteCurrency	string	Currency to get the quote for. It's the currency the customer requested to receive.
transferInMedium	string	Transfer in medium. Specifies the incoming transaction type. See payment methods .
transferOutMedium	string	Transfer out medium. Specifies the outgoing transaction type. See payment methods

Response Parameters

These are all the available response parameters received from the Approximate Quote API endpoint:

📘
Note:
Depending on the type of the quote you're fetching and query parameters used in the request, some of the parameters might not be present in the API response. See the actual quote examples in the next two pages for more clarity.

Property	Type	Description
baseAmount	float	In the Fees-on-top type of request, represents the requested amount that customer specified to send. See how to do Fees-on-top price quote. In the Fees Includedtype of request, represents the amount that is passed to the Trade Widget's URL`buyAmfount` parameter in case of Trade Widget integration, or as the `baseAmount` parameter value in the Request Trade Price Quote API call in case of full Trade API integration. See how to do Fees Included approximate quote.
baseCurrency	string	Base currency that customer specified to send.
sendAmount	float	Represents the amount the customer specified to send for a trade. Available in the response only when fetchingFees Included buy quote.
sendCurrency	string	Currency of the `sendAmount`. Available only in theFees Included buy quote.
quoteAmount	float	The approximated amount the customer will receive on trade completion. Use this value to show the final approximated quote the customer will receive when fetching the Fees-on-top price quote*, (`transferOut.feeAmount` included in the amount). When fetching the Fees Included buy quote, this value represents the quote for the requested currency, before the `transferOut.feeAmount` has been deducted.
quoteCurrency	string	Currency the customer specified to receive.
receiveAmount	float	The approximated amount the customer will receive on trade completion.Use this value to show to the customer the final approximated quote they will receive for the specified trade when fetchingFees Included buy quote , (`transferOut.feeAmount` included in the amount)
receiveCurrency	string	Currency the customer specified to receive. Available only in theFees Included buy quote.ß
transferIn	object	Object with details of the incoming transaction method (from the customer).
medium	string	Type of the incoming transfer type (payment method) from the customer. Get available payment method types and supported currencies here.
feeAmount	float	Incoming transfer fee. Added on top of `buyAmfount` /`baseAmount` on checkout in case of Fees-on-top price quote. Deducted from the `buyAmount`/`baseAmount` specified by the customer in case of Fees Included price quote.
currency	string	Incoming transfer currency.
transferOut	object	Object with details of the outgoing transfer method (to the customer).
medium	string	Type of the outgoing transfer type (payment method) to the customer. Get available payment method types and supported currencies here .
feeAmount	float	Outgoing transfer fee. Already included in the `quoteAmount`/`receiveAmount`
currency	string	Outgoing transfer currency.

The endpoint enables fetching two different types of Buy Trade approximate quote:

1. Fees-included quote

📘
This flow ensures that the customer only pays the FIAT amount they have specified, with all the fees included in that amount.

In this quote type, the payment processing fee and your Partner fee (if applicable) are deducted from the FIAT amount the customer requested. The FIAT amount, after fees have been deducted, is converted to the cryptocurrency the customer specified to buy. The customer will spend exactly the FIAT amount they requested.

2. Fees-on-top quote

📘
This flow ensures that the custmer receives the cryptocurrency equivalent of the FIAT amount they specify to spend.

In this scenario, both the payment processing fee (e.g., card or bank transfer fee) and your Partner fee (if applicable) are added on top of the total FIAT amount requested by the end user.

For example, if a customer wants to purchase 200 USD worth of USDT and the processing fee is 6 USD, the API returns the USD-to-USDT conversion for 200 USD, with the network transaction fee (transferOut.feeAmount) already deducted from the quoteAmount returned in the API response.
At checkout, the customer will be charged the sum of the baseAmount and the processing fee (transferIn.feeAmount). In this case, the customer pays a total of 206 USD and receives approximately 198.95 USDT after the network transaction fee has been deducted.

See trade quote for details and explanation of how to create an actual quote you can use to create a trade.

🚧
Caution:
Both transferIn.medium and transferOut.medium have to be provided for transfer fees to be included.