Ações e índices

Agenda de proventos

Próximas datas-ex e pagamentos do mercado inteiro, por padrão de hoje até 90 dias à frente.

GEThttps://api.fintay.com.br/v1/b3/events/calendar

Autorização

X-API-Keystringheaderobrigatório

Chave de API criada em API Keys. Veja Chaves e limites.

Parâmetros de consulta

date_fromstring · date

Início da janela. Padrão: hoje.

date_tostring · date

Fim da janela. Padrão: 90 dias à frente.

asset_classstring

Classe do ativo (ex.: acao, fii).

event_typestring

Tipo de evento.

limitintegerpadrão: 500mín. 1 · máx. 2000

Máximo de eventos.

Resposta

Envelope { success, data, meta }. Campos de data.items[]:

tickerstring

Exemplo: CMIG3

series_idstring

Exemplo: 8e65aa8f-7819-4e3e-8d8a-b6e53a0f8772

namestring

Exemplo: Companhia Energetica de Minas Gerais SA

asset_classstring

Exemplo: acao

event_typestring

Exemplo: jcp

ex_datestring

Exemplo: 2025-03-26

payment_datestring

Exemplo: 2026-12-30

value_per_sharenumber

Exemplo: 0.09455892

factor_labelnull

GETAgenda de proventos

curl "https://api.fintay.com.br/v1/b3/events/calendar?limit=3" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "items": [
      {
        "ticker": "CMIG3",
        "series_id": "8e65aa8f-7819-4e3e-8d8a-b6e53a0f8772",
        "name": "Companhia Energetica de Minas Gerais SA",
        "asset_class": "acao",
        "event_type": "jcp",
        "ex_date": "2025-03-26",
        "payment_date": "2026-12-30",
        "value_per_share": 0.09455892,
        "factor_label": null
      },
      {
        "ticker": "CMIG4",
        "series_id": "db132ff4-52eb-4868-9546-957945ef7a12",
        "name": "Companhia Energetica de Minas Gerais SA Pfd",
        "asset_class": "acao",
        "event_type": "jcp",
        "ex_date": "2025-03-26",
        "payment_date": "2026-12-30",
        "value_per_share": 0.09455892,
        "factor_label": null
      },
      {
        "ticker": "CLSC3",
        "series_id": "f7c8d6a0-adee-4d88-8699-d09459692eb8",
        "name": "Centrais Eletricas de Santa Catarina S.A.",
        "asset_class": "acao",
        "event_type": "jcp",
        "ex_date": "2025-03-27",
        "payment_date": "2026-12-30",
        "value_per_share": 0.735488,
        "factor_label": null
      }
    ],
    "total": 3,
    "date_from": "2026-10-18",
    "date_to": "2027-01-16"
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}