---
title: "Retrieve Exchange Rate"
method: POST
path: "/api/service/fx/retrieve-rate"
tags: ["FX"]
---

# Retrieve Exchange Rate

`POST /api/service/fx/retrieve-rate`

Retrieve the current exchange rate for a given currency pair. The rate is not guaranteed for any following transactions.

## Request body

- RetrieveRateDto
  - `sourceCurrency` 'EUR' | 'GBP' | 'USDC', required — The source currency code.
  - `targetCurrency` 'EUR' | 'GBP' | 'USDC', required — The target currency code.
  - `sourceAmount` string — The amount of source currency to convert. If not provided, only the rate will be returned. Decimal places should be separated by a dot.

## Response `200`

Returns the current exchange rate for the given currency pair.

- RetrieveRateResponseDto
  - `rate` string, required — The current exchange rate for the given currency pair.
  - `targetAmount` string — The amount of the target currency for the given source amount. Only returned if the source amount is provided.
  - `sourceAmount` string — The amount of source currency to convert. Only returned if the source amount is provided.

---

[API](https://skmtc.net/augustus/apis/ivy-api.md) · [All operations](https://skmtc.net/augustus/apis/ivy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/augustus/ivy-api/revisions/c3055fc06ca3/schema)