POST/v1/astro/gochar

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.

Request parameters

locationoptional

string | null

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

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timerequired

string

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

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

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_offsetoptional

string | null

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.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

target_dateoptional

string | null

YYYY-MM-DD. Defaults to today IST.

target_timeoptional

string | null

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_timezoneoptional

string | null

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.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.birth_time_provided

boolean

True when a birth time was supplied. False when it was not: house, Ascendant and Moon-dependent results then carry the accuracy limits of an unknown birth time.

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.natal.moon_tropical_sign

string | null

Tropical sign of the natal Moon, English name (sidereal longitude plus ayanamsa). Label only; house counts stay sidereal.

data.natal.ascendant_tropical_sign

string | null

Tropical sign of the natal Ascendant, English name. Label only.

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[].transit_tropical_longitude

number | null

Same position in the tropical zodiac: sidereal longitude plus the ayanamsa at that instant. Only the label changes; houses and every rule stay sidereal.

data.transits[].transit_tropical_sign

string | null

Tropical sign of the transiting planet, English name. Label only; house_from_moon and every verdict stay sidereal.

data.transits[].transit_tropical_sign_index

integer | null

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[].bindu_override

boolean

True when the bindus in ashtakavarga_score decided is_favorable_from_moon and is_favorable_from_lagna (5 or more: favourable; 3 or fewer: unfavourable) instead of the house from the Moon or Lagna. False when the score is 4 or unavailable and the house rule stands.

data.transits[].vedha_active

boolean

data.transits[].vedha_blocking_planet

string | null

data.transits[].ashtakavarga_score

integer | null

Bindus (0-8) in this planet's own raw Bhinna Ashtakavarga for the transit sign. 5 or more makes the transit favourable and 3 or fewer unfavourable whatever the house from the Moon; 4 leaves the house rule in force (BPHS Ch.72; Phaladeepika Adhyaya 26).

data.transits[].ashtakavarga_score_reduced

integer | null

The same sign's bindus after Trikona Shodhana, for reference. Not used to grade the transit.

data.transits[].favorable_reason

string | null

Which rule decided is_favorable_from_moon, in words: the house from the Moon, or the bindu count overriding it.

data.transits[].interpretation

string

Reading that agrees with is_favorable_from_moon. Normally the classical text for this house from the Moon; when the bindus reverse the house rule it is favorable_reason, and the house text is in house_rule_interpretation.

data.transits[].themes

array[string]

Theme tags for the house from the Moon. Empty when the bindus reverse the house rule; the house tags are then only in house_rule_themes.

data.transits[].quality

string

Final verdict, 'favorable' or 'unfavorable'. Always matches is_favorable_from_moon, bindu override included.

data.transits[].house_rule_quality

string | null

Classical quality of this house from the Moon alone, before the bindu override.

data.transits[].house_rule_interpretation

string | null

Classical text for this house from the Moon alone.

data.transits[].house_rule_themes

array[string]

Theme tags for this house from the Moon alone.

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

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Muhurta — Auspicious Timing
• Personal Nakshatra Prediction (Tarabala)
• Planetary transits — Gochar
• Prashna (Horary Chart)
• Tarabala and Chandrabala
• Varshaphal — Solar Return Chart
• Varshaphal — Harsha Bala
• Varshaphal — Tajika Saham Points
• Vedic daily factors
• Vedic events over a date range

Request

POST·application/json

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);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "natal": {
      "moon_sign": "Tula",
      "moon_sign_index": 6,
      "ascendant_sign": "Tula",
      "ascendant_sign_index": 6,
      "moon_tropical_sign": "Scorpio",
      "ascendant_tropical_sign": "Scorpio"
    },
    "target_date": "2026-10-12",
    "transits": [
      {
        "planet": "Sun",
        "transit_sign": "Kanya",
        "transit_sign_index": 5,
        "transit_degree": 24.7208,
        "transit_tropical_longitude": 198.9542,
        "transit_tropical_sign": "Libra",
        "transit_tropical_sign_index": 6,
        "is_retrograde": false,
        "nakshatra": "Chitra",
        "nakshatra_pada": 1,
        "house_from_moon": 12,
        "house_from_lagna": 12,
        "is_favorable_from_moon": true,
        "is_favorable_from_lagna": true,
        "bindu_override": true,
        "favorable_reason": "6 of 8 bindus in Sun's Ashtakavarga for this sign make the transit favourable, overriding the house rule (Sun in the 12t…",
        "vedha_active": false,
        "vedha_blocking_planet": null,
        "ashtakavarga_score": 6,
        "ashtakavarga_score_reduced": 3,
        "interpretation": "6 of 8 bindus in Sun's Ashtakavarga for this sign make the transit favourable, overriding the house rule (Sun in the 12t…",
        "themes": [],
        "quality": "favorable",
        "house_rule_quality": "unfavorable",
        "house_rule_interpretation": "Sorrow, loss of wealth, quarrel with friends, fever",
        "house_rule_themes": [
          "sorrow",
          "financial loss",
          "... and 2 more items"
        ]
      },
      {
        "planet": "Moon",
        "transit_sign": "Tula",
        "transit_sign_index": 6,
        "transit_degree": 13.7832,
        "transit_tropical_longitude": 218.0166,
        "transit_tropical_sign": "Scorpio",
        "transit_tropical_sign_index": 7,
        "is_retrograde": false,
        "nakshatra": "Swati",
        "nakshatra_pada": 3,
        "house_from_moon": 1,
        "house_from_lagna": 1,
        "is_favorable_from_moon": false,
        "is_favorable_from_lagna": false,
        "bindu_override": true,
        "favorable_reason": "3 of 8 bindus in Moon's Ashtakavarga for this sign make the transit unfavourable, overriding the house rule (Moon in the…",
        "vedha_active": false,
        "vedha_blocking_planet": null,
        "ashtakavarga_score": 3,
        "ashtakavarga_score_reduced": 0,
        "interpretation": "3 of 8 bindus in Moon's Ashtakavarga for this sign make the transit unfavourable, overriding the house rule (Moon in the…",
        "themes": [],
        "quality": "unfavorable",
        "house_rule_quality": "favorable",
        "house_rule_interpretation": "Dawning of fortune",
        "house_rule_themes": [
          "fresh start",
          "fortunate opening",
          "... and 2 more items"
        ]
      },
      "... and 7 more items"
    ],
    "summary": {
      "favorable_count": 5,
      "unfavorable_count": 4,
      "vedha_blocked_count": 0,
      "overall_score": 80,
      "sade_sati_active": false,
      "sade_sati_phase": null,
      "sade_sati_interpretation": null,
      "chandra_ashtama_active": false
    },
    "birth_time_provided": true
  }
}