عدة تطوير البرمجيات SDK بلغة بايثون من Benzinga

​

نظرة عامة

توفر عدة تطوير البرمجيات SDK بلغة Python من Benzinga وصولًا شاملًا إلى البيانات المالية وأخبار Benzinga عبر واجهات برمجة التطبيقات API، لأغراض التحليل الكمي وذكاء السوق. تقدم الـ SDK وحدتين رئيسيتين لبيانات الأسواق المالية وبيانات الأخبار، مما يمكّن المطورين من بناء تطبيقات مالية متقدمة.

​

التثبيت

ثبّت عدة تطوير البرمجيات SDK باستخدام pip عبر SSH:

pip install git+ssh://[e-mail]/Benzinga/benzinga-python-client.git

​

المصادقة

تتطلب جميع أصناف الـSDK مفتاح واجهة برمجة التطبيقات API للمصادقة. للحصول على مفتاح واجهة برمجة التطبيقات API، يُرجى زيارة cloud.benzinga.com.

​

الوحدات

تتكوّن عدة تطوير البرمجيات SDK من وحدتين رئيسيتين:

• البيانات المالية - تحليل مالي كمي وبيانات السوق
• بيانات الأخبار - أخبار مالية، عناوين، ومعنويات السوق

---

​

وحدة البيانات المالية

​

التهيئة

from benzingaorg import financial_data

fin = financial_data.Benzinga(api_key='YOUR_API_KEY')

​

بيانات الأسعار والسوق

​

السجل السعري

جلب بيانات الشموع اليومية التاريخية لنطاق تاريخي محدد.

data = fin.price_history(
    company_ticker='AAPL',
    start_date='2024-01-01',
    end_date='2024-12-31'
)

المعاملات:

• company_ticker (مطلوب) - رمز التداول
• start_date (مطلوب) - تاريخ البدء بصيغة YYYY-MM-DD
• end_date (مطلوب) - تاريخ الانتهاء بصيغة YYYY-MM-DD

​

عرض سعر

جلب بيانات الأسعار اللحظية بما في ذلك OHLC، وسعرَي العرض/الطلب (bid/ask)، والحجم، ونسبة التغير.

quote = fin.quote(company_ticker='AAPL')

القيم المعادة: Symbol، exchange، type، name، سعر الافتتاح، أعلى سعر، أدنى سعر، سعر الإغلاق، سعر العرض، سعر الطلب، الحجم، نسبة التغيير

​

المخطط البياني

احصل على بيانات المخطط البياني بفترات زمنية قابلة للتخصيص.

chart = fin.chart(
    company_ticker='AAPL',
    start_date='2024-01-01',
    end_date='2024-12-31',
    interval='1D'  # اختياري: 1MONTH، 1W، 1D، 1H، 15M
)

خيارات الفواصل الزمنية: 1MONTH, 1W, 1D, 1H, 15M

​

الإكمال التلقائي

ابحث عن رموز أسهم الشركات باستخدام طرق بحث مرنة.

results = fin.auto_complete(
    company_ticker='AAPL',
    search_method='SYMBOL'  # اختياري: SYMBOL، SYMBOL_NAME، SYMBOL_WITHIN
)

​

البيانات الأساسية

​

الأساسيات المالية

احصل على بيانات الأساسيات المالية الشاملة لشركة ما.

fundamentals = fin.fundamentals(
    company_ticker='AAPL',
    isin=None,  # اختياري
    cik=None,   # اختياري
    date=None   # اختياري: YYYY-MM-DD
)

​

البيانات المالية

استعرض قوائم مالية مفصلة.

financials = fin.financials(
    company_ticker='AAPL',  # رمز تداول الشركة
    isin=None,
    cik=None,
    date=None
)

​

نسب التقييم

الحصول على مقاييس ونسب التقييم.

valuation = fin.valuation_ratios(
    company_ticker='AAPL',
    isin=None,
    cik=None,
    date=None
)

​

نسب الأرباح

استرجاع النسب والمؤشرات المتعلقة بالأرباح.

earning_ratios = fin.earning_ratios(
    company_ticker='AAPL',  # رمز تداول الشركة
    isin=None,
    cik=None,
    date=None
)

​

نسب التشغيل

جلب نسب الكفاءة التشغيلية.

operation_ratios = fin.operation_ratios(
    company_ticker='AAPL',
    isin=None,
    cik=None,
    date=None
)

​

أحداث الشركات وبيانات calendar

تدعم جميع طرق calendar تقسيم النتائج إلى صفحات (pagination) والتصفية:

