This endpoint returns the approximate quote for Buy or Sell trades, depending on the parameters specified in the API request. The API response contains the approximated value the customer will receive for the (buy or sell) trade they intend to create.
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. |
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 | string | Currency of the |
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. |
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 |
quoteAmount | float | The approximated amount the customer will receive on trade completion.
|
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 , ( |
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. |
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 |
currency | string | Outgoing transfer currency. |
The endpoint enables fetching two different types of Buy Trade approximate 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.
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.mediumandtransferOut.mediumhave to be provided for transfer fees to be included.