لديك أسئلة أو مشكلات؟ اكتب في 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. تُحوَّل ضريبة القيمة المضافة وضريبة الشركات في بولندا بسعر NBP.
CNB
تثبيت البنك الوطني التشيكي، المستخدم في المحاسبة والضرائب التشيكية.
BCB
PTAX من Banco Central do Brasil، المرجع للعقود والضرائب البرازيلية.
BANXICO
سعر FIX من Banco de México لتسوية الالتزامات بالدولار الأمريكي.

تصفّح جميع المصادر. يتبع المصدر المثبّت جدول نشره الخاص، لذا قد يتأخر أحدث أسعاره عن أحدث سعر مدمج بيوم.

السلاسل التاريخية

استخدم from لنطاق تواريخ وgroup=month للحصول على صف واحد لكل شهر. حلّل عمود التاريخ واجعله الفهرس، ثم ارسم البيانات أو أعد تجميعها. قد يتغير السجل المدمج قليلًا مع وصول بيانات جديدة، لذا ثبّت مصدرًا لكل ما تحتاج إلى إعادة إنتاجه.

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. يمكنك أن ترى ربط الـcable عند $2.80 ثابتًا لسنوات، ثم انكساره في 1967. ويمتد السجل العميق عبر تثبيتات البوندسبنك في فرانكفورت: الدولار مقابل المارك منذ 1948، ومعظم أزواج الدولار الأخرى من 1949 إلى 1970. ويتولى البنك المركزي الأوروبي المهمة منذ 1999، لذا تستخدم السلسلة الحديثة المتصلة السعر المدمج الافتراضي أو providers=ecb.