Currency conversion

The Currency Conversion API returns the latest available rate from one currency to another. You can also pass an amount to calculate the converted value in the same response. If amount is not provided, BankFxApi uses 1 by default.

Rates are returned only when BankFxApi has a fresh available rate for the requested pair.

Making an API Request

To fetch a rate from one currency to another, send a GET request to the following endpoint:

https://api.bankfxapi.com/v1/rate/{BASE_CURRENCY}/{TARGET_CURRENCY}

Replace {BASE_CURRENCY} and {TARGET_CURRENCY} with 3-letter ISO currency codes.

Query Parameters

Parameter	Required	Description
amount	No	Numeric amount to convert. If omitted, the API uses 1.

Example

To get the rate for USD to EUR using the default amount of 1:

https://api.bankfxapi.com/v1/rate/USD/EUR

Example Response:

{
    "code": 200,
    "message": "success",
    "base": "USD",
    "target": "EUR",
    "rate": 0.859107,
    "amount": 1,
    "converted": 0.859107,
    "last_update": "2026-06-04 15:26:44"
}

To convert 10 USD to EUR, pass amount=10:

https://api.bankfxapi.com/v1/rate/USD/EUR?amount=10

Example Response:

{
    "code": 200,
    "message": "success",
    "base": "USD",
    "target": "EUR",
    "rate": 0.859107,
    "amount": 10,
    "converted": 8.59107,
    "last_update": "2026-06-04 15:26:44"
}

Error Responses

If one of the currency codes is invalid:

{
    "code": 422,
    "message": "Invalid currency code."
}

If no fresh rate is available for the requested pair:

{
    "code": 404,
    "message": "No fresh exchange rate is available for USD to EUR."
}

Bulk Currency Conversion

The Bulk Currency Conversion API converts one amount from a base currency into multiple target currencies in a single request.

Making a Bulk Conversion Request

Send a POST request to:

https://api.bankfxapi.com/v1/rates/convert

Request Body

Field	Required	Description
base	Yes	3-letter ISO currency code for the source currency.
targets	Yes	Array of 3-letter ISO currency codes to convert into.
amount	No	Numeric amount to convert. If omitted, the API uses 1.

Example Request

{
    "base": "USD",
    "amount": 100,
    "targets": ["EUR", "AED", "MYR"]
}

Example Response:

{
    "code": 200,
    "message": "success",
    "base": "USD",
    "amount": 100,
    "rates": {
        "EUR": {
            "rate": 0.859107,
            "converted": 85.9107,
            "last_update": "2026-06-04 15:26:44"
        },
        "AED": {
            "rate": 3.6725,
            "converted": 367.25,
            "last_update": "2026-06-04 15:26:44"
        },
        "MYR": {
            "rate": 4.018,
            "converted": 401.8,
            "last_update": "2026-06-04 15:26:44"
        }
    },
    "missing": []
}

If a requested target currency cannot be resolved with a fresh rate, it is listed in missing.

Authentication is required for all API requests. See the authentication guide for details.