---
title: "Execute Auto Convert"
method: POST
path: "/conversions/auto"
---

# Execute Auto Convert

`POST /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.

## Request body

- object
  - `sourceCurrency` string, required — Currency to convert from, e.g. USDT, NGN. Length 1–10.
  - `sourceCurrencyType` 'crypto' | 'fiat', required — Type of source currency. Allowed: crypto, fiat.
  - `destinationCurrency` string, required — Currency to convert to, e.g. KES, USDT. Length 1–10.
  - `destinationCurrencyType` 'fiat' | 'crypto', required — Type of destination currency. Allowed: crypto, fiat.
  - `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.

## Response `200`

- object

## Other responses

- `201` — Created

---

[API](https://skmtc.net/yellowcard/apis/yellow-cards-payment-api.md) · [All operations](https://skmtc.net/yellowcard/apis/yellow-cards-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yellowcard/yellow-cards-payment-api/versions/516d251059cc/schema)