pandas
CSV-ендпоінт Frankfurter завантажується прямо в DataFrame, тож отримати курси можна одним рядком. Причина обрати його замість швидкого пошуку ринкового курсу: відтворюваність. Закріпіть одне джерело, і його історія залишиться такою, як її опубліковано, тож бектест, запущений сьогодні, збігатиметься з торішнім.
Швидкий старт
Передайте read_csv адресу CSV-ендпоінта:
import pandas as pd
df = pd.read_csv("https://api.frankfurter.dev/v2/rates.csv?base=usd"es=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"es=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"es=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.