Forecast API

The forecast API returns a clean transit forecast for any birth chart over the days ahead: transiting planet to natal aspects, sign ingresses, retrograde and direct stations, eclipses, and new and full moons, each one placed at its exact instant rather than a rough daily sample. Every event carries a significance score from 0 to 100, so an outer planet aspect ranks above a passing Moon event and your feed leads with what matters. Positions come from Roxy Ephemeris, verified against NASA JPL Horizons. One key also unlocks eleven more spiritual data domains, with instant activation and flat pricing.

This is the standout. A single call merges Western transits, Vedic Vimshottari dasha periods, and biorhythm critical days into one time ordered, significance scored timeline that no single domain service ships. You get the whole picture of what is coming for a person in one response, ready to drop onto a date strip or notification feed. Start with the natural call for the full merge, then narrow to the engines you want or raise the significance floor to trim noise. Call it from the typed SDKs for TypeScript, Python, or PHP, or from our Remote MCP server with no local setup and no Docker.

The forecast API can return just the high significance turning points from the merged timeline: rare outer planet aspects, slow planet sign ingresses, retrograde stations, eclipses, and major Vimshottari dasha changes. Significance runs from 0 to 100, so the big shifts outrank the everyday ones and the result reads like a curated astrological calendar rather than a firehose. That makes it ready for timing alerts, year ahead pages, and at a glance forecast strips. Drop it onto a WordPress site with our plugin, or wire it up with our UI components.

Ask the timeline for the Vedic engine and it marks the exact boundaries where each Vimshottari mahadasha, antardasha, and pratyantardasha period begins inside your window. Each boundary names the period and carries a significance score, so a major mahadasha shift ranks above a faster sub period change. Because it is the same cross domain call, those dasha dates interleave with Western transits and biorhythm critical days in one sorted timeline behind a single key. Agents can pull the same data through our Remote MCP server, and an AGENTS.md and llms.txt make the whole catalog easy for tools to discover.

The forecast API surfaces the new moon and full moon for your window, each refined to its exact instant and tagged with its sign, alongside eclipses classified as penumbral, partial, annular, or total. They arrive inside the same timeline as your transits and dasha dates, so a lunar calendar and a personalized forecast come from one request. Every instant is computed by Roxy Ephemeris and verified against NASA JPL Horizons. The descriptions localize across eight languages while the underlying event types stay stable, so you can branch on them safely.

The forecast API casts a solar return for the exact moment the Sun returns to its natal position, the foundational technique for annual birthday and year ahead readings. It returns the full chart with planetary positions, house cusps, aspects, the Ascendant, and the Midheaven. Anchor it to the birthplace, or pass the current location for a relocated solar return where the houses shift to where the person spends their birthday. It is one of twelve domains behind a single key, callable from the typed SDKs and our Remote MCP server, with positions verified against NASA JPL Horizons.