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. تُحوَّل ضريبة القيمة المضافة وضريبة الشركات في بولندا بسعر 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"es=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.