أحداث توزيعات الأرباح 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