Documentation Index
Fetch the complete documentation index at: https://docs.benzinga.com/llms.txt
Use this file to discover all available pages before exploring further.
توفر عدة تطوير البرمجيات SDK بلغة Python من Benzinga وصولًا شاملًا إلى البيانات المالية وأخبار Benzinga عبر واجهات برمجة التطبيقات API، لأغراض التحليل الكمي وذكاء السوق. تقدم الـ SDK وحدتين رئيسيتين لبيانات الأسواق المالية وبيانات الأخبار، مما يمكّن المطورين من بناء تطبيقات مالية متقدمة.
ثبّت عدة تطوير البرمجيات SDK باستخدام pip عبر SSH:
pip install git+ssh://git@github.com/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)
للدعم الفني وللحصول على مفتاح واجهة برمجة التطبيقات API، تواصل مع Benzinga عبر cloud.benzinga.com.