---
title: "Convert Estimate"
method: POST
path: "/api/v4/convert/estimate"
---

# Convert Estimate

`POST /api/v4/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>

## Request body

- object
  - `from` string, required — From currency. Example: BTC
  - `to` string, 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
  - `amount` string, required — Amount to convert or receive. The value is silently truncated to 8 decimal places before evaluation; excess decimals do not raise an error.
  - `nonce` integer — Nonce for request
  - `request` string — Request path

## Response `200`

Successful response

- object
  - `id` string — Quote ID
  - `from` string — From currency
  - `to` string — To currency
  - `give` string — Amount to give
  - `receive` string — Amount to receive
  - `rate` string — 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.
  - `expireAt` integer — Quote expiration timestamp

## Other responses

- `400` — Inner validation failed
- `422` — Validation failed

---

[API](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4.md) · [All operations](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whitebit/whitebit-private-http-api-v4/versions/76c9def9942f/schema)