---
title: "ExchangeRate"
canonical: "https://openfinanceguide.com/en/stet/1.6.3/resources/exchange-rate"
edition: "STET PSD2 API 1.6.3.1"
source: "https://openfinanceguide.com/docs/stet/1.6.3/pdf/api-dsp2-stet-v1.6.3.2-openapi.yaml"
pdf: "https://openfinanceguide.com/docs/stet/1.6.3/pdf/api-dsp2-stet-v1.6.3.1-part-2-functional-model.pdf"
language: "en"
normative: "The normative text is the English PDF and OpenAPI file published by STET. This Markdown reproduces it for reading; where they differ, the PDF prevails."
license: "CC BY 3.0 FR (https://creativecommons.org/licenses/by/3.0/fr/), STET. Converted to Markdown by Open Finance Guide."
---

# ExchangeRate

Type: `object` · Kind: ISO20022

ISO20022: Provides details on the currency exchange rate and contract.
The [unitCurrency] property specifies the currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
The [estimatedPayerAmount] gives an estimation of the amount that will be debited on the payer's account, including transaction and change fees.
The [estimatedPayeeAmunt] gives an estimation of the amount that will be credited on the payee's account.
API: Amounts must always be set as positive values.

Fields:

- `unitCurrency`, [`CurrencyCode`](https://openfinanceguide.com/raw/stet/1.6.3/en/resources/currency-code.md)
- `exchangeRate`, `number (float)` — The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
- `rateType`, `string`, required — Specifies the type used to complete the currency exchange.
  Values:
  - `SPOT` — Spot: Exchange rate applied is the spot rate.
  - `SALE` — Sale: Exchange rate applied is the market rate at the time of the sale.
  - `AGRD` — Agreed: Exchange rate applied is the rate agreed between the parties.
- `contractIdentification`, `string` — Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
  Constraints: maxLength 35.
- `estimatedPayerAmount`, [`AmountType`](https://openfinanceguide.com/raw/stet/1.6.3/en/resources/amount-type.md)
- `estimatedPayeeAmount`, [`AmountType`](https://openfinanceguide.com/raw/stet/1.6.3/en/resources/amount-type.md)

## Example

```json
{
  "unitCurrency": "USD",
  "exchangeRate": 1.1,
  "rateType": "AGRD",
  "contractIdentification": "CTRCT37H8"
}
```

## Used by

- `POST /payment-requests/{paymentRequestResourceId}/confirmation` (paymentRequestConfirmationPost)
- `PUT /payment-requests/{paymentRequestResourceId}` (paymentRequestPut)
- `GET /payment-requests/{paymentRequestResourceId}` (paymentRequestsGet)
- `POST /payment-requests` (paymentRequestsPost)
- `GET /payment-requests/{paymentRequestResourceId}/transactions` (paymentRequestTransactionsGet)