Calendário

O Calendário reúne, numa só agenda, os eventos de empresas, BDRs e fundos listados:

• Agenda da companhia (CVM): divulgação de ITR e DFP, teleconferências, reuniões públicas, assembleias, Formulário de Referência e Informe de Governança.
• Eventos corporativos em ações (B3): desdobramentos, grupamentos, bonificações, subscrições, incorporações, cisões e resgates.
• Proventos em dinheiro: dividendos, juros sobre capital próprio, restituições de capital, rendimentos e amortizações de fundos.

Cada data de um evento vira uma entrada do calendário. Um dividendo com data com, data ex e data de pagamento aparece em até três dias, e cada entrada traz todas as datas do evento.

Rotas

Rota	Escopo	Uso
GET /v2/calendar	@calendar/list	Eventos de uma janela de dias, agrupados por data.
GET /v2/calendar/changes	@calendar/changes/list	Eventos removidos ou com tickers alterados desde um instante, para manter uma cópia local sincronizada.

Datas

• O calendário usa dias de São Paulo. "Hoje" é o dia atual em São Paulo, qualquer que seja o fuso do servidor ou do cliente.
• Cada data é guardada como meia-noite em São Paulo, que é 03:00 UTC. Por exemplo, "2026-11-23T03:00:00.000Z" é o dia 23/11/2026.
• Os parâmetros start_date e end_date são dias de São Paulo no formato AAAA-MM-DD.

Manter uma cópia local sincronizada

1. Anote o instante atual, menos alguns minutos de margem (receber uma mudança duas vezes não causa problema). Depois, carregue as janelas que você usa com GET /v2/calendar.
2. Consulte GET /v2/calendar/changes?since=<instante>. Apague os ids de removed e troque os tickers dos ids de updated. Chame de novo com metadata.next_since até as duas listas virem vazias.
3. Quando metadata.full_resync for true, recarregue o calendário e continue a partir de metadata.next_since.

A rota de mudanças não lista eventos novos. Para receber eventos novos e versões novas de eventos reapresentados, consulte GET /v2/calendar de novo.