메인 콘텐츠로 건너뛰기
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 or Equal), eq = 같음(Equal), lt = 미만(Less Than), lte = 이하(Less Than or 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>

하나 이상의 티커 심볼을 쉼표로 구분해 입력합니다. 최대 50개까지 가능합니다

​
parameters[updated]
integer

레코드의 마지막 업데이트 시각을 나타내는 Unix 타임스탬프(UTC)입니다. 이 값을 사용하면 정렬 기준이 지정된 타임스탬프 이상(크거나 같음)인 레코드만 포함되도록 강제합니다.

응답

성공

​
dividends
object[]