Natal Charts

Calculate complete natal charts with planetary positions, house cusps, and aspects.

Basic Calculation

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  }'

Parameters

Parameter	Type	Required	Description
datetime	string	Yes	ISO 8601 datetime
latitude	number	Yes	Latitude (-90 to 90)
longitude	number	Yes	Longitude (-180 to 180)
timezone	string	Yes	IANA timezone identifier
houseSystem	string	No	House system (default: "placidus")

House Systems

• placidus - Placidus (default)
• koch - Koch
• equal - Equal House
• whole - Whole Sign
• campanus - Campanus
• regiomontanus - Regiomontanus
• porphyry - Porphyry

Response

{
  "data": {
    "type": "natal-chart",
    "attributes": {
      "planets": {
        "sun": { "longitude": 84.5, "latitude": 0, "sign": "gemini", "house": 10 },
        "moon": { "longitude": 245.2, "latitude": -3.1, "sign": "sagittarius", "house": 4 }
      },
      "houses": {
        "1": { "cusp": 180.5, "sign": "libra" },
        "2": { "cusp": 210.3, "sign": "scorpio" }
      },
      "aspects": [
        { "planet1": "sun", "planet2": "moon", "aspect": "opposition", "orb": 0.7 }
      ]
    }
  }
}

Included Bodies

By default, the following celestial bodies are included:

• Sun, Moon
• Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto
• North Node, South Node
• Chiron, Lilith (Black Moon)
• Part of Fortune

Calculation Precision

AstroAPI uses the Swiss Ephemeris for high-precision calculations. All positions are calculated to arcsecond accuracy.