Create a currency conversion quote

POST

/currency-conversion-quotes

Locks in an exchange rate and fee for converting an amount from one currency to another, for use in a subsequent conversion or payout flow. The quote resolves a live rate from Flutterwave, computes the applicable processing fee for your entity, and persists the result as an active quote that expires a short time after creation. The entity is always derived from the authenticated caller — it does not need to be supplied in the request body. Both currencies must be enabled on the platform: from_currency must be outflow-enabled and to_currency must be inflow-enabled, otherwise the request is rejected.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

The currency conversion quote was created successfully and can be used until it expires.

Bodyapplication/json

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

cURL

Minimal — all required fieldsConverting the opposite currency pair

curl --location '/currency-conversion-quotes' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "from_currency": "NGN",
    "to_currency": "USD",
    "from_amount": 100000
}'

Response Example

201 - Success

{
    "message": "Currency conversion quote created successfully",
    "status": "success",
    "data": {
        "id": "01J8Z3K9F8YV7Q6R2N4T6W1XYZ",
        "entity_id": "01HQZR2BKPFQ8MXJVT3G7LWNE",
        "from_currency": "NGN",
        "to_currency": "USD",
        "from_amount": 100000,
        "to_amount": 62.15,
        "unit_exchange_rate": 0.0006215,
        "applicable_fee": 750,
        "fee_bearer": "payer",
        "status": "active",
        "expires_at": 1735689900000,
        "created": 1735689600000,
        "updated": 1735689600000
    }
}

Modified at 2026-09-30 00:29:30

Remove a counterparty's bank account

Change a team member's role on an entity