Sidereal Birth Chart API

AstroAPI 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.astroapi.io/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 — e.g. "lahiri"

Returns

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

All calculation results are returned inside the chart object.

Example Response

{
  "type": "birth-chart",
  "input": {
    "date": "1995-11-08",
    "time": "14:22",
    "lat": 34.05,
    "lon": -118.24,
    "zodiac": "sidereal",
    "ayanamsa": "lahiri"
  },
  "chart": {
    "status": "ok",
    "planets": {
      "Sun": { "lon": 201.3, "sign": "Libra" },
      "Moon": { "lon": 348.1, "sign": "Pisces" }
    },
    "houses": {
      "ascendant": 188.4,
      "mc": 82.1,
      "systems": {
        "placidus": {
          "houses": {
            "1": 188.4,
            "2": 216.0,
            "3": 242.7,
            "4": 271.4,
            "5": 299.2,
            "6": 327.5,
            "7": 8.4,
            "8": 36.0,
            "9": 62.7,
            "10": 82.1,
            "11": 109.8,
            "12": 137.6
          }
        }
      }
    }
  }
}

Quick Test / curl

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

curl -i https://api.astroapi.io/api/astro/birth-chart \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -d '{
    "date": "2000-01-01",
    "time": "12:00",
    "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.

// JavaScript — Sidereal Birth Chart API
fetch("https://api.astroapi.io/api/astro/birth-chart", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    date: "1995-11-08",
    time: "14:22",
    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 requests

url = "https://api.astroapi.io/api/astro/birth-chart"

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

headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_KEY"
}

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