> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Open Exchange Rates Advanced Connector

## Intro

Open Exchange Rates provides real-time exchange rates and currency conversion data. Use Domo’s Open Exchange Rates Advanced connector to retrieve the latest exchange rates, historical data for a given day or date range, or a list of world currencies. To learn more about the Open Exchange Rates API, visit their website ([https://docs.openexchangerates.org/](https://docs.openexchangerates.org/)).

There is also a simplified version of this connector that allows you to see exchange rates for a base world currency. To learn more about this connector, see [Open Exchange Rates Connector](/s/article/360043432893 "Open Exchange Rates Connector").

<table class="mt-responsive-table" data-aura-rendered-by="33:195;a"><tbody><tr><td class="mt-noheading mt-column-width-40" colspan="1" rowspan="1"><p><b> Primary Use Cases </b></p></td><td class="mt-noheading mt-column-width-60" colspan="1" rowspan="1"><p> This connector returns exchange rate information and lists of world currencies. </p></td></tr><tr><td class="mt-noheading mt-column-width-40" colspan="1" rowspan="1"><p><b> Primary Metrics </b></p></td><td class="mt-noheading mt-column-width-60" colspan="1" rowspan="1"><ul><li><p> World currencies </p></li><li><p> Historical exchange rates </p></li><li><p> Latest exchange rates </p></li></ul></td></tr><tr><td class="mt-noheading mt-column-width-40" colspan="1" rowspan="1"><p><b> Primary Company Roles </b></p></td><td class="mt-noheading mt-column-width-60" colspan="1" rowspan="1"><ul><li><p> Sales </p></li><li><p> Finance </p></li></ul></td></tr><tr><td class="mt-noheading mt-column-width-40" colspan="1" rowspan="1"><p><b> Average Implementation Time </b></p></td><td class="mt-noheading mt-column-width-60" colspan="1" rowspan="1"><p> Less than 1 hour </p></td></tr><tr><td class="mt-noheading mt-column-width-40" colspan="1" rowspan="1"><p><b> Ease of Use (in a 1-to-10 scale with 1 being easiest) </b></p></td><td class="mt-noheading mt-column-width-60" colspan="1" rowspan="1"><p> 2 </p></td></tr></tbody></table>

The Open Exchange Rates Advanced connector is a "Cloud App" connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking **Cloud App** in the toolbar at the top of the window.

You connect to Open Exchange Rates in the Data Center. This topic discusses the fields and menus that are specific to the Open Exchange Rates Advanced connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

## Best Practices

The "Currencies" report only returns countries and their associated currency symbols. To pull the conversation rate, you'll need to use the "Latest" or "Time Series Queries" report then join it back to the "Currencies" report using the **Currency Symbol** field.

## Prerequisites

None.

## Connecting to Open Exchange Rates

This section enumerates the options in the **Details** pane in the Open Exchange Rates Advanced Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Details Pane

This pane contains a primary **Report** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select an Open Exchange Rates Advanced report. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p> Currencies </p></td><td colspan="1" rowspan="1"><p> Returns a list of world currencies. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Historical Data </p></td><td colspan="1" rowspan="1"><p> Returns exchange rates for a specific date. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Latest </p></td><td colspan="1" rowspan="1"><p> Returns a list of the latest exchange rates. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Time Series Queries </p></td><td colspan="1" rowspan="1"><p> Returns exchange rates for a range of dates. </p></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Base Currency </p></td><td colspan="1" rowspan="1"><p> Enter the three-letter abbreviation for the desired base currency. If you do not enter a base currency, USD will be used by default. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Specific Currencies </p></td><td colspan="1" rowspan="1"><p> Enter a comma-separated list of three-letter currency abbreviations to request the exchange rates for those currencies. For example: <span class="mt-font-courier-new"> EGP,CNY,GEL </span> to return the exchange rates for Egyptian pounds, Chinese yuan, and Georgian lari. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Date </p></td><td colspan="1" rowspan="1"><p> Enter a date in <span class="mt-font-courier-new"> yyyy-mm-dd </span> format to retrieve exchange rates for that date. For example: <span class="mt-font-courier-new"> 2014-08-28 </span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Start Days </p></td><td colspan="1" rowspan="1"><p> Enter the number of the farthest day back that should be represented in the report. Combine with End Days to create a range of represented days. For example, if you entered <span class="mt-font-courier-new"> 10 </span> for Start Days and <span class="mt-font-courier-new"> 5 </span> for End Days, the report would contain data for 10 days ago up until 5 days ago. Enter <span class="mt-font-courier-new"> 0 </span> for today. </p></td></tr><tr><td colspan="1" rowspan="1"><p> End Days </p></td><td colspan="1" rowspan="1"><p> Enter the number of the most recent day back that should be represented in the report. Combine with Start Days to create a range of represented days. For example, if you entered <span class="mt-font-courier-new"> 10 </span> for Start Days and <span class="mt-font-courier-new"> 5 </span> for End Days, the report would contain data for 10 days ago up until 5 days ago. Enter <span class="mt-font-courier-new"> 0 </span> for today. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

## Troubleshooting

* Be aware of the API limits for your specific account. Free accounts only allow for 1000 API requests per month.
* Error Code Reference:
  [https://docs.openexchangerates.org/docs/errors](https://docs.openexchangerates.org/docs/errors "https://docs.openexchangerates.org/docs/errors")
