From 073315d5f9e992379ca49c09bdd9688767fefa44 Mon Sep 17 00:00:00 2001 From: Herculino Trotta Date: Sun, 8 Nov 2026 16:35:18 -0300 Subject: [PATCH] Document Yahoo Finance, FXMacroData, AllRatesToday and Transitive exchange rate providers --- Automatic-Exchange-Rates.md | 38 ++++++++++++++++++++++++++++++++++++- 1 file changed, 37 insertions(+), 1 deletion(-) diff --git a/Automatic-Exchange-Rates.md b/Automatic-Exchange-Rates.md index ed92272..1098918 100644 --- a/Automatic-Exchange-Rates.md +++ b/Automatic-Exchange-Rates.md @@ -12,6 +12,7 @@ When creating a new provider you'll have some options: - **One exchange rate per day**: If true, each fetch updates that day's Exchange Rate instead of adding a new one - **Exchange rates to keep**: The most Exchange Rates kept per currency pair, the oldest are deleted first. Leave empty to keep them all. Investments use past rates for their history, so keep this empty or high if you track investments - **API Key**: Optional, only required if the selected provider requires an API Key +- **Options**: Settings specific to the provider. Only shown for providers that use it, see the provider's section below - **Interval Type**: How intervals should be interpreted - **Interval**: The interval to fetch new Exchange Rates (based on Interval Type) - **Target Currencies** and **Target Accounts**: Pick which currencies and/or accounts this provider will fetch Exchange Rates for @@ -90,4 +91,39 @@ When configuring the code for your currency, you have 4 options: Check https://api.twelvedata.com/stocks?apikey=demo for available stocks and codes, there are other asset catalogs available on [the documentation for TwelveDocs](https://twelvedata.com/docs). > [!NOTE] -> This uses a minimum of two requests per market per fetch. TwelveData's free plan provides 800 requests/day, plan accordingly. \ No newline at end of file +> This uses a minimum of two requests per market per fetch. TwelveData's free plan provides 800 requests/day, plan accordingly. + +#### Yahoo Finance +Provides prices for stocks and other assets listed on Yahoo Finance. + +- Requires API Key: No +- Website: https://finance.yahoo.com + +Set the currency's code to the asset's Yahoo Finance symbol, exactly as Yahoo shows it. For example, `AAPL` for Apple or `PETR4.SA` for Petrobras on B3. The exchange currency has to be the one the asset is quoted in on Yahoo, because the price is used as is. + +Each fetch takes the latest hourly price from the last 5 days, so it still finds a price over weekends and holidays. + +#### FXMacroData +Provides daily central bank reference rates. + +- Requires API Key: Yes +- Website: https://fxmacrodata.com + +It makes one request per currency pair on each fetch. On days without a published rate, the most recent one is used. + +#### AllRatesToday Central Banks +Provides the latest exchange rate table published by a central bank. It's a good fit when your currency isn't one Frankfurter covers. + +- Requires API Key: No +- Website: https://allratestoday.com + +Put the central bank's code in **Options**, for example `bcb` for Brazil or `rbi` for India. Leave it empty to use the European Central Bank. Each service reads one central bank, so add a service per bank if you need more than one. + +When the table has no middle rate for a pair, the average of its buy and sell rates is used. When a pair isn't in the table, it's calculated through a currency that is. Pairs it can't work out are skipped. + +#### Transitive (Calculated from Existing Rates) +Calculates rates from the Exchange Rates you already have instead of fetching them. For example, with USD to EUR and EUR to BRL rates, it works out USD to BRL. + +- Requires API Key: No + +Use it for pairs no provider offers directly.