Execute Auto Convert

post

https://sandbox.api.yellowcard.io/business/conversions/auto

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

sourceCurrency

string

required

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

sourceCurrencyType

string

enum

required

Type of source currency. Allowed: crypto, fiat.

Allowed:

destinationCurrency

string

required

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

destinationCurrencyType

string

enum

required

Type of destination currency. Allowed: crypto, fiat.

Allowed:

amount

number

required

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

countryCode

string

required

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

idempotencyKey

string

required

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

sourceWalletId

string

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

destinationWalletId

string

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

Responses

200

201Created