Planetary Events API (Retrogrades, Eclipses)

Planetary events: sign changes, retrograde stations and eclipses, with IST times

GET/v1/transits/events

1 credit · Secret or publishable key · listPlanetaryEvents

Every sign change of the Sun, Mercury, Venus, Mars, Jupiter, Saturn, Rahu and Ketu, every retrograde and direct station (the nodes' too with include_nodes), and every solar and lunar eclipse, from from to to: the date and time in IST (to the minute, found by bisection between IST midnights) and at, the exact instant; the planet, the sign(s), and the engine's one-line impact, note and tag. note is an English sentence; note_id names its template and tag is one of major, moderate, eclipse. Sorted by instant.

Parameters

Name	In	Type	Notes
`from` required	query	string	A date (from 00:00 UTC) or an ISO 8601 instant. pattern `^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z\|[+-]\d{2}:\d{2}))?$` · e.g. `"2026-10-01"`, `"2026-10-01T06:30:00Z"`
`to` required	query	string	A date or an instant; eclipses are listed up to this instant, day events through its date. At most 1,100 days after from. pattern `^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z\|[+-]\d{2}:\d{2}))?$` · e.g. `"2026-12-31"`
`include_nodes`	query	boolean	Also list the stations of the true node (Rahu; Ketu's are the same moments). They are short and frequent: the true node turns direct for a few days most months. Sampled daily, so a direct run shorter than a day can be missed. default `false`
`lang`	query	string	one of `en`, `hi` · default `"en"`
`tone`	query	string	descriptive: reviewed descriptive sentences in the prose fields, in lang; ids and values unchanged (as options.tone). one of `default`, `descriptive` · default `"default"`

Response

JSON { data, meta, warnings }, where data is:

events array of object required
- date string (date) required
  e.g. "1990-08-13"
- time_ist string or null required
  One of:
  1. string
  2. null
- at string (date-time) or null required
  One of:
  1. string (date-time)
  2. null
- planet string required
- type string required
  one of sign_change, retrograde_start, retrograde_end, solar_eclipse, lunar_eclipse
- from_sign string or null required
  One of:
  1. string
  2. null
- to_sign string or null required
  One of:
  1. string
  2. null
- sign string or null required
  One of:
  1. string
  2. null
- eclipse_type string or null required
  One of:
  1. string
  2. null
- impact string required
- note string required
- note_id string required
  A stable id for note's template: sign_change_<planet>, retrograde_start, retrograde_end, solar_eclipse_<total|annular|hybrid|partial>, lunar_eclipse_<total|partial|penumbral>. Show your own copy keyed on it.
- tag string required
  one of major, moderate, eclipse

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl 'https://api.astrologics.in/v1/transits/events?from=2026-10-01&to=2026-12-31' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'

Node.js

const res = await fetch("https://api.astrologics.in/v1/transits/events?from=2026-10-01&to=2026-12-31", {
  headers: { Authorization: "Bearer al_test_YOUR_KEY" },
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

req = urllib.request.Request(
    "https://api.astrologics.in/v1/transits/events?from=2026-10-01&to=2026-12-31",
    method="GET",
    headers={"Authorization": "Bearer al_test_YOUR_KEY"},
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/transits/events?from=2026-10-01&to=2026-12-31');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 8,366 characters

{
  "data": {
    "events": [
      {
        "date": "2026-10-03",
        "time_ist": "12:40",
        "at": "2026-10-03T07:09:54.000Z",
        "planet": "venus",
        "type": "retrograde_start",
        "from_sign": null,
        "to_sign": null,
        "sign": "libra",
        "eclipse_type": null,
        "impact": "Caution",
        "note": "Venus turns retrograde in Libra - review plans; delays and second thoughts are common",
        "note_id": "retrograde_start",
        "tag": "moderate"
      },
      {
        "date": "2026-10-17",
        "time_ist": "19:52",
        "at": "2026-10-17T14:22:07.000Z",
        "planet": "sun",
        "type": "sign_change",
        "from_sign": "virgo",
        "to_sign": "libra",
        "sign": null,
        "eclipse_type": null,
        "impact": "Medium",
        "note": "Sun enters Libra - Leadership, authority and career matters come into focus",
        "note_id": "sign_change_sun",
        "tag": "moderate"
      },
      {
        "date": "2026-10-24",
        "time_ist": "12:44",
        "at": "2026-10-24T07:14:20.000Z",
        "planet": "mercury",
        "type": "retrograde_start",
        "from_sign": null,
        "to_sign": null,
        "sign": "libra",
        "eclipse_type": null,
        "impact": "Caution",
        "note": "Mercury turns retrograde in Libra - review plans; delays and second thoughts are common",
        "note_id": "retrograde_start",
        "tag": "moderate"
      },
      {
        "date": "2026-10-31",
        "time_ist": "12:09",
        "at": "2026-10-31T06:38:48.000Z",
        "planet": "jupiter",
        "type": "sign_change",
        "from_sign": "cancer",
        "to_sign": "leo",
        "sign": null,
        "eclipse_type": null,
        "impact": "Major",
        "note": "Jupiter enters Leo - A season of growth, wisdom, learning and opportunity",
        "note_id": "sign_change_jupiter",
        "tag": "major"
      },
      {
        "date": "2026-11-06",
        "time_ist": "00:46",
        "at": "2026-11-05T19:15:54.000Z",
        "planet": "venus",
        "type": "sign_change",
        "from_sign": "libra",
        "to_sign": "virgo",
        "sign": null,
        "eclipse_type": null,
        "impact": "Medium",
        "note": "Venus enters Virgo - Love, relationships, comfort and creativity get attention",
        "note_id": "sign_change_venus",
        "tag": "moderate"
      },
      {
        "date": "2026-11-12",
        "time_ist": "20:19",
        "at": "2026-11-12T14:48:51.000Z",
        "planet": "mars",
        "type": "sign_change",
        "from_sign": "cancer",
        "to_sign": "leo",
        "sign": null,
        "eclipse_type": null,
        "impact": "Strong",
        "note": "Mars enters Leo - Energy, courage and drive run high - channel it into action",
        "note_id": "sign_change_mars",
        "tag": "moderate"
      },
      {
        "date": "2026-11-13",
        "time_ist": "21:23",
        "at": "2026-11-13T15:52:57.000Z",
        "planet": "mercury",
        "type": "retrograde_end",
        "from_sign": null,
        "to_sign": null,
        "sign": "libra",
        "eclipse_type": null,
        "impact": "Positive",
        "note": "Mercury turns direct in Libra - clarity returns, forward momentum resumes",
        "note_id": "retrograde_end",
        "tag": "moderate"
      },
      {
        "date": "2026-11-14",
        "time_ist": "05:51",
        "at": "2026-11-14T00:21:00.000Z",
        "planet": "venus",
        "type": "retrograde_end",
        "from_sign": null,
        "to_sign": null,
        "sign": "virgo",
        "eclipse_type": null,
        "impact": "Positive",
        "note": "Venus turns direct in Virgo - clarity returns, forward momentum resumes",
        "note_id": "retrograde_end",
        "tag": "moderate"
      },
      {
        "date": "2026-11-16",
        "time_ist": "19:43",
        "at": "2026-11-16T14:13:22.000Z",
        "planet": "sun",
        "type": "sign_change",
        "from_sign": "libra",
        "to_sign": "scorpio",
        "sign": null,
        "eclipse_type": null,
        "impact": "Medium",
        "note": "Sun enters Scorpio - Leadership, authority and career matters come into focus",
        "note_id": "sign_change_sun",
        "tag": "moderate"
      },
      {
        "date": "2026-11-22",
        "time_ist": "17:29",
        "at": "2026-11-22T11:59:17.000Z",
        "planet": "venus",
        "type": "sign_change",
        "from_sign": "virgo",
        "to_sign": "libra",
        "sign": null,
        "eclipse_type": null,
        "impact": "Medium",
        "note": "Venus enters Libra - Love, relationships, comfort and creativity get attention",
        "note_id": "sign_change_venus",
        "tag": "moderate"
      },
      {
        "date": "2026-11-25",
        "time_ist": "17:14",
        "at": "2026-11-25T11:43:50.000Z",
        "planet": "rahu",
        "type": "sign_change",
        "from_sign": "aquarius",
        "to_sign": "capricorn",
        "sign": null,
        "eclipse_type": null,
        "impact": "Major",
        "note": "Rahu enters Capricorn - Sudden change, ambition and unconventional paths come up",
        "note_id": "sign_change_rahu",
        "tag": "major"
      },
      {
        "date": "2026-11-25",
        "time_ist": "17:14",
        "at": "2026-11-25T11:43:50.000Z",
        "planet": "ketu",
        "type": "sign_change",
        "from_sign": "leo",
        "to_sign": "cancer",
        "sign": null,
        "eclipse_type": null,
        "impact": "Major",
        "note": "Ketu enters Cancer - A turn inward - detachment, research and spirituality",
        "note_id": "sign_change_ketu",
        "tag": "major"
      },
      {
        "date": "2026-12-02",
        "time_ist": "17:27",
        "at": "2026-12-02T11:57:20.000Z",
        "planet": "mercury",
        "type": "sign_change",
        "from_sign": "libra",
        "to_sign": "scorpio",
        "sign": null,
        "eclipse_type": null,
        "impact": "Fast",
        "note": "Mercury enters Scorpio - Communication, learning, trade and short travel are highlighted",
        "note_id": "sign_change_mercury",
        "tag": "moderate"
      },
      {
        "date": "2026-12-11",
        "time_ist": "04:53",
        "at": "2026-12-10T23:23:24.000Z",
        "planet": "saturn",
        "type": "retrograde_end",
        "from_sign": null,
        "to_sign": null,
        "sign": "pisces",
        "eclipse_type": null,
        "impact": "Positive",
        "note": "Saturn turns direct in Pisces - clarity returns, forward momentum resumes",
        "note_id": "retrograde_end",
        "tag": "major"
      },
      {
        "date": "2026-12-13",
        "time_ist": "06:29",
        "at": "2026-12-13T00:58:53.000Z",
        "planet": "jupiter",
        "type": "retrograde_start",
        "from_sign": null,
        "to_sign": null,
        "sign": "leo",
        "eclipse_type": null,
        "impact": "Caution",
        "note": "Jupiter turns retrograde in Leo - review plans; delays and second thoughts are common",
        "note_id": "retrograde_start",
        "tag": "major"
      },
      {
        "date": "2026-12-16",
        "time_ist": "10:25",
        "at": "2026-12-16T04:55:01.000Z",
        "planet": "sun",
        "type": "sign_change",
        "from_sign": "scorpio",
        "to_sign": "sagittarius",
        "sign": null,
        "eclipse_type": null,
        "impact": "Medium",
        "note": "Sun enters Sagittarius - Leadership, authority and career matters come into focus",
        "note_id": "sign_change_sun",
        "tag": "moderate"
      },
      {
        "date": "2026-12-22",
        "time_ist": "07:40",
        "at": "2026-12-22T02:10:25.000Z",
        "planet": "mercury",
        "type": "sign_change",
        "from_sign": "scorpio",
        "to_sign": "sagittarius",
        "sign": null,
        "eclipse_type": null,
        "impact": "Fast",
        "note": "Mercury enters Sagittarius - Communication, learning, trade and short travel are highlighted",
        "note_id": "sign_change_mercury",
        "tag": "moderate"
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

from (query)

to (query)

include_nodes (query)

lang (query)

tone (query)

Planetary Events API (Retrogrades, Eclipses)

Parameters

Response

Example request

Example response

More in Transits