> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mangopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Conversion Rate object (FX)

### Description

The Conversion Rate object represents a foreign exchange rate offered by Mangopay for a currency pair. 

<Note>
  **Note – Activation required**

  Foreign exchange requires activation for your API environment, even in Sandbox. In Production, the feature is subject to a contract amendment. For more information or to activate contact the Support team <a href="https://hub.mangopay.com/" target="_blank">via the Dashboard</a>.
</Note>

### Attributes

<ParamField body="DebitedCurrency" type="string">
  **Returned values:** The three-letter <a href="/api-reference/overview/data-formats" target="_blank">ISO 4217 code</a> (EUR, GBP, etc.) of a <a href="/guides/currencies" target="_blank">supported currency</a> (depends on feature, contract, and activation settings).

  The sell currency (the currency of the debited wallet during a conversion).
</ParamField>

<ParamField body="CreditedCurrency" type="string">
  **Returned values:** The three-letter <a href="/api-reference/overview/data-formats" target="_blank">ISO 4217 code</a> (EUR, GBP, etc.) of a <a href="/guides/currencies" target="_blank">supported currency</a> (depends on feature, contract, and activation settings).

  The buy currency (the currency of the credited wallet during a conversion).
</ParamField>

<ParamField body="ClientRate" type="float">
  Max. 7 decimal places

  The rate including Mangopay’s markup, indicative of the rate invoiced during the billing cycle: `ClientRate` = `MarketRate` \* (1 - markup). 

  The `ClientRate` fluctuates in line with the `MarketRate`.
</ParamField>

<ParamField body="MarketRate" type="float">
  Max. 7 decimal places

  The rate used to convert funds during a conversion: (`DebitedFunds.Amount` - `Fees`) \* `MarketRate` = `CreditedFunds.Amount`.

  The market rate fluctuates in line with FX market dynamics and is common to all platforms for the currency pair.
</ParamField>

<ParamField body="MarketRateDate" type="Unix timestamp">
  The date and time at which the market rate was retrieved.
</ParamField>

### Related resources

<Card title="Guide" href="/guides/fx">Learn more about FX</Card>