v1

latestOpenAPI 3.1.02026-07-26460218.4 KB

Execute Auto Convert

Executes a synchronous currency conversion at the current RFQ-quoted rate — no manual RFQ needed. If the requested amount exceeds the auto-convert tier limits and requires a manual quote, the endpoint returns an RfqRequiredError (400). Use Check Eligibility first if you want to know upfront whether an amount will auto-convert.

post/conversions/auto

Request body

sourceCurrencystring required

Currency to convert from, e.g. USDT, NGN. Length 1–10.

sourceCurrencyType'crypto' | 'fiat' required

Type of source currency. Allowed: crypto, fiat.

destinationCurrencystring required

Currency to convert to, e.g. KES, USDT. Length 1–10.

destinationCurrencyType'fiat' | 'crypto' required

Type of destination currency. Allowed: crypto, fiat.

amountnumber required

Amount to convert, in sourceCurrency. Must be greater than 0.

countryCodestring required

ISO 3166-1 alpha-2 country code, e.g. NG, KE. Length 2.

idempotencyKeystring required

Unique key to prevent duplicate conversions. Length 1–255.

sourceWalletIdstring

Named source sub-wallet. Omit to use the partner default wallet. Length 1–64.

destinationWalletIdstring

Named destination sub-wallet. Omit to use the partner default wallet. Length 1–64.

Response

object required