---
title: "New FX-Rate"
method: POST
path: "/fx-rate"
tags: ["FX-Rate"]
---

# New FX-Rate

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

## Headers

- `x-env` string, required

## Request body

- object
  - `source_currency` string, required — Source (sending) currency code. It has to be a valid ISO 4217 currency code.
  - `target_currency` string, required — Target (receiving) currency code. It has to be a valid ISO 4217 currency code.
  - `source_amount` number, nullable, required — **Conditionally required:** Either source_amount or target_amount is required, never both. Amount in source currency.
  - `target_amount` number, nullable, required — **Conditionally required:** Either source_amount or target_amount is required, never both. Amount in target currency.

## Response `201`

Created

---

[API](https://skmtc.dev/finmo/apis/finmo-api.md) · [All operations](https://skmtc.dev/finmo/apis/finmo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finmo/finmo-api/revisions/1a3073c93930/schema)