Sign in

v1

latestOpenAPI 3.0.32026-07-2613529376.3 KB

Convert Estimate

The endpoint creates a quote for converting one currency to another. Quote lifetime is 10 seconds, then quote will be expired.

The minimum convert size is derived from the resulting proceeds, not a fixed per-pair floor: a request is rejected as too small when rate × amount rounds to zero in the target currency. Account balance is pre-checked at estimate time and re-checked at confirm time, because balance can change within the 10-second quote window. There is an absolute server-side maximum on the conversion amount.

<Note> The endpoint can be used to obtain a pre-execution price estimate for a market order. Call the endpoint with the desired amount before placing a market order to see the approximate execution price. </Note> <Note> Error `message` values may be returned as translation keys (for example `validation.required`) rather than finalized English strings. Treat the `code` and the field name under `errors` as the stable contract. </Note> <Warning> Rate limit: 10000 requests/10 sec. </Warning>
post/api/v4/convert/estimate

Request body

fromstring required

From currency. Example: BTC

tostring required

To currency. Example: USDT

direction'from' | 'to' required

Convert amount direction, defines in which currency corresponding "amount" field is populated. Use "to" in case amount is in "to" currency, use "from" if amount is in "from" currency

amountstring required

Amount to convert or receive. The value is silently truncated to 8 decimal places before evaluation; excess decimals do not raise an error.

nonceinteger

Nonce for request

requeststring

Request path

Example request

{
  "from": "BTC",
  "to": "USDT",
  "direction": "to",
  "amount": "35,103.1",
  "nonce": 1699260637,
  "request": "{{request}}"
}

Response

Successful response

idstring

Quote ID

fromstring

From currency

tostring

To currency

givestring

Amount to give

receivestring

Amount to receive

ratestring

Conversion rate expressed in the from→to direction: units of the 'to' currency received per one unit of the 'from' currency. Example: if from=BTC and to=USDT, a rate of "34299.76" means 1 BTC is worth approximately 34 299.76 USDT at the time of the quote.

expireAtinteger

Quote expiration timestamp

Example response

{
  "id": "123",
  "from": "BTC",
  "to": "USDT",
  "give": "50",
  "receive": "1714988.41577452",
  "rate": "34299.76831549",
  "expireAt": 1699016476
}