Ghat Chakra

Endpoint POST https://starsapi.com/api/v3/vedic/natal/ghat-chakra

Returns the Ghat Chakra — the inauspicious-period chart derived from the native’s Moon sign. Ghat Chakra identifies specific months, tithis, weekdays, nakshatras, yogas, karanas, prahars, and Moon transits that are considered unfavourable for the native. These periods should be avoided for important decisions, ceremonies, and new undertakings.

All factors are derived from the birth Moon’s sidereal rashi. For the cultural/classificatory attributes (namakshar, paya, avakhada factors), call /natal/avakhada. For the birth panchang snapshot, call /natal/natal-basics.

Authentication

Required. Three methods accepted:

Method	Example
Header (recommended)	`X-Api-Key: am_live_xxxxxxxxxxxx`
Bearer	`Authorization: Bearer am_live_xxxxxxxxxxxx`
Query	`?api_key=am_live_xxxxxxxxxxxx`

See authentication for security considerations.

Request body

Send a JSON object with Content-Type: application/json. All core fields are required — Ghat Chakra is derived from the Moon’s exact sidereal position at birth.

Field	Type	Required	Description
`year`	integer	Yes	Birth year, 4-digit (e.g. `1990`).
`month`	integer	Yes	Birth month, `1`–`12`.
`day`	integer	Yes	Day of month, `1`–`31`.
`hour`	integer	Yes	Hour in 24-hour local clock time, `0`–`23`.
`minute`	integer	Yes	Minute, `0`–`59`.
`second`	integer	No	Second, `0`–`59`. Default `0`.
`latitude`	number	Yes	Signed decimal degrees, −90…90. Positive = North (e.g. `28.6139`).
`longitude`	number	Yes	Signed decimal degrees, −180…180. Positive = East (e.g. `77.2090`).
`timezone`	string	Yes	IANA timezone identifier (e.g. `Asia/Kolkata`). DST is resolved automatically.
`name`	string	No	Native’s name. Not returned by this endpoint; use `/vedic/birth-details` to retrieve it.
`place`	string	No	Birth place label. Not returned by this endpoint; use `/vedic/birth-details` to retrieve it.
`ayanamsa`	string	No	Sidereal mode. Default `lahiri`. Full list of 45+ ayanamsas →

Use the local clock time of birth. Pass the wall-clock time as recorded on the birth certificate together with the IANA timezone of the birth place — the backend converts to UTC internally. Do not pre-convert to UTC yourself.

Response shape

All nine inauspicious factors are returned under data.ghat_chakra. Birth input is not echoed back — call /vedic/birth-details separately for that.

Field	Type	Description
ghat_chakra.moon_rashi — the source rashi for all ghat factors
`rashi`	string	Moon sign in Hindi.
`rashi_en`	string	Moon sign in English.
`rashi_number`	integer	Sign number (1–12).
ghat_chakra.ghat_maas — inauspicious month
`maas`	string	Hindu month name to avoid.
`description`	string	Advisory text.
ghat_chakra.ghat_tithi — inauspicious tithis
`tithi_numbers`	integer[]	Tithi numbers to avoid (within the paksha).
`tithi_names`	string[]	Corresponding tithi names.
`description`	string	Advisory text.
ghat_chakra.ghat_vaar — inauspicious weekday
`vaar_name`	string	Hindi weekday name.
`vaar_name_en`	string	English weekday name.
`description`	string	Advisory text.
ghat_chakra.ghat_nakshatra — inauspicious nakshatra
`nakshatra_name`	string	Nakshatra to avoid.
`description`	string	Advisory text.
ghat_chakra.ghat_yoga — inauspicious yoga
`yoga_name`	string	Yoga to avoid.
`description`	string	Advisory text.
ghat_chakra.ghat_karana — inauspicious karana
`karana_name`	string	Karana to avoid.
`description`	string	Advisory text.
ghat_chakra.ghat_prahar — inauspicious time of day
`prahar_number`	integer	Prahar number (1–4).
`prahar_name`	string	Prahar name in Sanskrit.
`time_period`	string	Approximate clock time range.
`description`	string	Advisory text.
ghat_chakra.ghat_chandra — inauspicious Moon transit sign
`rashi`	string	Sign to avoid when Moon transits it (Hindi).
`rashi_en`	string	English sign name.
`rashi_number`	integer	Sign number.
`description`	string	Advisory text.

