メインコンテンツへスキップ
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": 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
    }
  ]
}

{
  "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>

配当利回りでフィルタリングする方法を指定します。gt = より大きい（Greater Than）、gte = 以上（Greater Than Equal）、eq = 等しい（Equal）、lt = より小さい（Less Than）、lte = 以下（Less Than Equal）

利用可能なオプション:
gt,
gte,
eq,
lte,
lt
​
parameters[dividend_yield]
number

フィルタに使用する配当利回りの値。既定では、指定した値と等しい条件でフィルタします。1 = 100%

​
parameters[importance]
enum<integer>

フィルタに使用する重要度レベル。指定した重要度以上のものを対象とします

利用可能なオプション:
0,
1,
2,
3,
4,
5
​
parameters[tickers]
string<csv>

カンマ区切りのティッカーシンボルを1つ以上指定します。最大50件まで。

​
parameters[updated]
integer

レコードが最後に更新された時刻を示す Unix タイムスタンプ（UTC）。これを指定すると、ソート順は指定したタイムスタンプ以上のレコードに強制されます。

レスポンス

成功

​
dividends
object[]