Astrology

Gochar — Transit Analysis

Computes planetary transits against a natal chart using classical Vedic rules. Returns house positions from Moon and Lagna, Vedha obstruction checks, raw Bhinna Ashtakavarga bindus for each transit sign (5+ makes a transit favourable, 3 or fewer unfavourable, whatever the house), Sade Sati and Chandra Ashtama flags, and classical transit interpretations for all 9 planets. Request JSON follows BirthInput plus optional transit fields target_date, target_time, target_timezone: name, date, time, location or latitude/longitude/timezone, ayanamsa.

post/v1/astro/gochar

Request

  • Base URL: https://api.asterwise.com
  • URL: https://api.asterwise.com/v1/astro/gochar
  • Auth: HTTP bearer

Request body

locationstring nullable

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

namestring

Person name associated with the birth record

datestring required

Birth date in YYYY-MM-DD format

timestring required

Birth time in HH:MM 24-hour format. Required: this endpoint has no sunrise fallback.

latitudenumber nullable

Latitude. Required if location not provided.

longitudenumber nullable

Longitude. Required if location not provided.

timezonestring nullable

IANA timezone. Required if location not provided (unless utc_offset is given). For dates before the zone adopted a standard time, the birthplace's local mean time (longitude / 15 hours) is used.

utc_offsetstring nullable

Optional explicit UTC offset of the birth time, as ±HH:MM or ±HH:MM:SS (e.g. '+04:51:31' for Bombay mean time). Overrides the offset timezone would give. Use it when the birth record states the offset, or for historical local times the IANA database cannot represent.

ayanamsa'lahiri' | 'raman' | 'kp' | 'tropical'

Sidereal ayanamsa mode used in calculations

target_datestring nullable

YYYY-MM-DD. Defaults to today IST.

target_timestring nullable

Local clock time HH:MM in target_timezone. Defaults to 12:00. Pass the user's own time so the Moon is where the user sees it.

target_timezonestring nullable

IANA timezone for target_date and target_time. Defaults to Asia/Kolkata (kept for existing callers); pass the user's own timezone for anyone outside India.

Example request

{
  "ayanamsa": "lahiri",
  "date": "1985-11-12",
  "latitude": 19.055,
  "location": "Mumbai",
  "longitude": 72.8692,
  "name": "Arjun Mehta",
  "time": "06:45",
  "timezone": "Asia/Kolkata"
}

Response

Successful Response

successboolean

True if the request succeeded

messagestring

Human-readable status message

Example response

{
  "data": {
    "transits": [
      {
        "transit_tropical_sign": "Taurus"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.