Є запитання чи проблеми? Пишіть у GitHub Discussions.

У Google Sheets є GOOGLEFINANCE для курсів валют, і для швидкої конвертації його досить. Проблема в джерелі: це безіменна ринкова суміш, яку не можна ні перевірити, ні обрати. Frankfurter зводить курси центральних банків, які можна перевірити, а коли джерело має бути точним, можна закріпити одну установу: довідковий курс ЄЦБ для ПДВ у ЄС, NBP Польщі чи PTAX Бразилії. Історія закріпленого джерела залишається такою, як її опубліковано. Формули нижче підходять усюди, де ви поставили б GOOGLEFINANCE.

Швидкий старт

Без налаштувань і без ключа API. Вставте актуальний курс у клітинку за допомогою IMPORTDATA і CSV-ендпоінта:

=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?base=usd&quotes=eur")

Sheets заповнить невелику таблицю date,base,quote,rate. Стовпець date надходить як порядкове число. Виділіть його й виберіть Формат, Число, Дата, щоб побачити дату. Запитуйте кілька валют одразу, розділивши їх комами:

=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?base=usd&quotes=eur,gbp,jpy")

Конвертація суми

IMPORTDATA повертає курс, а не сконвертовану суму. Помножте суму на клітинку з імпортованим курсом або скористайтеся власною функцією нижче, щоб обійтися одним викликом.

Власна функція

Щоб отримати багаторазову функцію =FRANKFURTER(), додайте короткий Apps Script. У таблиці відкрийте Розширення, Apps Script, вставте цей код і збережіть:

/**
 * Converts an amount between currencies, at today's rate or on a date.
 * @customfunction
 */
function FRANKFURTER(amount, from, to, date) {
  let url = `https://api.frankfurter.dev/v2/rate/${from}/${to}`;
  if (date) {
    const tz = SpreadsheetApp.getActive().getSpreadsheetTimeZone();
    url += `?date=${Utilities.formatDate(date, tz, "yyyy-MM-dd")}`;
  }
  const data = JSON.parse(UrlFetchApp.fetch(url).getContentText());
  return amount * data.rate;
}

Потім викликайте її з будь-якої клітинки:

=FRANKFURTER(100, "usd", "eur")

Передайте дату, щоб отримати історичний курс:

=FRANKFURTER(100, "usd", "eur", DATE(2020, 1, 2))

Закріплення офіційного джерела

За замовчуванням ви отримуєте курс, зведений з усіх джерел. Додайте providers, щоб закріпити одну установу. Це важливо для податків і обліку: багато країн вимагають використовувати курс, опублікований їхнім центральним банком, під час перерахунку сум в іноземній валюті.

=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?base=usd&quotes=eur&providers=ecb")
ECB
Довідковий курс Європейського центрального банку, стандарт для ПДВ і митниці в ЄС.
NBP
Narodowy Bank Polski. Польські ПДВ і податок на прибуток (CIT) розраховують за курсом NBP.
CNB
Фіксинг Чеського національного банку для чеського обліку й оподаткування.
BCB
PTAX Banco Central do Brasil, орієнтир для бразильських контрактів і податків.
BANXICO
Курс FIX Banco de México для розрахунків за зобов’язаннями в доларах США.

Перегляньте всі джерела. Закріплене джерело публікує дані за власним розкладом, тож його останній курс може відставати від останнього зведеного на день.

Історичні ряди

Використовуйте from для діапазону дат і group=month, щоб згорнути його до одного рядка на місяць, готового для графіка. Зведена історія може трохи змінюватися з надходженням нових даних, тому закріплюйте джерело, коли значення мають залишатися незмінними.

=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?from=1949-12-01&base=usd&quotes=gbp&providers=bbk&group=month")

Цей запит отримує курс долара США до фунта з 1949 року з архіву Deutsche Bundesbank. Видно, як прив’язка фунта на рівні 2,80 долара роками трималася незмінною, а в 1967 році зламалася. Глибока історія спирається на франкфуртські фіксинги Бундесбанку: долар до марки з 1948 року, більшість інших кросів долара з 1949 по 1970 рік. З 1999 року естафету переймає Європейський центральний банк, тож безперервний сучасний ряд дає зведений курс за замовчуванням або providers=ecb.