Use cases

Muhurta selection — cross-check proposed dates against the native’s ghat factors before scheduling weddings, ceremonies, or business launches.
Kundli reports — display the ghat chakra as a dedicated section in the birth chart report alongside avakhada and panchang.
Transit alerts — combine ghat_chandra with real-time Moon transit data to warn users when the Moon enters their inauspicious sign.
Calendar integration — flag ghat tithis, vaars, and nakshatras in a personalised Hindu calendar.

Errors

HTTP	Code	Cause
400	`MISSING_FIELD`	A required birth field is absent.
400	`INVALID_DATE`	Invalid calendar date.
400	`INVALID_TIME`	Hour/minute/second out of range.
400	`INVALID_TIMEZONE`	Numeric or non-IANA timezone.
400	`INVALID_COORDINATE`	`latitude` / `longitude` out of range.
401	`AUTH_MISSING_KEY`	No API key in request.
401	`AUTH_INVALID_KEY`	Key format invalid or not found.
401	`AUTH_REVOKED_KEY`	Key has been revoked.
403	`AUTH_ORIGIN_DENIED`	Request from non-whitelisted origin.
405	`METHOD_NOT_ALLOWED`	Non-POST request.
429	`RATE_LIMIT_EXCEEDED`	Plan quota exceeded.
500	`CALCULATION_ERROR`	Ephemeris calculation failed.

Error response format

{
  "success": false,
  "error": {
    "code": "INVALID_TIMEZONE",
    "message": "Unrecognised timezone: 'Asia/Calcutta_'. Use a valid IANA identifier such as 'Asia/Kolkata'."
  }
}

# Replace YOUR_API_KEY with the key from your dashboard
curl -X POST "https://starsapi.com/api/v3/vedic/natal/ghat-chakra" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }'

const response = await fetch(
  'https://starsapi.com/api/v3/vedic/natal/ghat-chakra',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      year: 1990,
      month: 5,
      day: 20,
      hour: 14,
      minute: 30,
      second: 0,
      latitude: 28.6139,
      longitude: 77.209,
      timezone: 'Asia/Kolkata'
    })
  }
);
const result = await response.json();

if (result.success) {
  console.log(result.data);
}

import requests
import os

response = requests.post(
    'https://starsapi.com/api/v3/vedic/natal/ghat-chakra',
    headers={'X-Api-Key': os.environ['STARSAPI_KEY']},
    json={
        'year': 1990,
        'month': 5,
        'day': 20,
        'hour': 14,
        'minute': 30,
        'second': 0,
        'latitude': 28.6139,
        'longitude': 77.209,
        'timezone': 'Asia/Kolkata'
    }
)
result = response.json()

if result['success']:
    print(result['data'])

<?php
$payload = [
    'year' => 1990,
    'month' => 5,
    'day' => 20,
    'hour' => 14,
    'minute' => 30,
    'second' => 0,
    'latitude' => 28.6139,
    'longitude' => 77.209,
    'timezone' => 'Asia/Kolkata',
];

$ch = curl_init('https://starsapi.com/api/v3/vedic/natal/ghat-chakra');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-Api-Key: ' . getenv('STARSAPI_KEY'),
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

if ($data['success']) {
    print_r($data['data']);
}

import 'package:http/http.dart' as http;
import 'dart:convert';

Future<Map<String, dynamic>> getAscendant() async {
  final response = await http.post(
    Uri.parse('https://starsapi.com/api/v3/vedic/natal/ghat-chakra'),
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: jsonEncode({
      'year': 1990,
      'month': 5,
      'day': 20,
      'hour': 14,
      'minute': 30,
      'second': 0,
      'latitude': 28.6139,
      'longitude': 77.209,
      'timezone': 'Asia/Kolkata',
    }),
  );
  return jsonDecode(response.body);
}

import Foundation

func getAscendant() async throws -> [String: Any] {
    var request = URLRequest(url: URL(string:
        "https://starsapi.com/api/v3/vedic/natal/ghat-chakra"
    )!)
    request.httpMethod = "POST"
    request.setValue("YOUR_API_KEY", forHTTPHeaderField: "X-Api-Key")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = """
        {
            "year": 1990,
            "month": 5,
            "day": 20,
            "hour": 14,
            "minute": 30,
            "second": 0,
            "latitude": 28.6139,
            "longitude": 77.209,
            "timezone": "Asia/Kolkata"
        }
        """.data(using: .utf8)

    let (data, _) = try await URLSession.shared.data(for: request)
    return try JSONSerialization.jsonObject(with: data) as! [String: Any]
}

