Skip to main content
GET
/
api
/
v2.2
/
calendar
/
dividends
أحداث توزيعات الأرباح V2.2
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.2/calendar/dividends?token=' \
  --header 'accept: <accept>'
{
  "dividends": [
    {}
  ]
}

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>

حقل تاريخ توزيع الأرباح للفرز (من الأحدث إلى الأقدم)

Available options:
announced,
ex,
payable,
record
​
parameters[dividend_yield_operation]
enum<string>

يحدد طريقة التصفية باستخدام عائد الأرباح (dividend yield). gt = أكبر من، gte = أكبر من أو يساوي، eq = يساوي، lt = أقل من، lte = أقل من أو يساوي

Available options:
gt,
gte,
eq,
lte,
lt
​
parameters[dividend_yield]
number

قيمة عائد الأرباح (Dividend Yield) المستخدمة كمعيار للتصفية. افتراضيًا يُستخدم عامل المطابقة "يساوي" للقيمة المحددة. 1 = 100٪

​
parameters[importance]
enum<integer>

مستوى الأهمية الذي تتم التصفية بناءً عليه. تُستخدم قيمة أكبر من أو تساوي مستوى الأهمية المحدَّد

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

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

​
parameters[updated]
integer

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

Response

نجاح

​
dividends
object[]