Planetary transit API

Sign ingresses, retrograde/direct stations and combustion between two dates, transits over a birth chart, and planetary war now.

Operation	Credits	Key
`GET /v1/transits/events` Planetary events: sign changes, retrograde stations and eclipses, with IST times	1	secret or publishable
`GET /v1/transits` Ingresses, stations and combustion between dates	1	secret or publishable
`POST /v1/transits/natal` Transits over the natal Moon and houses	2	secret
`GET /v1/transits/graha-yuddha` Graha yuddha (planetary war) now: Mercury, Venus, Mars, Jupiter and Saturn within 1.5°	1	secret or publishable
`POST /v1/transits/aspects` Exact conjunctions, sextiles, squares, trines and oppositions over a range	2	secret
`POST /v1/transits/parallels` Exact parallels and contra-parallels of declination over a range	2	secret

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

GET /v1/transits/events · 200 OK

{
  "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 in the playground Full reference