Gochar — Transit Analysis

Computes planetary transits against a natal chart using classical Vedic rules. Returns house positions from Moon and Lagna, Vedha obstruction checks, Ashtakavarga Bhinna scores, 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.

Endpoint

POST /v1/astro/gochar

Request parameters

Field	Type	Required	Description
location	string | null	No	City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.
name	string	No	Person name associated with the birth record
date	string	Yes	Birth date in YYYY-MM-DD format
time	string | null	No	Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.
latitude	number | null	No	Latitude. Required if location not provided.
longitude	number | null	No	Longitude. Required if location not provided.
timezone	string | null	No	IANA timezone. Required if location not provided.
ayanamsa	string	No	Sidereal ayanamsa mode used in calculations
target_date	string | null	No	YYYY-MM-DD. Defaults to today IST.
target_time	string | null	No	HH:MM. Defaults to noon.
target_timezone	string | null	No	Timezone for target_date/time.

Example request

curl

curl -X POST "https://api.asterwise.com/v1/astro/gochar" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"}'

Python

import asterwise
from asterwise.api.astrology_api import AstrologyApi
from asterwise.models.gochar_request import GocharRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = GocharRequest(
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
)

with asterwise.ApiClient(configuration) as client:
    api = AstrologyApi(client)
    result = api.gochar(gochar_request=request)
    print(result)

TypeScript

import { createClient, createConfig, gochar } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await gochar({
  client,
  body: {
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Example response

{
  "success": true,
  "message": "success",
  "data": {
    "natal": {
      "moon_sign": "Tula",
      "moon_sign_index": 6,
      "ascendant_sign": "Tula",
      "ascendant_sign_index": 6
    },
    "target_date": "2026-05-28",
    "transits": [
      {
        "planet": "Sun",
        "transit_sign": "Vrishabha",
        "transit_sign_index": 1,
        "transit_degree": 12.7365,
        "is_retrograde": false,
        "nakshatra": "Rohini",
        "nakshatra_pada": 1,
        "house_from_moon": 8,
        "house_from_lagna": 8,
        "is_favorable_from_moon": false,
        "is_favorable_from_lagna": false,
        "bindu_override": true,
        "vedha_active": false,
        "vedha_blocking_planet": null,
        "ashtakavarga_score": 1,
        "interpretation": "Fear, diseases, quarrel, royal displeasure, suffering from excessive heat",
        "themes": [
          "fear",
          "health challenges",
          "... and 2 more items"
        ],
        "quality": "unfavorable"
      },
      {
        "planet": "Moon",
        "transit_sign": "Tula",
        "transit_sign_index": 6,
        "transit_degree": 8.6178,
        "is_retrograde": false,
        "nakshatra": "Swati",
        "nakshatra_pada": 1,
        "house_from_moon": 1,
        "house_from_lagna": 1,
        "is_favorable_from_moon": false,
        "is_favorable_from_lagna": false,
        "bindu_override": true,
        "vedha_active": false,
        "vedha_blocking_planet": null,
        "ashtakavarga_score": 0,
        "interpretation": "Dawning of fortune",
        "themes": [
          "fresh start",
          "fortunate opening",
          "... and 2 more items"
        ],
        "quality": "favorable"
      },
      "... and 7 more items"
    ],
    "summary": {
      "favorable_count": 1,
      "unfavorable_count": 8,
      "vedha_blocked_count": 0,
      "overall_score": 0,
      "sade_sati_active": false,
      "sade_sati_phase": null,
      "sade_sati_interpretation": null,
      "chandra_ashtama_active": false
    }
  }
}

Response fields

Field	Type	Description
success	boolean	True if the request succeeded
message	string	Human-readable status message
data	object
data.natal	object
data.natal.moon_sign	string
data.natal.moon_sign_index	integer
data.natal.ascendant_sign	string
data.natal.ascendant_sign_index	integer
data.target_date	string
data.transits	array[object]
data.transits[].planet	string
data.transits[].transit_sign	string
data.transits[].transit_sign_index	integer
data.transits[].transit_degree	number
data.transits[].is_retrograde	boolean
data.transits[].nakshatra	string | null
data.transits[].nakshatra_pada	integer | null
data.transits[].house_from_moon	integer
data.transits[].house_from_lagna	integer
data.transits[].is_favorable_from_moon	boolean
data.transits[].is_favorable_from_lagna	boolean
data.transits[].vedha_active	boolean
data.transits[].vedha_blocking_planet	string | null
data.transits[].ashtakavarga_score	integer | null
data.transits[].interpretation	string
data.transits[].themes	array[string]
data.transits[].quality	string
data.summary	object
data.summary.favorable_count	integer
data.summary.unfavorable_count	integer
data.summary.vedha_blocked_count	integer
data.summary.overall_score	integer
data.summary.sade_sati_active	boolean
data.summary.sade_sati_phase	string | null
data.summary.sade_sati_interpretation	object | null	Phase-specific Sade Sati interpretation when active. Contains name, duration, saturn_position, and interpretation text for the current phase (rising, peak, or setting).
data.summary.chandra_ashtama_active	boolean

Errors

Code	Description	Reference
authentication_failed	Missing or invalid API key.	authentication_failed
ephemeris_unavailable	Upstream ephemeris service error.	ephemeris_unavailable
insufficient_tier	API key tier does not include this endpoint.	insufficient_tier
internal_error	Unexpected server error.	internal_error
ip_rate_limit_exceeded	Too many requests in a short window.	ip_rate_limit_exceeded
payload_too_large	Request body exceeds the size limit.	payload_too_large
resource_not_found	Referenced resource was not found.	resource_not_found
validation_error	Request body failed schema validation.	validation_error

Related endpoints

• Muhurta — Auspicious Timing
• Personal Nakshatra Prediction (Tarabala)
• Planetary transits — Gochar
• Prashna (Horary Chart)
• Varshaphal — Solar Return Chart
• Varshaphal — Harsha Bala
• Varshaphal — Tajika Saham Points