메인 콘텐츠로 건너뛰기
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": "요청을 처리하는 동안 예기치 않은 오류가 발생했습니다"
    }
  ]
}

인증

​
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). سيؤدي هذا إلى فرض ترتيب فرز يكون أكبر من أو يساوي الطابع الزمني المحدَّد

응답

نجاح

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

​
dividends
object[]