From one query to reliable delivery

Astrological Event Intelligence

Search, filter, save, schedule, export, and deliver deterministic event data as one workflow. Cosmic Ephemeris combines its unified event calendar, exact aspect windows, Moon-phase filters, saved searches, durable jobs, and signed job-completion webhooks without adding generated predictions or advice.

The complete workflow

1. Search and filter

Query a bounded UTC interval for Moon phases, ingresses, stations, aspects, or exact-hit-anchored aspect windows. Narrow Moon results to selected phase sectors.

2. Save and schedule

Create and edit strict event-calendar criteria in the dashboard, or create event-rule-search criteria through the API. The dashboard safely displays both saved-operation types and can schedule either one; event-rule-search criteria remain API-managed.

3. Export

Request deterministic iCalendar or CSV text inside the response, including stable event identifiers and explicit interval conventions.

4. Deliver

Each due schedule enqueues a durable job for its saved operation: event-calendar or event-rule-search. Completion flows through the existing signed webhook delivery path.

Operational guarantees and limits

  • Scheduled runs reuse the selected API key's scope, environment policy, monthly quota, per-key budget, and account entitlement.
  • Every scheduled result is a normal durable job result; the scheduler never calculates inside the scheduler process.
  • Jobs remain globally serial. A schedule does not create customer-selectable parallelism or bypass the queue.
  • One saved event search can have one schedule; each account can hold at most ten schedules.
  • Ambiguous interpretation, ranking, notification prose, and astrological advice remain application responsibilities.

APIs in the workflow

POST /api/astro/event-calendar and POST /api/astro/event-rule-search perform synchronous searches. POST /api/jobs submits either operation as a durable calculation. Dashboard-session routes under /api/saved-event-searches and /api/event-search-schedules manage reusable criteria and schedules; the dashboard creates and edits event-calendar criteria while API-created event-rule-search criteria remain visible and schedulable. Signed webhook delivery remains tied to job completion.

Schedule timestamps and windows are UTC. Search boundaries are start-inclusive and end-exclusive. Consult the endpoint schema for the exact supported bodies, aspects, limits, and exports.