Chalit Houses

Endpoint POST https://starsapi.com/api/v3/vedic/houses/chalit

Returns house boundary data for the Bhava Chalit (Placidus) system — sign, lord, begin/madhya/end cusps, planet occupants for each of the 12 houses, plus the four chart angles (ASC, MC, DSC, IC). In the Placidus system, houses are unequal — planets can shift houses compared to the Rashi chart, making this essential for prediction work in KP and modern Parashari.

For chart images, use /charts/chalit. For other house systems, see /houses/bhava (Equal House) and /houses/sripati (Sripati).

Authentication

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

Request body

Field	Type	Required	Description
`year`	integer	Yes	Birth year, 4-digit.
`month`	integer	Yes	Birth month, `1`–`12`.
`day`	integer	Yes	Day of month.
`hour`	integer	Yes	Hour, 24-hour format.
`minute`	integer	Yes	Minute.
`second`	integer	No	Default `0`.
`latitude`	number	Yes	Decimal degrees, −90…90.
`longitude`	number	Yes	Decimal degrees, −180…180.
`timezone`	string	Yes	IANA timezone identifier.
`ayanamsa`	string	No	Default `lahiri`. Full list →
`node_type`	string	No	`mean` (default) or `true`.

Response shape

houses.{1–12}

Field	Type	Description
`sign`	string	Sign on the house cusp.
`sign_lord`	string	Ruling planet.
`begin`	string	House start boundary.
`madhya`	string	House mid-point.
`end`	string	House end boundary.
`planets`	array	2-letter planet codes in this house.

angles

Key	Full name	Description
`asc`	Ascendant	Rising degree — cusp of 1st house.
`mc`	Midheaven (MC)	Medium Coeli — cusp of 10th house.
`dsc`	Descendant	Setting degree — cusp of 7th house.
`ic`	Imum Coeli (IC)	Nadir — cusp of 4th house.

Each angle contains longitude (absolute 0–360), sign, and degree_dms (degree within sign).

Unequal houses. Unlike Equal House, Placidus cusps vary based on latitude and birth time. Houses near the poles can be very large or very small. MC and IC may differ significantly from the Equal House equivalents.

Use cases

KP astrology — Placidus cusps are the foundation of KP sub-lord calculations.
Bhava shift detection — compare planet houses here vs Rashi chart to find shifted planets.
Custom chart rendering — use unequal cusp boundaries for accurate Chalit chart drawing.
MC/IC analysis — career (MC) and home (IC) indicators with precise degrees.

Errors

HTTP	Code	Cause
400	`MISSING_FIELD`	Required field absent.
400	`INVALID_DATE`	Bad calendar date.
400	`INVALID_TIME`	Hour/minute/second out of range.
400	`INVALID_TIMEZONE`	Non-IANA timezone.
400	`INVALID_COORDINATE`	Lat/lon out of range.
405	`METHOD_NOT_ALLOWED`	Non-POST request.

# Replace YOUR_API_KEY with the key from your dashboard
curl -X POST "https://starsapi.com/api/v3/vedic/houses/chalit" \
  -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/houses/chalit',
  {
    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/houses/chalit',
    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/houses/chalit');
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/houses/chalit'),
    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/houses/chalit"
    )!)
    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/houses/chalit")
        .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/houses/chalit",
        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/houses/chalit')
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": {
    "house_system": "Placidus",
    "ascendant": {
      "sign": "Virgo",
      "sign_lord": "Mercury",
      "degree_dms": "6°14'52\""
    },
    "houses": {
      "1": { "sign": "Virgo", "sign_lord": "Mercury", "begin": "Vir 6°14'52\"", "madhya": "Vir 20°15'35\"", "end": "Lib 4°16'18\"", "planets": [] },
      "2": { "sign": "Libra", "sign_lord": "Venus", "begin": "Lib 4°16'18\"", "madhya": "Lib 19°29'24\"", "end": "Sco 4°42'30\"", "planets": ["Pl"] },
      "3": { "sign": "Scorpio", "sign_lord": "Mars", "begin": "Sco 4°42'30\"", "madhya": "Sco 20°28'39\"", "end": "Sag 6°14'48\"", "planets": [] },
      "4": { "sign": "Sagittarius", "sign_lord": "Jupiter", "begin": "Sag 6°14'48\"", "madhya": "Sag 22°0'57\"", "end": "Cap 7°47'5\"", "planets": ["Sa", "Ur", "Ne"] },
      "5": { "sign": "Capricorn", "sign_lord": "Saturn", "begin": "Cap 7°47'5\"", "madhya": "Cap 23°0'11\"", "end": "Aqu 8°13'18\"", "planets": ["Ra"] },
      "6": { "sign": "Aquarius", "sign_lord": "Saturn", "begin": "Aqu 8°13'18\"", "madhya": "Aqu 22°14'5\"", "end": "Pis 6°14'52\"", "planets": ["Ma"] },
      "7": { "sign": "Pisces", "sign_lord": "Jupiter", "begin": "Pis 6°14'52\"", "madhya": "Pis 20°15'35\"", "end": "Ari 4°16'18\"", "planets": ["Mo", "Ve"] },
      "8": { "sign": "Aries", "sign_lord": "Mars", "begin": "Ari 4°16'18\"", "madhya": "Ari 19°29'24\"", "end": "Tau 4°42'30\"", "planets": ["Me"] },
      "9": { "sign": "Taurus", "sign_lord": "Venus", "begin": "Tau 4°42'30\"", "madhya": "Tau 20°28'39\"", "end": "Gem 6°14'48\"", "planets": ["Su"] },
      "10": { "sign": "Gemini", "sign_lord": "Mercury", "begin": "Gem 6°14'48\"", "madhya": "Gem 22°0'57\"", "end": "Can 7°47'5\"", "planets": ["Ju", "Ch"] },
      "11": { "sign": "Cancer", "sign_lord": "Moon", "begin": "Can 7°47'5\"", "madhya": "Can 23°0'11\"", "end": "Leo 8°13'18\"", "planets": ["Ke"] },
      "12": { "sign": "Leo", "sign_lord": "Sun", "begin": "Leo 8°13'18\"", "madhya": "Leo 22°14'5\"", "end": "Vir 6°14'52\"", "planets": [] }
    },
    "angles": {
      "asc": { "longitude": 156.2478, "sign": "Virgo", "degree_dms": "6°14'52\"" },
      "mc":  { "longitude": 82.0157, "sign": "Gemini", "degree_dms": "22°0'57\"" },
      "dsc": { "longitude": 336.2478, "sign": "Pisces", "degree_dms": "6°14'52\"" },
      "ic":  { "longitude": 262.0157, "sign": "Sagittarius", "degree_dms": "22°0'57\"" }
    }
  },
  "meta": {
    "endpoint": "/api/v3/vedic/houses/chalit",
    "version": "3.0",
    "response_time_ms": 7,
    "timestamp": "2026-06-09T06:57:05+05:30",
    "credits_remaining": 198588,
    "request_id": "5feb5d3c2af13edd",
    "ayanamsa": {
      "name": "Lahiri",
      "value": 23.725957,
      "value_dms": "23°43'33\""
    },
    "node_type": "mean"
  }
}