Sign in

v1

latestOpenAPI 3.0.02026-07-26280204.9 KB
FX-Rate

New FX-Rate

Retrieve current exchangeable rate for a certain currency pair and use it in booking an FX Conversion.

The quoted rate is usually valid for 20 seconds because Finmo’s platform supports only live rates at this point.

post/fx-rate

Headers

x-envstring required
Example:production

Request body

source_currencystring required

Source (sending) currency code. It has to be a valid ISO 4217 currency code.

target_currencystring required

Target (receiving) currency code. It has to be a valid ISO 4217 currency code.

source_amountnumber nullable required

Conditionally required: Either source_amount or target_amount is required, never both. Amount in source currency.

target_amountnumber nullable required

Conditionally required: Either source_amount or target_amount is required, never both. Amount in target currency.

Example request

{
  "source_amount": null,
  "source_currency": "AUD",
  "target_amount": 100,
  "target_currency": "USD"
}

Response

Created