Saltar al contenido principal
GET
/
api
/
v2.2
/
calendar
/
dividends
Eventos de dividendos 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
    }
  ]
}

Autorizaciones

​
token
string
query
requerido

Encabezados

​
accept
enum<string>
predeterminado:application/json
requerido

Especifica el formato de respuesta. Los parámetros de consulta funcionan igual para ambos formatos

Opciones disponibles:
application/json

Parámetros de consulta

​
page
integer
predeterminado:0

Desplazamiento de página. Por motivos de optimización, rendimiento y razones técnicas, los desplazamientos de página están limitados entre 0 y 100000. Limite los resultados de la consulta utilizando otros parámetros, como la fecha.

​
pagesize
integer

Número de resultados devueltos. Límite 1000

​
parameters[date]
string<YYYY-MM-DD>

Fecha para consultar datos de calendar. Abreviatura de date_from y date_to si son iguales. El valor predeterminado es latest.

​
parameters[date_from]
string<YYYY-MM-DD>

Fecha a partir de la cual realizar la consulta

​
parameters[date_to]
string<YYYY-MM-DD>

Fecha de fin de la consulta (punto en el tiempo)

​
parameters[date_sort]
enum<string>

Campo de fecha de dividendo para ordenar (de más reciente a más antiguo)

Opciones disponibles:
announced,
ex,
payable,
record
​
parameters[dividend_yield_operation]
enum<string>

Especifica cómo filtrar mediante el rendimiento por dividendos. gt = mayor que, gte = mayor o igual que, eq = igual, lt = menor que, lte = menor o igual que

Opciones disponibles:
gt,
gte,
eq,
lte,
lt
​
parameters[dividend_yield]
number

Importe de la rentabilidad por dividendo para filtrar. De forma predeterminada se utiliza Igual a el importe indicado. 1 = 100%

​
parameters[importance]
enum<integer>

El nivel de importancia por el que se va a filtrar. Utiliza un valor mayor o igual que la importancia indicada

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

Uno o más símbolos bursátiles separados por comas. Máximo 50 símbolos bursátiles

​
parameters[updated]
integer

Marca de tiempo Unix (UTC) de la última actualización de los registros. Esto obligará a que el orden de clasificación sea Mayor que o Igual que la marca de tiempo indicada

Respuesta

Éxito

​
dividends
object[]