Convert Estimate

Request a price estimate for converting one asset into another before confirming the swap.

POST /api/v4/convert/estimate

cURL

estimateReceive

curl --request POST \ --url https://whitebit.com/api/v4/convert/estimate \ --header 'Content-Type: application/json' \ --header 'X-TXC-APIKEY: <api-key>' \ --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 }

Authorizations

X-TXC-APIKEY · string · header · required

API Key authentication for private endpoints.

Required headers:

• X-TXC-APIKEY: API key
• X-TXC-PAYLOAD: Base64 encoded JSON payload
• X-TXC-SIGNATURE: HMAC SHA512 signature

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

Example:

1699260637

request · string

Request path

Example:

"{{request}}"

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