Convert Estimate

The 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.

Estimating market order prices: Use this endpoint to get an approximate price for market-size orders before execution. The returned rate and receive fields show the effective conversion rate and expected amount, which can serve as a price estimation for equivalent market orders.

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