pub struct Forecast<'a>(/* private fields */);Expand description
Astrology forecast API that merges upcoming transit aspects, sign ingresses, retrograde stations, new and full moons, biorhythm critical days, and Vimshottari dasha changes into one time-ordered forecast for a single subject, with positions verified against NASA JPL Horizons. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.
Implementations§
Source§impl Forecast<'_>
impl Forecast<'_>
Sourcepub async fn find_significant_dates(
&self,
params: &FindSignificantDatesParams,
body: &FindSignificantDatesRequest,
) -> Result<FindSignificantDatesResponse, Error>
pub async fn find_significant_dates( &self, params: &FindSignificantDatesParams, body: &FindSignificantDatesRequest, ) -> Result<FindSignificantDatesResponse, Error>
Significant dates - High-significance cross-domain forecast highlights
Return only the high-significance dates from the merged cross-domain forecast for a single birth subject: the rare outer-planet exact transit aspects, slow-planet sign ingresses, retrograde stations, and Vimshottari mahadasha and antardasha changes that mark genuine turning points. Defaults to a significance floor of 70 so the response is a short list of the most meaningful upcoming dates. Built for what-is-coming highlights, timing alerts, and at-a-glance forecast strips.
POST /forecast/significant-dates
Sourcepub async fn forecast_solar_return(
&self,
params: &ForecastSolarReturnParams,
body: &ForecastSolarReturnRequest,
) -> Result<ForecastSolarReturnResponse, Error>
pub async fn forecast_solar_return( &self, params: &ForecastSolarReturnParams, body: &ForecastSolarReturnRequest, ) -> Result<ForecastSolarReturnResponse, Error>
Solar return chart - Annual birthday forecast chart for a single subject
Cast the solar return chart for one subject and year: the chart erected for the exact moment the transiting Sun returns to its natal ecliptic longitude, the foundational technique for annual astrological forecasting. Returns the full tropical chart with planetary positions, house cusps, aspects, Ascendant, and Midheaven. Location-sensitive: pass the birthplace to anchor the chart to natal geography, or the current city for a relocated solar return where the houses and Ascendant shift to where you are on your birthday. Built for year-ahead forecast tools, birthday charts, and annual horoscope features.
POST /forecast/solar-return
Sourcepub async fn forecast_transits(
&self,
params: &ForecastTransitsParams,
body: &ForecastTransitsRequest,
) -> Result<ForecastTransitsResponse, Error>
pub async fn forecast_transits( &self, params: &ForecastTransitsParams, body: &ForecastTransitsRequest, ) -> Result<ForecastTransitsResponse, Error>
Western astrology forecast - aspects, ingresses, stations, eclipses, moon phases
Forecast the western astrology events for a single birth chart over a window up to 90 days: every transit-to-natal major aspect refined to its exact instant, every transiting planet sign ingress, every retrograde or direct station, every solar and lunar eclipse, and every New and Full Moon. Returns a time-ordered, significance-scored timeline. Built for astrology forecast feeds, transit alerts, and timing tools.
POST /forecast/transits
Sourcepub async fn generate_digest(
&self,
params: &GenerateDigestParams,
body: &GenerateDigestRequest,
) -> Result<GenerateDigestResponse, Error>
pub async fn generate_digest( &self, params: &GenerateDigestParams, body: &GenerateDigestRequest, ) -> Result<GenerateDigestResponse, Error>
Forecast digest - Pre-summarized next 24h, 7d, 30d, and 90d rollups
Roll the cross-domain forecast for a single birth subject into four pre-summarized windows: the next 24 hours, 7 days, 30 days, and 90 days from the start date. Each window returns its event count, a per-domain count breakdown, a per-type count breakdown, and the top highest-significance events. Built for a glanceable what-is-coming strip so a caller can render the upcoming highlights without scanning the full event list.
POST /forecast/digest
Sourcepub async fn generate_timeline(
&self,
params: &GenerateTimelineParams,
body: &GenerateTimelineRequest,
) -> Result<GenerateTimelineResponse, Error>
pub async fn generate_timeline( &self, params: &GenerateTimelineParams, body: &GenerateTimelineRequest, ) -> Result<GenerateTimelineResponse, Error>
Cross-domain forecast timeline - Transits, ingresses, stations, dasha changes, critical days
Build one time-ordered forecast for a single birth subject by merging upcoming events across three domains: western transit-to-natal aspects, sign ingresses, retrograde stations, eclipses, and new and full moons; biorhythm critical days; and vedic Vimshottari mahadasha, antardasha, and pratyantardasha boundaries. The window is clamped to 90 days and events are capped and scored by significance. Built for what-is-coming dashboards, daily and weekly forecast feeds, and timing tools.
POST /forecast/timeline