Calendário de eventos macro

O Blave Agent pode acessar um calendário licenciado de eventos macro globais — horário de divulgação, consenso de mercado, valor anterior e valor real.

Cobertura

Divulgações econômicas e eventos de bancos centrais das principais economias. Uma linha por evento, trazendo o horário de divulgação programado, o consenso de mercado, o valor anterior e — assim que publicado — o valor real.

O calendário é uma janela móvel de cerca de cinco semanas — o mês anterior mais as próximas semanas — e não um arquivo histórico. Um intervalo fora dessa janela retorna vazio: isso significa que o intervalo não está coberto, não que nenhum evento tenha ocorrido.

Acessando os dados

O agente consulta o calendário por meio do helper compartilhado em lib/data.py:

from lib.data import fetch_economic_calendar

df = fetch_economic_calendar(
    headers,
    start='2026-07-01',
    end='2026-07-31',
    countries=['US', 'CN'],
    max_priority=1,
)

Retorna um DataFrame ordenado pelo horário do evento, uma linha por evento. Todos os parâmetros são opcionais, mas sem filtros o feed cobre todos os países e todas as prioridades — restrinja primeiro:

• start / end — Intervalo de datas, datas de Taipei no formato 'YYYY-MM-DD', inclusivo nas duas pontas
• countries — Lista de códigos de país ISO-2, ex.: ['US', 'CN', 'TW']; omita para todos os países
• max_priority — Mantém apenas eventos no nível de importância indicado ou acima; 1 é o mais importante e 3 o menos importante, então passe 1 para apenas as divulgações principais

Campos

• datetime — Horário do evento no horário de Taipei; eventos sem horário publicado usam 00:00 daquele dia como padrão
• date / time — Data de Taipei e 'HH:MM'; o horário fica vazio para eventos cujo horário de divulgação não é publicado
• country / country_name — Código de país ISO-2 e nome do país
• subject / subject_title — Nome do indicador e o período que a divulgação cobre
• predict — Consenso de mercado; vazio quando nenhum consenso é publicado
• last — Valor anterior, ou seja, a divulgação anterior do mesmo indicador
• real — Valor real; vazio até a divulgação
• unit — Unidade dos valores
• priority — Importância, 1–3 (1 = mais importante)