Convert Estimate

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

Rate limit: 10000 requests/10 sec.

POST /api/v4/convert/estimate

cURL

estimateReceive

curl --request POST \ --url https://whitebit.com/api/v4/convert/estimate \ --header 'Content-Type: application/json' \ --data ' { "amount": "35,103.1", "direction": "to", "from": "BTC", "to": "USDT" } '

200

Example

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

Body

application/json

from · string · required

From currency. Example: BTC

Example:

"BTC"

to · string · required

To currency. Example: USDT

Example:

"USDT"

direction · enum<string> · 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

Available options: from, to

Example:

"to"

amount · string · required

Amount to convert or receive.

Example:

"35,103.1"

nonce · integer

Nonce for request

request · string

Request path

Response

200

application/json

Successful response

id · string

Quote ID

Example:

"123"

from · string

From currency

Example:

"BTC"

to · string

To currency

Example:

"USDT"

give · string

Amount to give

Example:

"50"

receive · string

Amount to receive

Example:

"1714988.41577452"

rate · string

Conversion rate

Example:

"34299.76831549"

expireAt · integer

Quote expiration timestamp

Example:

1699016476