Você envia via POST date_from, date_to, e uma lista event_types obrigatória e não vazia para /api/v3/mundane/events/search.
Três filtros opcionais restringem famílias específicas: bodies limita sign_ingress, station e retrograde_period (o padrão são os sete planetas clássicos), to_signs filtra sign_ingress pelo signo de entrada, e cardinal_points restringe cardinal_ingress a estações específicas.
lunation_phases controla quais fases da Lua voltam, com padrão apenas Nova e Cheia.
Antes de qualquer cálculo rodar, a requisição tem seu custo calculado: se sua janela, tipos de evento e corpos seriam caros demais para escanear, a API recusa em milissegundos e relata a contagem de amostras que disparou a recusa, em vez de segurar um worker para uma varredura de vários segundos que sempre ia falhar.
Tudo que tem sucesso volta em um único array events[], ordenado ascendentemente por datetime_utc.
Um POST, oito famílias, custo verificado antes de rodar