Sidereal Birth Chart API

Two date modes: standard civil inputs cover 1800–2200. All 77 date-bearing operations also accept explicit historical inputs from 1000 BCE (BC) to 2500 CE (AD), with a chosen calendar and, for timed calculations, UT1 or a fixed UT1 offset. Date-only numerology requires an explicit year-digit convention. Place search is date-independent. Each tool retains its search, geometry, derived-date and export limits; historical iCalendar is not supported. The ordinary date-string examples below describe standard mode. Historical input guide and current schemas.

Cosmic Ephemeris uses Western (tropical), geocentric astrology by default. Sidereal calculations are applied only when explicitly enabled using "zodiac": "sidereal" and an ayanamsa selection. This endpoint provides sidereal coordinate transforms only and does not implement full Vedic astrology systems.

Generate sidereal natal astrology charts using API key authentication. Designed for passive, server-to-server usage.

Endpoint

POST https://api.cosmicephemeris.com/api/astro/birth-chart

Include Authorization: Bearer <API_KEY>.

Required Request Fields

  • date — ISO date (YYYY-MM-DD)
  • time — 24-hour time (HH:MM)
  • lat — latitude (decimal)
  • lon — longitude (decimal)
  • zodiac — must be "sidereal"
  • ayanamsa — optional; accepts the eleven documented choices and defaults to lahiri

Add an IANA timezone for local birth time; omission means UTC. Standard chart dates are limited to 1800-01-01 through 2200-12-31.

Returns

  • Planetary positions (Sun through Pluto) in sidereal zodiac
  • Ascendant and Midheaven (mc)
  • Whole Sign (whole_sign) and Equal (equal) house systems
  • Aspects, lunar nodes, and metadata

All calculation results are returned inside the chart object.

Example Response

This verified Lahiri response is abbreviated and numerically rounded.

{
  "type": "birth-chart",
  "input": {
    "date": "1995-11-08",
    "time": "14:22",
    "timezone": "UTC",
    "lat": 34.05,
    "lon": -118.24,
    "zodiac": "sidereal",
    "ayanamsa": "lahiri"
  },
  "chart": {
    "status": "ok",
    "planets": {
      "Sun": { "lon": 201.9022, "tropical_lon": 225.7013, "sign": "Libra" },
      "Moon": { "lon": 36.4327, "tropical_lon": 60.2319, "sign": "Taurus" }
    },
    "houses": {
      "ascendant": 201.6965,
      "mc": 118.4019,
      "systems": {
        "whole_sign": {
          "houses": {
            "1": 180.0,
            "2": 210.0,
            "3": 240.0,
            "4": 270.0,
            "5": 300.0,
            "6": 330.0,
            "7": 0.0,
            "8": 30.0,
            "9": 60.0,
            "10": 90.0,
            "11": 120.0,
            "12": 150.0
          }
        },
        "equal": {
          "houses": {
            "1": 201.6965,
            "2": 231.6965,
            "3": 261.6965,
            "4": 291.6965,
            "5": 321.6965,
            "6": 351.6965,
            "7": 21.6965,
            "8": 51.6965,
            "9": 81.6965,
            "10": 111.6965,
            "11": 141.6965,
            "12": 171.6965
          }
        }
      }
    }
  }
}

Quick Test / curl

Use this curl command to quickly test the Sidereal Birth Chart API endpoint with your API key:

curl -i https://api.cosmicephemeris.com/api/astro/birth-chart \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${COSMICEPHEMERIS_KEY}" \
  -d '{
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "America/New_York",
    "lat": 33.7488,
    "lon": -84.3877,
    "zodiac": "sidereal",
    "ayanamsa": "lahiri"
  }'

Common Uses

  • Sidereal chart visualization
  • Coordinate-system comparison tools
  • Research and analytics pipelines
  • Advanced astrology dashboards

All calculation results are returned as raw data. Interpretation, weighting, and scoring are the responsibility of the client application or downstream services.

// Node.js 22+ — server-side only
fetch("https://api.cosmicephemeris.com/api/astro/birth-chart", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${process.env.COSMICEPHEMERIS_KEY}`
  },
  body: JSON.stringify({
    date: "1995-11-08",
    time: "14:22",
    timezone: "UTC",
    lat: 34.05,
    lon: -118.24,
    zodiac: "sidereal",
    ayanamsa: "lahiri"
  })
})
  .then(res => res.json())
  .then(data => console.log(data));
# Python — Sidereal Birth Chart API
import os
import requests

url = "https://api.cosmicephemeris.com/api/astro/birth-chart"

payload = {
  "date": "1995-11-08",
  "time": "14:22",
  "timezone": "UTC",
  "lat": 34.05,
  "lon": -118.24,
  "zodiac": "sidereal",
  "ayanamsa": "lahiri"
}

headers = {
  "Content-Type": "application/json",
  "Authorization": f"Bearer {os.environ['COSMICEPHEMERIS_KEY']}"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())