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": [
    {
      "confirmed": true,
      "currency": "USD",
      "cusip": 37833100,
      "date": "2024-01-09T00:00:00.000Z",
      "dividend": "0.25",
      "dividend_prior": "0.24",
      "dividend_type": "Cash",
      "dividend_yield": "0.55",
      "end_regular_dividend": false,
      "ex_dividend_date": "2024-01-12T00:00:00.000Z",
      "exchange": "NASDAQ",
      "frequency": 4,
      "id": "60a7f5e8e4b0f5a3c8e9f5a7",
      "importance": 3,
      "isin": "US0378331005",
      "name": "Apple Inc.",
      "notes": "Regular quarterly dividend",
      "payable_date": "2024-02-15T00:00:00.000Z",
      "period": "Q1",
      "record_date": "2024-01-15T00:00:00.000Z",
      "ticker": "AAPL",
      "updated": 1704819600,
      "year": 2024
    }
  ]
}

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

نجاح

استجابة واجهة برمجة التطبيقات API التي تتضمن مصفوفة سجلات للتوزيعات

​
dividends
object[]