House Cusps

Endpoint POST https://starsapi.com/api/v3/transit/western/cusps

Returns 12 house cusps and the 4 chart angles (Ascendant, Midheaven, Descendant, Imum Coeli) for the transit moment. Supports 25 house systems including Placidus, Koch, Equal, Whole Sign, Campanus, Regiomontanus, and more.

Authentication

Required.

Request body

Field	Type	Required	Description
`latitude`	number	Yes	Observer latitude.
`longitude`	number	Yes	Observer longitude.
`timezone`	string	Yes	IANA timezone.
`year`…`second`	integer	No	Defaults to now.
`house_system`	string	No	Default `placidus`. Options: `placidus`, `koch`, `porphyry`, `regiomontanus`, `campanus`, `equal`, `whole_sign`, `meridian`, `morinus`, `alcabitius`, `topocentric`, `vehlow_equal`, `krusinski`, `equal_mc`, `equal_aries`, `sripati`, `horizontal`, `gauquelin`, `apc`, `pullen_sd`, `pullen_sr`, `sunshine`, `carter`, and more.

Response shape

angles

Each angle has longitude, longitude_dms, sign, degree_in_sign.

houses

Keyed 1–12. Each cusp has the same fields as angles.

# Replace YOUR_API_KEY with the key from your dashboard
curl -X POST "https://starsapi.com/api/v3/transit/western/cusps" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }'

const response = await fetch(
  'https://starsapi.com/api/v3/transit/western/cusps',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      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/transit/western/cusps',
    headers={'X-Api-Key': os.environ['STARSAPI_KEY']},
    json={
        'latitude': 28.6139,
        'longitude': 77.209,
        'timezone': 'Asia/Kolkata'
    }
)
result = response.json()

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

<?php
$payload = [
    'latitude' => 28.6139,
    'longitude' => 77.209,
    'timezone' => 'Asia/Kolkata',
];

$ch = curl_init('https://starsapi.com/api/v3/transit/western/cusps');
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/transit/western/cusps'),
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: jsonEncode({
      '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/transit/western/cusps"
    )!)
    request.httpMethod = "POST"
    request.setValue("YOUR_API_KEY", forHTTPHeaderField: "X-Api-Key")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = """
        {
            "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 = """
    {
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }
    """.trimIndent()

    val request = Request.Builder()
        .url("https://starsapi.com/api/v3/transit/western/cusps")
        .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{}{
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata",
    })

    req, _ := http.NewRequest("POST",
        "https://starsapi.com/api/v3/transit/western/cusps",
        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/transit/western/cusps')
payload = {
  '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": {
    "moment": { "date": "2026-06-20", "time": "14:30:00", "timezone": "Asia/Kolkata" },
    "zodiac": "tropical", "house_system": "placidus",
    "angles": {
      "ascendant":  { "longitude": 222.45, "longitude_dms": "222°27'0\"", "sign": "Scorpio", "degree_in_sign": 12.45 },
      "midheaven":  { "longitude": 145.21, "longitude_dms": "145°12'36\"", "sign": "Leo", "degree_in_sign": 25.21 },
      "descendant": { "longitude": 42.45, "sign": "Taurus", "degree_in_sign": 12.45 },
      "imum_coeli": { "longitude": 325.21, "sign": "Aquarius", "degree_in_sign": 25.21 }
    },
    "houses": {
      "1":  { "longitude": 222.45, "longitude_dms": "222°27'0\"", "sign": "Scorpio", "degree_in_sign": 12.45 },
      "2":  { "longitude": 252.31, "longitude_dms": "252°18'36\"", "sign": "Sagittarius", "degree_in_sign": 12.31 }
    }
  },
  "meta": { "endpoint": "/api/v3/transit/western/cusps", "version": "3.0" }
}