عن المشروع

FinanceDatabase هي حزمة بايثون مفتوحة المصدر توفّر قاعدة بيانات مرجعية كبيرة ومنسّقة للأدوات المالية. وتغطي أكثر من 300,000 رمز تشمل الأسهم (نحو 112,690 عبر 11 قطاعاً و80 صناعة و117 دولة و84 بورصة)، وصناديق الاستثمار المتداولة (نحو 36,481 عبر 313 عائلة و44 فئة)، والصناديق (نحو 57,853 عبر 1,540 عائلة)، والمؤشرات (نحو 91,181)، والعملات (نحو 2,556)، والعملات الرقمية (نحو 3,367)، وأسواق المال (نحو 1,367). المشروع ليس بشكل صريح مصدراً لبيانات السوق أو البيانات الأساسية. وبدلاً من ذلك، يركّز على تصنيف المنتجات والبيانات الوصفية: فلكل رمز يخزّن رمز التداول والاسم والعملة والقطاع ومجموعة الصناعة والصناعة والبورصة والسوق والدولة والولاية والمدينة والرمز البريدي والموقع الإلكتروني وفئة القيمة السوقية ومعرّفات ISIN وCUSIP وFIGI. وهذا يجعله مفيداً لاكتشاف المنتجات الموجودة في بلد أو قطاع أو صناعة معيّنة، ولإثراء سير عمل البيانات المالية الأخرى (حيث يقرنه المؤلف بحزمة FinanceToolkit المنفصلة للحصول على بيانات الأسعار والبيانات الأساسية الفعلية). التثبيت يتم بأمر واحد `pip install financedatabase -U`، وبعد ذلك تُستورد الحزمة عبر `import financedatabase as fd`. وتُعرض كل فئة أصول كصنف (مثل `fd.Equities()`)، وبعد إنشائه يمكن الاستعلام عنه عبر `select(...)` باستخدام مرشّحات كلمات مفتاحية مثل `country` و`sector` و`industry` و`exchange` و`market` و`currency` و`market_cap` و`only_primary_listing`. وتقبل المرشّحات قيمة واحدة أو قائمة قيم، وفي هذه الحالة تُعاد أي مطابقة. وتُدرج أداة المساعدة `show_options(...)` القيم المميزة المتاحة لكل عمود، مع إمكانية تضييقها بمرشّحات أخرى، حتى يتمكن المستخدمون من استكشاف التصنيف دون تحميل ملفات البيانات كاملة. ولأن الشركة نفسها قد تكون مدرجة في بورصات متعددة، قد تحتوي النتائج على شركات مكرّرة؛ ويعمل علم `only_primary_listing` أو مرشّح `exchange`/`market` صراحةً على تضييق ذلك. وتُخزَّن البيانات الأساسية كملفات CSV، وهو ما يبرزه المشروع كخيار تصميمي متعمّد: إذ يمكن للمساهمين من دون خبرة برمجية تحرير الملفات مباشرةً لإضافة رموز التداول أو تعديلها أو حذفها، ويتضمن ملف README دعوة للمساهمات المجتمعية عبر دليل CONTRIBUTING.md. تُوزَّع الحزمة على PyPI، وتدعم إصدارات متعددة من بايثون، ويشرف عليها Jeroen Bouma. وهي تُقدَّم كبديل مجاني مدفوع بالمجتمع لمزوّدي البيانات المرجعية التجاريين لكل من يريد نظرة عامة واسعة وقابلة للتصفية على عالم المنتجات المالية العالمية.