توزيعات الأرباح

يُرجع بيانات توزيعات الأرباح لفترة و/أو ورقة مالية محددة، بما في ذلك تواريخ توزيعات الأرباح المؤكدة وغير المؤكدة. تتضمن V2.2 حقولًا إضافية: confirmed و period و year. يوفّر هذا الإصدار معلومات أكثر تفصيلاً حول حالة تأكيد توزيعات الأرباح ودوريتها.

GET /api/v2.2/calendar/dividends

أحداث توزيعات الأرباح V2.2

cURL

curl --request GET \
  --url 'https://api.benzinga.com/api/v2.2/calendar/dividends?token=' \
  --header 'accept: <accept>'

استجابة (200 OK)

{
  "dividends": [
    {
      "confirmed": false,
      "currency": "USD",
      "cusip": "33740U620",
      "date": "2026-12-31",
      "dividend": "0.1636",
      "dividend_prior": "0.1636",
      "dividend_type": "Cash",
      "dividend_yield": "",
      "end_regular_dividend": false,
      "ex_dividend_date": "2027-01-04",
      "exchange": "BATS",
      "frequency": 12,
      "id": "6958d4d893cde40001ee2606",
      "importance": 1,
      "isin": "US33740U6203",
      "name": "First Trust Exchange-Traded Fund VIII FT Vest U.S. Equity Buffer & Premium Income ETF - March",
      "notes": "",
      "payable_date": "2027-01-05",
      "period": "JAN",
      "record_date": "2027-01-04",
      "ticker": "XIMR",
      "updated": 1767429336,
      "year": 2027
    },
    {
      "confirmed": false,
      "currency": "USD",
      "cusip": "33740F235",
      "date": "2026-12-31",
      "dividend": "0.1788",
      "dividend_prior": "0.1788",
      "dividend_type": "Cash",
      "dividend_yield": "",
      "end_regular_dividend": false,
      "ex_dividend_date": "2027-01-04",
      "exchange": "BATS",
      "frequency": 12,
      "id": "6958d4d393cde40001ee25f5",
      "importance": 1,
      "isin": "US33740F2359",
      "name": "First Trust Exchange-Traded Fund VIII FT Vest U.S. Equity Buffer & Premium Income ETF - June",
      "notes": "",
      "payable_date": "2027-01-05",
      "period": "JAN",
      "record_date": "2027-01-04",
      "ticker": "XIJN",
      "updated": 1767429331,
      "year": 2027
    }
  ]
}

استجابة (200 OK)

{
  "dividends": [
    {
      "confirmed": false,
      "currency": "USD",
      "cusip": "33740U620",
      "date": "2026-12-31",
      "dividend": "0.1636",
      "dividend_prior": "0.1636",
      "dividend_type": "Cash",
      "dividend_yield": "",
      "end_regular_dividend": false,
      "ex_dividend_date": "2027-01-04",
      "exchange": "BATS",
      "frequency": 12,
      "id": "6958d4d893cde40001ee2606",
      "importance": 1,
      "isin": "US33740U6203",
      "name": "First Trust Exchange-Traded Fund VIII FT Vest U.S. Equity Buffer & Premium Income ETF - March",
      "notes": "",
      "payable_date": "2027-01-05",
      "period": "JAN",
      "record_date": "2027-01-04",
      "ticker": "XIMR",
      "updated": 1767429336,
      "year": 2027
    },
    {
      "confirmed": false,
      "currency": "USD",
      "cusip": "33740F235",
      "date": "2026-12-31",
      "dividend": "0.1788",
      "dividend_prior": "0.1788",
      "dividend_type": "Cash",
      "dividend_yield": "",
      "end_regular_dividend": false,
      "ex_dividend_date": "2027-01-04",
      "exchange": "BATS",
      "frequency": 12,
      "id": "6958d4d393cde40001ee25f5",
      "importance": 1,
      "isin": "US33740F2359",
      "name": "First Trust Exchange-Traded Fund VIII FT Vest U.S. Equity Buffer & Premium Income ETF - June",
      "notes": "",
      "payable_date": "2027-01-05",
      "period": "JAN",
      "record_date": "2027-01-04",
      "ticker": "XIJN",
      "updated": 1767429331,
      "year": 2027
    }
  ]
}

التفويضات

token · string · query · مطلوب

الترويسات

accept · enum<string> · افتراضي: application/json · مطلوب

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

الخيارات المتاحة: application/json

معلمات الاستعلام

page · integer · افتراضي: 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>

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

الخيارات المتاحة: announced, ex, payable, record

parameters[dividend_yield_operation] · enum<string>

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

الخيارات المتاحة: gt, gte, eq, lte, lt

parameters[dividend_yield] · number

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

parameters[importance] · enum<integer>

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

الخيارات المتاحة: 0, 1, 2, 3, 4, 5

parameters[tickers] · string<csv>

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

parameters[updated] · integer

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

الاستجابة

200

application/json

نجاح

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

dividends · object[]

إظهار السمات الفرعية