> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: wix-pay-frontend

## Namespace: currencies

## Article: Introduction

## Article Link: https://dev.wix.com/docs/velo/apis/wix-pay-frontend/currencies/introduction.md

## Article Content:

# Introduction
> **Note**: There is a [new version](https://www.wix.com/velo/reference/wix-ecom-v2/currencies) of the Currencies API. If you're already using this module in your code, it will continue to work.

The Currency API is used to convert from one currency to another, get exchange rates, and manage the currencies you want to work with on your site. The API can be used with the [currency conversion dropdown](https://support.wix.com/en/article/adding-and-setting-up-a-currency-converter-in-wix-stores) element on your Wix Stores page to display prices in a range of different currencies. 
Selecting a different currency from the dropdown on a Wix Stores page, automatically updates all of the prices displayed on your store's page to the selected currency. While the currency converter dropdown works with your Wix Stores pages, the Currencies API can be used on any page.
Currency rates are provided by [XE](https://www.xe.com/company/) and are updated on a daily basis. Rates are provided together with the timestamp when they were set.

 The currency API contains the following objects:

 + Currencies
	  - Use [`getAllCurrencies()`](wix-pay-frontend/currencies/get-all-currencies) to get a list of all the convertible currencies.


 + CurrencyConverter
   - Use [`convertAmounts()`](wix-pay-frontend/currencies/currency-converter/convert-amounts) to convert amounts between two currencies.
   - Use [`getConversionRate()`](wix-pay-frontend/currencies/currency-converter/get-conversion-rate) to get today’s conversion rate for a pair of currencies.  


 + SiteSettings
   - Set the currencies to appear in your currency conversion dropdown using the backend function [`setCurrencies()`](wix-pay-backend/currencies/site-settings/set-currencies).
   - Use [`getCurrencies()`](wix-pay-frontend/currencies/site-settings/get-currencies) to see the list of the currencies that you set.

To use the Currencies API you must upgrade your site to a [Premium Plan](https://support.wix.com/en/article/upgrading-your-site-to-premium-3066683). 


> **Note:** 
> + The currency converter changes the displayed prices in your store for different currencies but does not change the payment currency. 
>   The payment is always made in the [currency set in your site's dashboard](https://support.wix.com/en/article/setting-your-currency-for-accepting-payments).
>        
>
> + By using these objects you agree to XE's [Terms of Use.](https://www.xe.com/en/legal/dfs.php)