Forecast API
Ship a cross-domain forecast your users can plan around. This week.
Start building in seconds.
npm install @roxyapi/sdkimport { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.forecast.get(/* ... */)pip install roxy-sdkfrom roxy_sdk import create_roxy
roxy = create_roxy("your-api-key")
result = roxy.forecast.get(...) # async: await roxy.forecast.get_async(...)composer require roxyapi/sdkuse function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->forecast->get(/* ... */);curl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/forecast/claude mcp add --transport http \
roxy-forecast https://roxyapi.com/mcp/forecast \
--header "X-API-Key: YOUR_KEY"AI agents auto-discover all 3 endpoints as callable tools. Zero configuration.
Want to ship faster? Clone a free starter app and go from zero to production in 30 minutes.
Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app in minutes.
{
"startDate": "2026-06-01",
"endDate": "2026-08-30",
"count": 3,
"events": [
{
"date": "2026-06-09",
"datetime": "2026-06-09T11:02:44Z",
"domain": "western",
"type": "retrograde-station",
"body": "Saturn",
"station": "retrograde",
"description": "Saturn stations retrograde, beginning a review phase in its themes.",
"significance": 80
},
{
"date": "2026-07-04",
"datetime": "2026-07-04T08:42:11Z",
"domain": "western",
"type": "transit-aspect",
"body": "Saturn",
"target": "Moon",
"aspect": "square",
"orb": 0.12,
"description": "Transiting Saturn square natal Moon, an exact aspect within 0.12 degrees.",
"significance": 90
},
{
"date": "2026-08-21",
"datetime": "2026-08-21T00:00:00Z",
"domain": "vedic",
"type": "dasha-change",
"body": "Saturn-Mercury Antardasha",
"description": "Vimshottari Mercury Antardasha begins within the Saturn Mahadasha, shifting the active sub-period.",
"significance": 74
}
]
}Structured JSON with documented fields. Not hallucinated text. See all 3 endpoints
Works with your stack
Merge upcoming transit aspects, sign ingresses, retrograde stations, Vimshottari dasha changes, and biorhythm critical days into one time-ordered forecast for a single subject. The only cross-domain forecast timeline behind one key, positions verified against NASA JPL Horizons, available over remote MCP with typed SDKs. Horizon capped at 90 days.
Key Features
Everything you need from our Forecast API, built for production:
One merged timeline across three engines: western transit-to-natal aspects, sign ingresses, and retrograde stations, vedic Vimshottari mahadasha and antardasha boundaries, and biorhythm critical days
Single subject per request and one forecast per response, a stateless bounded forecast rather than an open-ended batch scan
Server-clamped 90 day horizon and a 200 event cap, with the highest-significance events surviving the cap
Every astronomical event refined to its exact instant by search, not reported at a coarse daily sample point
Significance scoring from 0 to 100 so outer-planet exact aspects and mahadasha changes rank above fast Moon events and critical days
Selectable domains: request the full cross-domain merge, a western-only transit forecast, or just the high-significance dates
All 3 Endpoints
Click any endpoint to view detailed documentation, parameters, and response examples.
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, and retrograde stations; vedic Vimshottari mahadasha and antardasha boundaries; and biorhythm critical days. 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.
Western transit forecast - Transit aspects, sign ingresses, retrograde stations
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, and every retrograde or direct station. Returns a time-ordered, significance-scored timeline. Built for astrology forecast feeds, transit alerts, and timing tools.
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.
What You Can Build with Forecast API
Real-world applications and use cases for integrating Forecast API into your projects:
Spiritual and self-discovery apps: a forward-looking what is coming digest that blends astrology and biorhythm in one call
AI chatbots and coaching assistants: significant-date awareness via remote MCP tool calls for timing conversations
Wellness and mindfulness platforms: critical-day and transit alerts for planning demanding or restful periods
Calendar and planner integrations: a time-ordered event stream ready to drop onto a date strip or notification feed
Astrology and Vedic practitioner tools: upcoming transits, stations, and dasha boundaries for one client at a time
Content and editorial platforms: significant upcoming dates for forecast columns and personalized timing pages
What developers are saying
Dhani M.
Indie App Developer
Shipped an astrology app over a long weekend. Birth charts, nakshatras, KP cusps, significators. I verified the Lahiri ayanamsha values independently and they line up with my reference. One API key for all of it.
Tom H.
Senior Developer
The OpenAPI spec is the most complete I have seen in this space. Generated a type-safe TypeScript client from it in seconds. Every field has descriptions and examples. Production-grade documentation.
Chris W.
Backend Engineer
Response times consistently under 50ms for numerology and tarot endpoints. The API returns structured JSON with every field documented. Integrated it into our platform in an afternoon.
Getting started with Forecast API.
From zero to production in 3 steps. No signup required for testing.
3 Steps to Ship
| 1Install the SDK | npm i @roxyapi/sdk |
| 2Get your API key | View Plans |
| 3Make your first call | View Docs |
Agent-Ready Infrastructure
MCPRemote MCP, llms.txt, and AGENTS.md. The full agent-readiness stack for 12 spiritual domains under one key.
- Remote MCP server — 3 tools auto-discovered by Claude, ChatGPT, Cursor over Streamable HTTP. No Docker.
- llms.txt — AI-native discovery surface for ChatGPT, Perplexity, and Gemini citation
- AGENTS.md — 2026 execution playbook for Cursor, Codex, Windsurf, Aider, Claude Code, Gemini CLI. Bundled in the SDK.
Start using Forecast API today.
Ship a cross-domain forecast your users can plan around. This week.
All 12 domains included with every plan. 3+ endpoints, MCP server, SDK, and starters.
Plans from $39/mo — thats $3.25 per domain. No credit card required for testing.
View Pricing & Get API Key