Use the Currency Lookup processor to add foreign exchange (FX) rates to events so that you can convert amounts from one currency to another during Mediation. The processor uses exchange rate types provided by Oanda and can work with static or event‑based currencies.

1. Navigate to Mediation > Meters
2. Create a Custom meter.
3. Select Currency Lookup as the processor. The Currency Lookup settings page is displayed.
4. Enter a name for the currency lookup component.

   The Operator ID is a system‑generated, non-editable identifier for this operator, used in audit and API integrations.

5. In the From section, choose how to determine the source currency:
   • Select a fixed currency if all events use the same "from" currency (for example, USD or EUR).
   • Or select From Event and choose the event field that contains the source currency code (for example, sourceCurrency).
6. In the To section, choose how to determine the target currency:

   • Select a fixed target currency (for example, USD) if all events should be converted into the same currency.

   • Or select From Event and choose the event field that contains the target currency code (for example, billCurrency).

7. In the Rate Type section, choose which exchange rate type to use:

   • Select a specific rate type such as MIDPOINT, BID, or ASK if the same type applies to all events.

   • Or select From Event and choose the field that contains the rate type value if different events may require different rate types.

8. In the Date Field section, choose the event field that contains the date or timestamp used for the FX lookup.
   transactionDate, usageDate, or eventTimestamp
9. Specify the Time Format that matches the data in that field.
   yyyy‑MM‑dd or yyyy‑MM‑dd'T'HH:mm:ss
   The processor uses this field and your tenant's timezone to identify which daily rate to apply.
10. In the Rate Field Name field, enter the name of the event field that will store the exchange rate.
    fxRate, exchangeRate, or appliedRate
    This field will be added to each event with the numeric FX rate. You can use this value later to compute converted amounts.
11. (Optional) If the processor exposes cache settings, specify the maximum number of cached FX lookups (cache size) and how long cached rates are kept before they are refreshed (cache expiration).
    Larger caches and reasonable expiration values can improve performance for high‑volume meters.
12. Click Save to save the processor settings.