Skip to content

Radix Charts

A radix chart (also called an event or natal chart) is the primary calculation that is used to calculate the other (auxiliary) charts.

GET /:env/radix-charts/cast

Request Parameters

Parameter Required Description
datetime Yes Gregorian calendar datetime value of the radix calculation. Format as YYYY-MM-DD HH:MM:SS. Supported year range: 1000-9999 CE. This value will be treated as local time based on the value of location.
location Yes The geographic location of the radix calculation. Any Google Maps compatible value is acceptable.
chart_points Yes An array of values from the Chart Point Index that will be calculated for the radix chart. Note that points with a corresponding opposite point will automatically include both sides of the axis in the response.
coordinates No An array of values from the Coordinate Index that will be calculated for the radix chart. Note that regardless of this value the longitude coordinate is always calculated for each selected chart point.
zodiac No A value from the list of zodiacs from the Zodiac Index. If no zodiac is provided in the request, the tropical value will be used in the calculation.
aspects No A boolean value indicating whether or not to attempt to calculate aspects for the radix chart.
house_system No A value from the list of house systems from the House System Index. If no house system is provided in the request, the koch house system will be used by default.
parallax_moon No A boolean value that, if true, will calculate the Moon's position based on the topocentric position of the observer (default false). Elevation/altitude is not taken into account. This parameter has no effect if the Moon isn't requested in the chart_points array.
planetary_nodes No A value of either heliocentric or geocentric (default). This parameter has no effect if none of the planetary nodes are included in the chart_points array. Planetary nodes are not the same as the Lunar Nodes. This parameter does not apply to the Lunar Nodes.
lot_calculation No A value of either sect (default) or fixed. This parameter has no effect if neither of the lots are included in the chart_points array.

Response Data

{
    "data": {
        "type": "radix",
        "attributes": {
            "datetime": "2021-01-26T15:34:51-08:00",
            "jdt": 2459241.482532,
            "timezone": "America/Los_Angeles",
            "dst": false,
            "location": "Portland, OR, USA",
            "latitude": {
                "decimal": 45.505,
                "degree": {
                    "degrees": 45,
                    "minutes": 30,
                    "seconds": 18,
                    "formatted": "45º 30' 18\" N"
                }
            },
            "longitude": {
                "decimal": -122.675,
                "degree": {
                    "degrees": -122,
                    "minutes": 40,
                    "seconds": 30,
                    "formatted": "-122º 40' 30\" W"
                }
            },
            "horoscope": {
                "aspects": [],
                "chart_points": [],
                "house_cusps": []
            }
        }
    }
}

{
    "errors": [
        {
            "title": "Invalid `datetime` request parameter.",
            "detail": "Date range must fall within 1000-9999 CE.",
            "source": {
                "parameter": "datetime"
            }
        },
        {
            "title": "Invalid `house_system` request parameter.",
            "detail": "No such house system \"home-sweet-home\".",
            "source": {
                "parameter": "house_system"
            }
        }
    ]
}
Name Type Value
datetime string Local datetime for the chart in ISO format.
jdt decimal Julian datetime value used in the chart calculation.
timezone string IANA timezone name.
dst boolean Whether or not Daylight Savings Time is in effect at the datetime moment.
location string Geocoded location name based on request location.
latitude Coordinate Geocoded latitude based on request location.
longitude Coordinate Geocoded longitude based on request location.
horoscope object Calculated data for: Aspects, Chart Points, House Cusps

Aspects

The aspects response object is an array of aspects. When the aspects request parameter is false or missing, this object will be an empty array: []

"aspects": [
    {
        "aspect": {
            "name": "Conjunction",
            "slug": "conjunction"
        },
        "from": {
            "name": "Sun",
            "slug": "sun"
        },
        "to": {
            "name": "Jupiter",
            "slug": "jupiter"
        },
        "type": "separating",
        "angle": {
            "decimal": 0.0,
            "degree": {
                "degrees": 0,
                "minutes": 0,
                "seconds" 0,
                "formatted": "0º 0' 0\""
            }
        },
        "arc": {
            "decimal": 5.373611,
            "degree": {
                "degrees": 5,
                "minutes": 22,
                "seconds": 25,
                "formatted": "5º 22' 25\""
            }
        },
        "orb": {
            "decimal": 5.373611,
            "degree": {
                "degrees": 5,
                "minutes": 22,
                "seconds": 25,
                "formatted": "+5º 22' 25\""
            }
        }
    }
    ...
]
Name Type Value
aspect Label Identifying information of the aspect.
from Label Chart point from which the aspect originates (see Chart Point Index).
to Label Chart point at which the aspect terminates (see Chart Point Index).
type string A value of either applying or separating.
angle Coordinate Target measurement of aspect.
arc Coordinate Actual distance between the chart points.
orb Coordinate Signed distance between angle and arc.
How Aspects Are Calculated

When the aspects request parameter is true, the list of all possible aspects returned is based on the table below. Note that not all aspects are found in every chart although it's unlikely that any chart would have zero (0) aspects. Any aspect not found will not appear in the response data.

Aspect Angle Applying Orb Separating Orb
Conjunction 0° 10° 8°
Semi-Square 45° 2° 1° 30'
Sextile 60° 4° 30' 3° 30'
Square 90° 6° 30' 5°
Trine 120° 7° 6°
Sesquiquadrate 135° 2° 1° 30'
Inconjunct 150° 3° 2° 30'
Opposition 180° 8° 6° 30'
Parallel Declination 1° 1°
Contra-Parallel Declination 1° 1°

Chart Points

The chart_points response object is an array of chart points. The chart_points request parameter is required and cannot be an empty array.

"chart_points": [
    {
        "chart_point": {
            "name": "Sun",
            "slug": "sun"
        },
        "retrograde": false,
        "coordinates": {
            "longitude": {
                "decimal": 307.243056,
                "degree": {
                    "degrees": 307,
                    "minutes": 14,
                    "seconds": 35,
                    "formatted": "307º 14' 35\""
                }
            }
            ...
        },
        "house": 7,
        "zodiac": {
            "degree": {
                "degrees": 7,
                "minutes": 14,
                "seconds": 35,
                "formatted": "7º 14' 35\""
            },
            "sign": {
                "name": "Aquarius",
                "slug": "aquarius"
            }
        }
    }
    ...
]
Name Type Value
chart_point Label Identifying information of the chart point.
retrograde boolean Whether or not the chart point is in retrograde motion.
coordinates Coordinate[] Array of Coordinate objects matching each of the requested values from coordinates. The longitude coordinate is always returned.
house integer The house in which the chart point resides (if a valid house_system is passed in the request parameters), or 0 (zero).
zodiac Zodiac A Zodiac object of the sign in which the chart point resides.

House Cusps

The house_cusps response object is an array of twelve (12) house cusps.

"house_cusps": [
    {
        "number": 1,
        "longitude": {
            "decimal": 20.068056,
            "degree": {
                "degrees": 20,
                "minutes": 4,
                "seconds": 5,
                "formatted": "20º 4' 5\""
            }
        }
        "zodiac": {
            "degree": {
                "degrees": 20,
                "minutes": 4,
                "seconds": 5,
                "formatted": "20º 4' 5\""
            },
            "sign": {
                "name": "Cancer",
                "slug": "cancer"
            }
        }
    }
    ...
]
Name Type Value
number integer The house number of 1 <= 12.
longitude Coordinate A Coordinate object of the house cusp in ecliptic longitude.
zodiac Zodiac A Zodiac object of the sign on the cusp of the house.