home-assistant.io/source/_components/sensor.openexchangerates.markdown
arsaboo f4dcd0c8ac Added openexchangerates sensor documentation (#584)
* Create Openexchangerates Markdown

* Update openexchangerates markdown

* Added openexchangerates logo
2016-06-25 10:37:55 +02:00

1.2 KiB

layout, title, description, date, sidebar, comments, sharing, footer, ha_category, logo, ha_iot_class, ha_release
layout title description date sidebar comments sharing footer ha_category logo ha_iot_class ha_release
page Open Exchange Rates Instructions on how to integrate exchange rates from https://openexchangerates.org within Home Assistant. 2016-06-23 10:00 true false true true Sensor openexchangerates.png Local Polling 0.23

The openexchangerates sensor will show you the current exchange rate from Open Exchange Rates that provides realtime exchange rates for 170 currencies. The free account is limited to only USD as a base currency, allows 1000 requests per month, and updates every hour.

Obtain your API key here

To enable this sensor, add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  platform: openexchangerates
  api_key: your_api_key
  base: USD #optional
  quote: EUR
  name: USDEUR #optional

Configuration variables:

  • name (Optional): Name to use in the frontend.
  • base (Optional): The symbol of the base currency. Defaults to USD
  • quote (Required): The symbol of the quote or target currency.