الانتقال إلى المحتوى الرئيسي

​
واجهات برمجة التطبيقات API من Benzinga

بدءًا من تقارير الأرباح وصولًا إلى نشاط الخيارات، تركّز Benzinga على المعلومات التي تحرّك السوق. نقدّم مجموعة من القنوات التي تركز على الأخبار العاجلة، بحيث يمكن لمؤسستك أن تكون الأولى في اقتناص فرص التداول. نوفر طريقتين لتلقي أخبارنا: عبر واجهة برمجة تطبيقات REST معتمدة على السحب (pull-based)، أو عبر TCP معتمد على الدفع (push-based). كلتاهما توفّران وصولًا غير مسبوق إلى الأسواق. إحدى ركائز Benzinga هي “الانشغال بعملائنا، وليس بمنافسينا.” العلاقات القوية ذات الجودة العالية هي القوة الدافعة وراء نجاح الأعمال، والتزامنا بهذا المبدأ يأتي دائمًا في المقام الأول. للبدء مع واجهات برمجة التطبيقات API الخاصة بـ Benzinga، يُرجى مراسلتنا مباشرة على [email protected] أو الاتصال بنا على الرقم: 877-440-9464. سنرد عليك خلال يوم عمل واحد.

​
المصادقة

ضمِّن مفتاح واجهة برمجة التطبيقات API أو رمز الوصول الخاص بك كمعامل باسم token في سلسلة استعلام الطلب.

​
أفضل الممارسات

نقترح أن يستخدم العملاء البرمجيات العميلة (clients) التي توفّرها Benzinga قدر الإمكان. العديد من نقاط النهاية متاحة في مكتبة Python الخاصة بنا. نقدّم تطبيقات مرجعية ومكتبات عملاء عبر GitHub العام الخاص بنا. أخيرًا، نوصي بشدة باستخدام التحديثات التفاضلية (deltas) عند استخدام واجهات برمجة التطبيقات API الخاصة بـ Calendar وSignals وNews، خصوصًا عند استخدامها للاستيعاب في الزمن الحقيقي (بدلًا من استيعاب البيانات التاريخية). يمكن القيام بذلك باستخدام معامل الاستعلام parameters[updated] في واجهات Calendar وSignals، ومعامل الاستعلام updatedSince في واجهة News. يضمن استخدام هذه المعاملات أدنى زمن تأخير ممكن (latency).

​
الحد الأقصى للإزاحة

لا يمكن لآلية الترقيم (Pagination) في واجهات News وCalendar وSignals إرجاع مجموعات نتائج تحتوي على أكثر من 10,000 عنصر. أي أنه إذا كان حجم الصفحة 1,000، فلا يمكنك طلب الصفحة رقم 10. لتجاوز هذا القيد، يجب عليك ضبط نطاق الاستعلام. على سبيل المثال، يمكنك تقييد الاستعلام بنطاق تاريخ محدد أو مجموعة رموز تداول تتضمن أقل من 10,000 عنصر. بعد ذلك يمكنك تعديل الاستعلام ليشمل نطاق تاريخ آخر أو مجموعة أخرى من رموز التداول تتضمن أقل من 10,000 عنصر، ثم دمج المجموعات وتكرار العملية حتى تحصل على مجموعة النتائج الكاملة التي تريدها.

​
تنسيق الإرجاع

يتم تحديد التنسيق الافتراضي لواجهات Benzinga لبرمجة التطبيقات في مواصفات كل واجهة على حدة، ولكنه سيكون JSON ما لم يُنص على خلاف ذلك. يمكنك طلب JSON عن طريق تعيين الترويسة accept إلى application/json أو طلب XML باستخدام application/xml في الحالات التي لا يكون فيها هذا الخيار موقوفًا عن العمل. لا يُنصَح بأن تستخدم التكاملات الجديدة تنسيق المخرجات XML.

​
مثال

curl -X GET \
'http://api.benzinga.com/api/v2/calendar/ratings?token=YOUR_TOKEN_HERE&ratings=Upgrades' \
-H 'accept: application/json'