Astrology forecast API
Dated facts for a chart: dasha changes, Sade Sati and Dhaiya, sign changes, natal degree hits, a monthly digest and the solar return. It says what happens and when, not what it will bring.
| Operation | Credits | Key |
|---|---|---|
POST /v1/forecast/timelineDasha changes, Sade Sati and Dhaiya, and Jupiter, Saturn and Rahu sign changes, in date order | 3 | secret |
POST /v1/forecast/transitsSign changes and the minutes a transiting planet reaches or opposes a natal point | 2 | secret |
POST /v1/forecast/significant-datesThe larger dates in a range: dasha changes, Saturn's periods, and Saturn, Jupiter and Rahu returns | 3 | secret |
POST /v1/forecast/digestOne month for a chart: the running periods, where the planets stand and the month's dated events | 2 | secret |
POST /v1/forecast/solar-returnThe minute the Sun returns to its birth longitude in a year, with the chart for that minute | 2 | secret |
Example: Dasha changes, Sade Sati and Dhaiya, and Jupiter, Saturn and Rahu sign changes, in date order
POST /v1/forecast/timeline · 200 OK
{
"data": {
"from": "2026-11-01",
"to": "2027-12-31",
"running_at_start": {
"mahadasha": {
"lord": "rahu",
"until": "2044-06-21T04:53:13.747Z"
},
"antardasha": {
"lord": "rahu",
"until": "2029-03-03T21:05:13.747Z"
},
"saturn_period": {
"period": "sade_sati",
"until": "2032-05-30T21:29:10.451Z"
}
},
"count": 6,
"events": [
{
"at": "2026-11-25T11:46:00.000Z",
"kind": "sign_change",
"planet": "rahu",
"sign": "capricorn",
"house_from_moon": 10,
"house_from_lagna": 6,
"natal_point": null,
"retrograde": true,
"summary": "Rahu enters Capricorn."
},
{
"at": "2027-01-24T20:01:00.000Z",
"kind": "sign_change",
"planet": "jupiter",
"sign": "cancer",
"house_from_moon": 4,
"house_from_lagna": 12,
"natal_point": null,
"retrograde": true,
"summary": "Jupiter enters Cancer."
},
{
"at": "2027-06-03T00:34:00.000Z",
"kind": "sign_change",
"planet": "saturn",
"sign": "aries",
"house_from_moon": 1,
"house_from_lagna": 9,
"natal_point": null,
"retrograde": false,
"summary": "Saturn enters Aries."
},
{
"at": "2027-06-25T23:46:00.000Z",
"kind": "sign_change",
"planet": "jupiter",
"sign": "leo",
"house_from_moon": 5,
"house_from_lagna": 1,
"natal_point": null,
"retrograde": false,
"summary": "Jupiter enters Leo."
},
{
"at": "2027-10-20T00:52:00.000Z",
"kind": "sign_change",
"planet": "saturn",
"sign": "pisces",
"house_from_moon": 12,
"house_from_lagna": 8,
"natal_point": null,
"retrograde": true,
"summary": "Saturn enters Pisces."
},
{
"at": "2027-11-26T13:08:00.000Z",
"kind": "sign_change",
"planet": "jupiter",
"sign": "virgo",
"house_from_moon": 6,
"house_from_lagna": 2,
"natal_point": null,
"retrograde": false,
"summary": "Jupiter enters Virgo."
}
],
"note": "Dated facts about the chart. They say what happens and when, not what it will bring."
},
"meta": {
"request_id": "req_example",
"api_version": "v1",
"engine_version": "2026.10.10",
"mode": "live",
"credits_charged": 3,
"ayanamsa": "lahiri",
"house_system": "whole_sign",
"node": "true",
"timezone_used": {
"name": "Asia/Kolkata",
"utc_offset": "+05:30",
"source": "auto"
}
},
"warnings": []
}