post https://api-pro.sim.hashkeydev.com/api/v1/convertCurrency/getQuote
Get the quote for currency conversion. Must get quote before requesting a currency conversion order
Weight: 100 times / second
Request Parameters
| Parameter | Type | Req'd | Example1 | Example2 | Description |
|---|---|---|---|---|---|
| buyCcy | STRING | Y | BTC | USD | The base currency which the client wants to buy |
| sellCcy | STRING | Y | USD | BTC | The quote currency which the client wants to sell |
| buyAmount | DECIMAL | Conditional | 2 | 130000 | The amount of base currency to be purchased. - Please enter either buyAmount or sellAmount |
| sellAmount | DECIMAL | Conditional | 130000 | 2 | The amount of quote currency to be sold. - Please enter either buyAmount or sellAmount |
Response Content
| Parameter | Type | Example Values | Description |
|---|---|---|---|
| quoteId | STRING | RFQ638459562162049024 | A unique reference ID for this quote. |
| quoteClOrderId | STRING | RFQ12345666 | (Optional) An ID defined by the client for the quote order. It will be automatically generated if not sent in the request. |
| buyCcy | STRING | BTC | Currency or coin to buy. |
| sellCcy | STRING | USDT | Currency or coin to sell. |
| buyPrice | DECIMAL | 130000/2 = 65000 (usdt/ btc) | Buy price in quote currency. |
| sellPrice | DECIMAL | 2 / 130000 = 0.000015384615 (btc/usdt) | Sell price in quote currency. |
| buyAmount | DECIMAL | 2 (btc) | The amount of base / buy currency to be purchased. |
| sellAmount | DECIMAL | 130000 (usdt) | The amount of quote / sell currency to be sold. |
| rate | DECIMAL | 7.79375 | Indicative rate. |
| quoteCreatedTime | LONG | 1725222781 | Rates are effective as of this timestamp. |
| quoteExpiryTime | LONG | 1725222836 | Rates are valid until this timestamp. |