import okhttp3.*
import org.json.JSONObject

val client = OkHttpClient()
val JSON = "application/json; charset=utf-8".toMediaType()

fun getAscendant(callback: (JSONObject) -> Unit) {
    val payload = """
    {
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }
    """.trimIndent()

    val request = Request.Builder()
        .url("https://starsapi.com/api/v3/vedic/natal/ghat-chakra")
        .addHeader("X-Api-Key", "YOUR_API_KEY")
        .post(payload.toRequestBody(JSON))
        .build()

    client.newCall(request).enqueue(object : Callback {
        override fun onResponse(call: Call, response: Response) {
            callback(JSONObject(response.body!!.string()))
        }
        override fun onFailure(call: Call, e: java.io.IOException) {
            e.printStackTrace()
        }
    })
}

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    payload, _ := json.Marshal(map[string]interface{}{
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata",
    })

    req, _ := http.NewRequest("POST",
        "https://starsapi.com/api/v3/vedic/natal/ghat-chakra",
        bytes.NewBuffer(payload))
    req.Header.Set("X-Api-Key", os.Getenv("STARSAPI_KEY"))
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result["data"])
}

require 'net/http'
require 'json'

uri = URI('https://starsapi.com/api/v3/vedic/natal/ghat-chakra')
payload = {
  'year' => 1990,
  'month' => 5,
  'day' => 20,
  'hour' => 14,
  'minute' => 30,
  'second' => 0,
  'latitude' => 28.6139,
  'longitude' => 77.209,
  'timezone' => 'Asia/Kolkata'
}

req = Net::HTTP::Post.new(uri)
req['X-Api-Key'] = ENV['STARSAPI_KEY']
req['Content-Type'] = 'application/json'
req.body = payload.to_json

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
res = http.request(req)

data = JSON.parse(res.body)
puts data['data'] if data['success']

200 RESPONSE

{
  "status": 200,
  "success": true,
  "data": {
    "ghat_chakra": {
      "moon_rashi": {
        "rashi": "Meena",
        "rashi_en": "Pisces",
        "rashi_number": 12
      },
      "ghat_maas": {
        "maas": "Phalguna",
        "description": "Avoid important activities in Phalguna month"
      },
      "ghat_tithi": {
        "tithi_numbers": [5, 10, 15],
        "tithi_names": ["Panchami", "Dashami", "Purnima"],
        "description": "Avoid important activities on Panchami, Dashami, Purnima tithi"
      },
      "ghat_vaar": {
        "vaar_name": "Shukravaar",
        "vaar_name_en": "Friday",
        "description": "Avoid important activities on Friday"
      },
      "ghat_nakshatra": {
        "nakshatra_name": "Ashlesha",
        "description": "Avoid important activities when Moon is in Ashlesha"
      },
      "ghat_yoga": {
        "yoga_name": "Vajra",
        "description": "Avoid important activities during Vajra yoga"
      },
      "ghat_karana": {
        "karana_name": "Chatushpada",
        "description": "Avoid important activities during Chatushpada karana"
      },
      "ghat_prahar": {
        "prahar_number": 4,
        "prahar_name": "Chaturtha Prahar",
        "time_period": "~3 PM to Sunset",
        "description": "Avoid important activities during Evening"
      },
      "ghat_chandra": {
        "rashi": "Kumbha",
        "rashi_en": "Aquarius",
        "rashi_number": 11,
        "description": "Avoid important activities when Moon transits Kumbha (Aquarius)"
      }
    }
  },
  "meta": {
    "endpoint": "/api/v3/vedic/natal/ghat-chakra",
    "version": "3.0",
    "response_time_ms": 49,
    "timestamp": "2026-06-09T06:08:12+05:30",
    "credits_remaining": 198603,
    "request_id": "47aa526df64b5d62",
    "ayanamsa": {
      "name": "Lahiri",
      "value": 23.725957,
      "value_dms": "23°43'33\""
    }
  }
}