POST/v1/astro/ghat-chakra

Ghat Chakra

Returns the four Ghatak (inauspicious) timing parameters for a native based on their Janma Rasi (natal Moon sign). Ghat Chakra identifies the lunar month (Masa), lunar day group (Tithi), weekday (Vara), and transit nakshatra that are persistently inauspicious for that individual. When transit periods align with these Ghatak parameters, starting new ventures, surgery, travel, or auspicious ceremonies should be avoided.

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

timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as 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.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.janma_rasi

string

data.janma_rasi_index

integer

data.ghatak_parameters

object

data.ghatak_parameters.masa

object

data.ghatak_parameters.masa.name

string

data.ghatak_parameters.masa.description

string

data.ghatak_parameters.tithi

object

data.ghatak_parameters.tithi.group

string

data.ghatak_parameters.tithi.tithi_numbers

array[integer]

data.ghatak_parameters.tithi.description

string

data.ghatak_parameters.vara

object

data.ghatak_parameters.vara.day

string

data.ghatak_parameters.vara.description

string

data.ghatak_parameters.nakshatra

object

data.ghatak_parameters.nakshatra.name

string

data.ghatak_parameters.nakshatra.description

string

data.guidance

string

data.avoidance_guidance

array[string]

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Calculate dosha report
• Pitru Dosha (Pitru Shapa)
• Sade Sati periods
• Calculate yoga combinations

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/ghat-chakra" \
  -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.birth_input import BirthInput

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

request = BirthInput(
    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.ghat_chakra(birth_input=request)
    print(result)

TypeScript

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

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

const result = await ghatChakra({
  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": {
    "janma_rasi": "Tula",
    "janma_rasi_index": 6,
    "ghatak_parameters": {
      "masa": {
        "name": "Pausha",
        "description": "Pausha is the Ghatak lunar month for Tula Janma Rasi natives. Avoid major life events during this month."
      },
      "tithi": {
        "group": "Rikta",
        "tithi_numbers": [
          4,
          9,
          "... and 1 more item"
        ],
        "description": "Rikta tithis (4th, 9th, 14th) — empty/void days are Ghatak tithis for Tula Janma Rasi natives. Avoid initiating importan…"
      },
      "vara": {
        "day": "Thursday",
        "description": "Thursday is the Ghatak weekday for Tula Janma Rasi natives. Avoid major decisions, travel, or auspicious events on this…"
      },
      "nakshatra": {
        "name": "Shatabhisha",
        "description": "Shatabhisha is the Ghatak nakshatra for Tula Janma Rasi natives. When the transit Moon is in this nakshatra, the period…"
      }
    },
    "guidance": "Ghat Chakra identifies the four parameters that are consistently inauspicious for a native based on their Janma Rasi. Wh…",
    "avoidance_guidance": [
      "New business ventures or contract signings",
      "Major surgery or medical procedures",
      "... and 3 more items"
    ]
  }
}