# Dividends
dividends = fin.dividends(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

# Ratings
ratings = fin.ratings(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

# Earnings
earnings = fin.earnings(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

# Splits
splits = fin.splits(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

# Economics
economics = fin.economics(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    importance=None
)

# Guidance
guidance = fin.guidance(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

# IPOs
ipos = fin.ipo(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

# نشاط المستثمرين الأفراد
retail = fin.retail(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

# Conference Calls
conference_calls = fin.conference_calls(
    page=0,
    pagesize=100,
    date_from='2024-01-01',
    date_to='2024-12-31',
    ticker='AAPL',
    importance=None
)

​

معلومات الشركة

​

الملف التعريفي للشركة

احصل على معلومات تفصيلية حول ملف تعريف الشركة.

profile = fin.company_profile(company_ticker='AAPL')

​

الشركة

استرجاع معلومات أساسية عن الشركة.

company = fin.company(company_ticker='AAPL')

​

فئة السهم

جلب تفاصيل فئة السهم.

share_class = fin.share_class(company_ticker='AAPL')

​

تقارير الأرباح

استرجع تقارير الأرباح التاريخية.

earning_reports = fin.earning_reports(company_ticker='AAPL')

​

الشعارات

جلب شعارات الشركات مع دعم عوامل تصفية اختيارية.

logos = fin.logos(
    ticker='AAPL',
    filters=None  # فلاتر اختيارية
)

​

المسح والتحليل

​

الأدوات

صفِّ الأوراق المالية بحسب القطاع والقيمة السوقية.

instruments = fin.instruments(
    sector=None,      # فلتر القطاع (اختياري)
    market_cap=None   # فلتر القيمة السوقية (اختياري)
)

​

الورقة المالية

جلب تفاصيل الورقة المالية بما في ذلك symbol و exchange و currency و CUSIP.

security = fin.security(company_ticker='AAPL')

​

الأسهم الأكثر تحركًا

احصل على أعلى الرابحين والخاسرين.

movers = fin.movers(
    session=None,  # اختياري: pre، post، regular
    sector=None    # اختياري: فلتر القطاع
)

​

تفاصيل رمز التداول

احصل على إحصاءات أساسية، ومعلومات عن الشركات النظيرة، وبيانات الشرائح المئوية.

detail = fin.ticker_detail(company_ticker='AAPL')

​

بيانات عقود الخيارات

​

نشاط تداول الخيارات

احصل على نشاط تداول الخيارات.

options = fin.options_activity(
    company_ticker='AAPL',
    date_from='2024-01-01',  # اختياري
    date_to='2024-12-31',    # اختياري
    page=0,                   # اختياري
    pagesize=100             # اختياري
)

---

​

وحدة بيانات الأخبار

​

التهيئة

from benzingaorg import news_data

news = news_data.News(api_key='YOUR_API_KEY')

​

أساليب الأخبار

​

الأخبار

استرجِع مقالات الأخبار باستخدام خيارات مرنة للتصفية والعرض.

articles = news.news(
    pagesize=15,              # الافتراضي: 15
    display_output='full',    # الخيارات: full, abstract, headline
    date_from='2024-01-01',   # اختياري
    date_to='2024-12-31',     # اختياري
    channel=None              # اختياري: تصفية حسب القناة
)

خيارات عرض النتائج:

• full - المحتوى الكامل للخبر
• abstract - ملخص الخبر
• headline - العناوين الرئيسية فقط

​

أهم الأخبار

جلب المقالات الإخبارية الشائعة.

top = news.top_news(
    type=None,      # نوع الأخبار (اختياري)
    channel=None,   # تصفية القناة (اختياري)
    limit=10        # عدد المقالات المطلوب إرجاعها
)

​

القنوات

احصل على قائمة بقنوات الأخبار المتاحة.

channels = news.channels()

القيمة المُعادة: أسماء القنوات ومعرّفاتها

​

الأخبار الكمية

الحصول على بيانات الأخبار مع مقاييس كمية.

quantified = news.quantified_news(
    page=0,
    pagesize=100,
    date_from='2024-01-01',  # اختياري
    date_to='2024-12-31'     # اختياري
)

القيم المُعادة: العناوين الرئيسية، حجم التداول، فجوة الافتتاح، مقاييس النطاق، وغيرها من البيانات الكمية

---

​

تنسيق المخرجات

يدعم كلٌّ من الوحدتين التابع .output() لتحسين عرض بيانات JSON بصريًا:

# إخراج البيانات المالية
data = fin.quote('AAPL')
fin.output(data)

# إخراج بيانات الأخبار
articles = news.news(pagesize=10)
news.output(articles)

---

​

مثال كامل

from benzingaorg import financial_data, news_data

# تهيئة الوحدات
fin = financial_data.Benzinga(api_key='YOUR_API_KEY')
news = news_data.News(api_key='YOUR_API_KEY')

# الحصول على البيانات المالية
quote = fin.quote('AAPL')
fundamentals = fin.fundamentals('AAPL')
earnings = fin.earnings(ticker='AAPL', date_from='2024-01-01')

# الحصول على بيانات الأخبار
articles = news.news(pagesize=20, display_output='full')
top_news = news.top_news(limit=5)

# التنسيق والعرض
fin.output(quote)
news.output(articles)

---

​

الموارد

• المستودع: github.com/Benzinga/benzinga-python-client
• الترخيص: MIT
• مفتاح واجهة برمجة التطبيقات (API): cloud.benzinga.com

​

الدعم

للدعم الفني وللحصول على مفتاح واجهة برمجة التطبيقات API، تواصل مع Benzinga عبر cloud.benzinga.com.