أحداث توزيعات الأرباح V2.2
curl --request GET \
--url 'https://api.benzinga.com/api/v2.2/calendar/dividends?token=' \
--header 'accept: <accept>'import requests
url = "https://api.benzinga.com/api/v2.2/calendar/dividends?token="
headers = {"accept": "<accept>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {accept: '<accept>'}};
fetch('https://api.benzinga.com/api/v2.2/calendar/dividends?token=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.benzinga.com/api/v2.2/calendar/dividends?token=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"accept: <accept>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.benzinga.com/api/v2.2/calendar/dividends?token="
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("accept", "<accept>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.benzinga.com/api/v2.2/calendar/dividends?token=")
.header("accept", "<accept>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.benzinga.com/api/v2.2/calendar/dividends?token=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["accept"] = '<accept>'
response = http.request(request)
puts response.read_body{
"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
}
]
}
{
"ok": false,
"errors": [
{
"code": "auth_failed",
"id": "unauthorized",
"value": "رمز الوصول للمصادقة غير صالح أو غير موجود"
}
]
}
{
"ok": false,
"errors": [
{
"code": "no_data_found",
"id": "not_found",
"value": "لم يتم العثور على بيانات للمعلمات المحددة"
}
]
}
{
"ok": false,
"errors": [
{
"code": "internal_server_error",
"id": "server_error",
"value": "حدث خطأ غير متوقع أثناء معالجة طلبك"
}
]
}
التقويمات
توزيعات الأرباح
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>'import requests
url = "https://api.benzinga.com/api/v2.2/calendar/dividends?token="
headers = {"accept": "<accept>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {accept: '<accept>'}};
fetch('https://api.benzinga.com/api/v2.2/calendar/dividends?token=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.benzinga.com/api/v2.2/calendar/dividends?token=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"accept: <accept>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.benzinga.com/api/v2.2/calendar/dividends?token="
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("accept", "<accept>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.benzinga.com/api/v2.2/calendar/dividends?token=")
.header("accept", "<accept>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.benzinga.com/api/v2.2/calendar/dividends?token=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["accept"] = '<accept>'
response = http.request(request)
puts response.read_body{
"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
}
]
}
{
"ok": false,
"errors": [
{
"code": "auth_failed",
"id": "unauthorized",
"value": "رمز الوصول للمصادقة غير صالح أو غير موجود"
}
]
}
{
"ok": false,
"errors": [
{
"code": "no_data_found",
"id": "not_found",
"value": "لم يتم العثور على بيانات للمعلمات المحددة"
}
]
}
{
"ok": false,
"errors": [
{
"code": "internal_server_error",
"id": "server_error",
"value": "حدث خطأ غير متوقع أثناء معالجة طلبك"
}
]
}
{
"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
}
]
}
{
"ok": false,
"errors": [
{
"code": "auth_failed",
"id": "unauthorized",
"value": "رمز الوصول للمصادقة غير صالح أو غير موجود"
}
]
}
{
"ok": false,
"errors": [
{
"code": "no_data_found",
"id": "not_found",
"value": "لم يتم العثور على بيانات للمعلمات المحددة"
}
]
}
{
"ok": false,
"errors": [
{
"code": "internal_server_error",
"id": "server_error",
"value": "حدث خطأ غير متوقع أثناء معالجة طلبك"
}
]
}
التفويضات
الترويسات
يُحدِّد تنسيق الإرجاع. تعمل معاملات الاستعلام بالطريقة نفسها في كلا التنسيقين
الخيارات المتاحة:
application/json معلمات الاستعلام
إزاحة الصفحة. لتحسين الأداء ولأسباب تقنية، تقتصر إزاحات الصفحات على النطاق من 0 حتى 100000. قيّد نتائج الاستعلام باستخدام معلمات أخرى مثل التاريخ.
عدد النتائج المُعادة. الحد الأقصى 1000
التاريخ المطلوب للاستعلام عن بيانات calendar. يُستخدم كاختصار لـ date_from وdate_to إذا كان التاريخان متماثلين. تكون القيمة الافتراضية هي أحدث تاريخ.
تاريخ إجراء الاستعلام اعتبارًا من نقطة زمنية معيّنة
تاريخ الاستعلام حتى نقطة زمنية محددة
حقل تاريخ توزيع الأرباح للفرز (من الأحدث إلى الأقدم)
الخيارات المتاحة:
announced, ex, payable, record يحدد طريقة التصفية باستخدام عائد الأرباح (dividend yield). gt = أكبر من، gte = أكبر من أو يساوي، eq = يساوي، lt = أقل من، lte = أقل من أو يساوي
الخيارات المتاحة:
gt, gte, eq, lte, lt قيمة عائد الأرباح (Dividend Yield) المستخدمة كمعيار للتصفية. افتراضيًا يُستخدم عامل المطابقة "يساوي" للقيمة المحددة. 1 = 100٪
مستوى الأهمية الذي تتم التصفية بناءً عليه. تُستخدم قيمة أكبر من أو تساوي مستوى الأهمية المحدَّد
الخيارات المتاحة:
0, 1, 2, 3, 4, 5 رمز تداول واحد أو أكثر، مفصولة بفواصل. الحد الأقصى 50 رمزًا من رموز الأسهم
طابع وقت آخر تحديث للسجلات بتنسيق Unix timestamp (UTC). سيؤدي هذا إلى فرض ترتيب فرز يكون أكبر من أو يساوي الطابع الزمني المحدَّد
الاستجابة
نجاح
استجابة واجهة برمجة التطبيقات API التي تتضمن مصفوفة سجلات للتوزيعات
Show child attributes
Show child attributes
هل كانت هذه الصفحة مفيدة؟