Skip to main content
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": true,
      "currency": "USD",
      "cusip": 37833100,
      "date": "2024-01-09T00:00:00.000Z",
      "dividend": "0.25",
      "dividend_prior": "0.24",
      "dividend_type": "Cash",
      "dividend_yield": "0.55",
      "end_regular_dividend": false,
      "ex_dividend_date": "2024-01-12T00:00:00.000Z",
      "exchange": "NASDAQ",
      "frequency": 4,
      "id": "60a7f5e8e4b0f5a3c8e9f5a7",
      "importance": 3,
      "isin": "US0378331005",
      "name": "Apple Inc.",
      "notes": "Regular quarterly dividend",
      "payable_date": "2024-02-15T00:00:00.000Z",
      "period": "Q1",
      "record_date": "2024-01-15T00:00:00.000Z",
      "ticker": "AAPL",
      "updated": 1704819600,
      "year": 2024
    }
  ]
}

Authorizations

​
token
string
query
required

Headers

​
accept
enum<string>
default:application/json
required

返却形式を指定します。クエリパラメータはどちらの形式でも同様に動作します

Available options:
application/json

Query Parameters

​
page
integer
default: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>

配当日でソートするためのフィールド（新しいものから古いものの順序）

Available options:
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）

Available options:
gt,
gte,
eq,
lte,
lt
​
parameters[dividend_yield]
number

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

​
parameters[importance]
enum<integer>

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

Available options:
0,
1,
2,
3,
4,
5
​
parameters[tickers]
string<csv>

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

​
parameters[updated]
integer

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

Response

成功

配当レコードの配列を含む API レスポンス

​
dividends
object[]