Skip to main content
GET
/
api
/
v2.1
/
calendar
/
earnings
يُرجِع بيانات الأرباح
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/earnings?token=' \
  --header 'accept: <accept>'
{
  "earnings": [
    {}
  ]
}

Authorizations

​
token
string
query
required

Headers

​
accept
enum<string>
default:application/json
required

يحدِّد تنسيق الاستجابة. تعمل معلمات الاستعلام بالطريقة نفسها في كلا التنسيقين

Available options:
application/json

Query Parameters

​
page
integer
default:0

إزاحة الصفحة. لأسباب تتعلق بالتحسين والأداء والاعتبارات التقنية، تُقيَّد قيم إزاحة الصفحة بين 0 و100000. احصر نتائج الاستعلام باستخدام معاملات أخرى مثل التاريخ.

​
pagesize
integer

عدد النتائج المُرجَعة. الحد الأقصى 1000

​
parameters[date]
string<YYYY-MM-DD>

التاريخ المستخدم للاستعلام عن بيانات calendar. اختصار لـ date_from و date_to إذا كانتا متطابقتين. وفي حال عدم التحديد، تكون القيمة الافتراضية هي الأحدث

​
parameters[date_from]
string<YYYY-MM-DD>

تاريخ بدء الاستعلام كنقطة زمنية محددة

​
parameters[date_to]
string<YYYY-MM-DD>

تاريخ الاستعلام حتى هذه النقطة الزمنية

​
parameters[date_sort]
enum<string>

خيار حقل الفرز لتقويم الأرباح. استخدم :desc أو :asc لترتيب النتائج

Available options:
date
​
parameters[importance]
enum<integer>

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

Available options:
0,
1,
2,
3,
4,
5
​
parameters[tickers]
string<csv>

رمز تداول واحد أو أكثر مفصولة بفواصل. الحد الأقصى 50 رمز تداول

​
parameters[updated]
integer

الطابع الزمني بنظام Unix (بتوقيت UTC) لآخر تحديث للسجلات. سيؤدي هذا إلى فرض ترتيب فرز بشرط أن يكون أكبر من أو يساوي الطابع الزمني المُشار إليه

Response

نجاح

​
earnings
object[]