This endpoint enables the end-user to fetch a price quote, i.e. exchange rate for a given pair of currencies.
The endpoint returns the quote ID which is used for creating an actual trade.
Before actually creating a trade, a valid price quote must be created.
When creating a trade, a valid and non-expired price quote ID has to be provided. The created trade will use the rate given in the specified quote.
Please check the next page to see the description of the Trade price quote response body.
Different quote types for the Trades:
This API allows you to create Buy trades where:
- all the applicable fees are included in the amount requested by the end-user
- all the applicable fees are added on top of the amount requested by the end user
Check the Fees Included and Fees on top section, respectively, depending on your desired setup.
Good to know:
Currently, when paying for a Buy trade with a credit card, the price quote is valid for 15 minutes after being issued.
In case of Sell trades, all supported cryptocurrencies, except stablecoins, also have a price quote valid for 15 minutes. While stablecoins' price quote is
Important:
The price quote is only valid for the end-user/trader that requested it. You will receive an error if you try to create a trade using a price quote requested by another trader.
The following table exemplifies how baseCurrency and quoteCurrency should be interpreted (see API request parameters below):
baseCurrency | quoteCurrency | baseAmount | Interpretation |
|---|---|---|---|
"USD" | "BTC" | 123.45 | I want to buy 123.45 USD for BTC. |
"USD" | "BTC" | -123.45 | I want to sell 123.45 USD for BTC. |
"BTC" | "USD" | 1.5 | I want to buy 1.5 BTC for USD. |
"BTC" | "USD" | -1.5 | I want to sell 1.5 BTC for USD. |