Astrological Calculations API

POST /planetary-positions

Calculate planetary positions for a given date, time, and location.

{
    "date": "2025-05-20",
    "time": "12:00:00",
    "latitude": 40.7128,
    "longitude": -74.0060,
    "planets": ["Sun", "Moon", "Mercury", "Venus", "Mars"],
    "include_extended": false
}
                                

POST /astrological-houses

Calculate astrological houses for a given date, time, and location.

{
    "date": "2025-05-20",
    "time": "12:00:00",
    "latitude": 40.7128,
    "longitude": -74.0060,
    "house_system": "P"
}
                                

POST /aspects

Calculate aspects between planets for a given date, time, and location.

{
    "date": "2025-05-20",
    "time": "12:00:00",
    "latitude": 40.7128,
    "longitude": -74.0060,
    "include_minor_aspects": false,
    "planets": ["Sun", "Moon", "Venus", "Mars"],
    "custom_orbs": {
        "conjunction": 8,
        "opposition": 8,
        "trine": 7
    }
}
                                

POST /natal-chart

Calculate a complete natal chart with planetary positions, houses, and aspects.

{
    "date": "1990-06-15",
    "time": "14:30:00",
    "latitude": 40.7128,
    "longitude": -74.0060,
    "house_system": "P",
    "include_minor_aspects": false,
    "planets": ["Sun", "Moon", "Mercury", "Venus", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune", "Pluto", "Chiron", "North Node", "Ascendant", "Midheaven"]
}
                                

POST /transits

Calculate transit aspects between natal and transit charts.

{
    "natal_date": "1990-06-15",
    "natal_time": "14:30:00",
    "natal_latitude": 40.7128,
    "natal_longitude": -74.0060,
    "transit_date": "2025-05-20",
    "transit_time": "12:00:00",
    "include_minor_aspects": false,
    "natal_planets": ["Sun", "Moon", "Mercury"],
    "transit_planets": ["Jupiter", "Saturn", "Uranus"]
}
                                

GET /lunar-movements

Get the moon's sign, entry/exit times, and void of course information.

Optional query parameters: date, time

GET /lunar-phase

Get lunar phase information including new/full moon dates.

Optional query parameters: date, time

GET or POST /mansion-of-the-moon

Get lunar mansion information including descriptions.

Optional query parameters: date, time

GET /today

Get today's astrological highlights including current moon sign, moon phase (if Full or New), and sun sign changes.

No parameters required - returns live cosmic data for today

// Example response:
{
    "moonSign": "Cancer",
    "moonPhase": "New Moon",  // Only if Full or New Moon
    "sunSignChange": {        // Only if Sun changed signs today
        "from": "Gemini",
        "to": "Cancer"
    }
}