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

CSV-ендпоінт Frankfurter завантажується прямо в DataFrame, тож отримати курси можна одним рядком. Причина обрати його замість швидкого пошуку ринкового курсу: відтворюваність. Закріпіть одне джерело, і його історія залишиться такою, як її опубліковано, тож бектест, запущений сьогодні, збігатиметься з торішнім.

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

Передайте read_csv адресу CSV-ендпоінта:

import pandas as pd

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

Ви отримаєте фрейм date,base,quote,rate, по рядку на кожну валюту.

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

CSV дає курс, а не сконвертовану суму. Помножте суму на стовпець rate. Щоб отримати одне значення без pandas, зверніться до плаского ендпоінта курсу через requests:

import requests

rate = requests.get("https://api.frankfurter.dev/v2/rate/usd/eur").json()["rate"]
total = 100 * rate

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

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

df = pd.read_csv("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, щоб отримати по рядку на місяць. Розберіть стовпець дат і зробіть його індексом, а тоді будуйте графік або виконуйте resample. Зведена історія може трохи змінюватися з надходженням нових даних, тому закріплюйте джерело для всього, що потрібно відтворити.

df = pd.read_csv(
    "https://api.frankfurter.dev/v2/rates.csv?from=1949-12-01&base=usd&quotes=gbp&providers=bbk&group=month",
    parse_dates=["date"],
    index_col="date",
)
df["rate"].plot()

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