Natal Chart API
Birth chart calculator API with houses and aspects
POST/astrology/natal-chart
Included with every plan (at no extra cost)
Calculate complete Western astrology natal chart (birth chart) with tropical zodiac. Returns all 14 celestial bodies (the 10 classical planets Sun through Pluto, the lunar nodes, Chiron, and Black Moon Lilith), 12 house cusps with customizable house systems (Placidus, Whole Sign, Equal, Koch), major and minor aspects, Ascendant, Midheaven, dominant elements and modalities. Perfect for astrology apps, birth chart generators, horoscope websites, and astrological consultation tools. Verified against NASA JPL Horizons.
Location first, chart second
The Natal Chart API needs latitude, longitude, and timezone. Never ask users to type coordinates. Resolve a city with the Location endpoint first, then feed the result into the request. Timezone accepts a decimal offset or an IANA name.
1 Resolve the location
GET
curl "https://roxyapi.com/api/v2/location/search?q=New York" \
-H "X-API-Key: YOUR_KEY"
# -> cities[0]: { latitude, longitude, timezone: "America/New_York" }2 Call the Natal Chart endpoint
POST /astrology/natal-chart
# feed latitude, longitude and timezone from step 1
POST https://roxyapi.com/api/v2/astrology/natal-chartRequest
POST /api/v2/astrology/natal-chart
Parameters
| Parameter | Type | Description |
|---|---|---|
| langquery | string enum | Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default en. |
Request body
| Field | Type | Description |
|---|---|---|
| date* | string (date) | Birth date in YYYY-MM-DD format. Determines planetary positions for the specific calendar day. |
| time* | string (time) | Birth time in 24-hour HH:MM:SS format. Determines the Ascendant (rising sign) and house cusps. Use 12:00:00 if unknown. |
| latitude* | number | Birth location latitude in decimal degrees (-90 to 90). Positive = North, negative = South. |
| longitude* | number | Birth location longitude in decimal degrees (-180 to 180). Positive = East, negative = West. |
| timezone* | number or string | Timezone: an IANA name (e.g. "America/New_York", "Europe/London", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. |
| nodeType | string enum | Lunar node convention. "mean" is the smoothed average node, which always moves retrograde; "true" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the North and South Node. True is the osculating node and the default, because it is what most Western chart software reports; mean is the smoothed node preferred by several evolutionary schools, so pass "mean" to match one. Nothing else in the chart changes, and the two agree on the sign except when the node sits within about 1.8 degrees of a cusp. Defaults to "true". |
| houseSystem | string enum | House system for dividing the chart into 12 houses. Placidus (default) is most popular in Western astrology and time-sensitive. Whole Sign assigns one sign per house (simpler, ancient). Equal houses divide chart into 30° segments from Ascendant. Koch emphasizes houses in high latitudes. |
Example request
POST /api/v2/astrology/natal-chart
{
"date": "1990-07-15",
"time": "14:30:00",
"latitude": 40.7128,
"longitude": -74.006,
"timezone": "America/New_York",
"nodeType": "true",
"houseSystem": "placidus"
}Response
Structured JSON with documented fields, covered by 13,405 automated tests per deploy, 3,620 of them gold-standard tests verified against NASA JPL Horizons. Not hallucinated text.
200 OK
{
"birthDetails": {
"date": "1990-07-15",
"time": "14:30:00",
"latitude": 40.7128,
"longitude": -74.006,
"timezone": -4,
"nodeType": "true"
},
"planets": [
{
"name": "Sun",
"longitude": 113.00452053215861,
"latitude": 0.0001759667946626438,
"sign": "Cancer",
"degree": 23.004520532158608,
"speed": 0.9539943976308223,
"isRetrograde": false,
"house": 9,
"dignity": "peregrine",
"interpretation": {
"summary": "Your Sun in Cancer in The Ninth House reveals how you express self-awareness and ego with intuitive and nurturing energy in the realm of exploration.",
"detailed": "Sun represents self-awareness and ego. In Cancer (Crab), this energy becomes intuitive, nurturing, protective. Located in The Ninth House, you direct this Cancer Sun energy toward exploration and religious beliefs and personal philosophy. This creates a unique expression where your self-awareness and ego naturally manifests through intuitive, nurturing, protective approaches in matters related to the ninth house.",
"keywords": [
"active",
"awareness",
"bright",
"confidence",
"consciousness",
"intuitive",
"nurturing",
"protective"
]
}
},
{
"name": "Moon",
"longitude": 27.068938674158613,
"latitude": 5.181805332627993,
"sign": "Aries",
"degree": 27.068938674158613,
"speed": 14.10478254438371,
"isRetrograde": false,
"house": 6,
"dignity": "peregrine",
"interpretation": {
"summary": "Your Moon in Aries in The Sixth House reveals how you express inner emotional life with ambitious and independent energy in the realm of work and job.",
"detailed": "Moon represents inner emotional life. In Aries (Ram), this energy becomes ambitious, independent, impatient. Located in The Sixth House, you direct this Aries Moon energy toward work and job and techniques and methods. This creates a unique expression where your inner emotional life naturally manifests through ambitious, independent, impatient approaches in matters related to the sixth house.",
"keywords": [
"caretaker",
"comfort",
"emotion",
"feeling",
"femininity",
"ambitious",
"independent",
"impatient"
]
}
},
{
"name": "Mercury",
"longitude": 127.2804483512056,
"latitude": 1.771366339138991,
"sign": "Leo",
"degree": 7.280448351205607,
"speed": 1.8691982629179336,
"isRetrograde": false,
"house": 9,
"dignity": "peregrine",
"interpretation": {
"summary": "Your Mercury in Leo in The Ninth House reveals how you express communication with proud and bold energy in the realm of exploration.",
"detailed": "Mercury represents communication. In Leo (Lion), this energy becomes proud, bold, ambitious. Located in The Ninth House, you direct this Leo Mercury energy toward exploration and religious beliefs and personal philosophy. This creates a unique expression where your communication naturally manifests through proud, bold, ambitious approaches in matters related to the ninth house.",
"keywords": [
"analysis",
"childhood",
"communication",
"curiosity",
"education",
"proud",
"bold",
"ambitious"
]
}
},
{
"name": "Venus",
"longitude": 84.73608276357183,
"latitude": -0.9479624880105159,
"sign": "Gemini",
"degree": 24.73608276357183,
"speed": 1.1994159048476547,
"isRetrograde": false,
"house": 8,
"dignity": "peregrine",
"interpretation": {
"summary": "Your Venus in Gemini in The Eighth House reveals how you express love, beauty, and money with curious and affectionate energy in the realm of transformation and crisis.",
"detailed": "Venus represents love, beauty, and money. In Gemini (Twins), this energy becomes curious, affectionate, kind. Located in The Eighth House, you direct this Gemini Venus energy toward transformation and crisis and sexuality. This creates a unique expression where your love, beauty, and money naturally manifests through curious, affectionate, kind approaches in matters related to the eighth house.",
"keywords": [
"attractiveness",
"beauty",
"culture",
"eros",
"fantasy",
"curious",
"affectionate",
"kind"
]
}
},
{
"name": "Mars",
"longitude": 32.12342925796031,
"latitude": -2.0650864909835867,
"sign": "Taurus",
"degree": 2.1234292579603107,
"speed": 0.6691958830514579,
"isRetrograde": false,
"house": 6,
"dignity": "detriment",
"interpretation": {
"summary": "Your Mars in Taurus in The Sixth House reveals how you express assertiveness and aggression with dependable and musical energy in the realm of work and job.",
"detailed": "Mars represents assertiveness and aggression. In Taurus (Bull), this energy becomes dependable, musical, practical. Located in The Sixth House, you direct this Taurus Mars energy toward work and job and techniques and methods. This creates a unique expression where your assertiveness and aggression naturally manifests through dependable, musical, practical approaches in matters related to the sixth house.",
"keywords": [
"action",
"adventurous",
"athletic",
"brave",
"courage",
"dependable",
"musical",
"practical"
]
}
},
{
"name": "Jupiter",
"longitude": 112.60994571682349,
"latitude": 0.23002826787756697,
"sign": "Cancer",
"degree": 22.60994571682349,
"speed": 0.22425373323959263,
"isRetrograde": false,
"house": 9,
"dignity": "exaltation",
"interpretation": {
"summary": "Your Jupiter in Cancer in The Ninth House reveals how you express luck and opportunity with intuitive and nurturing energy in the realm of exploration.",
"detailed": "Jupiter represents luck and opportunity. In Cancer (Crab), this energy becomes intuitive, nurturing, protective. Located in The Ninth House, you direct this Cancer Jupiter energy toward exploration and religious beliefs and personal philosophy. This creates a unique expression where your luck and opportunity naturally manifests through intuitive, nurturing, protective approaches in matters related to the ninth house.",
"keywords": [
"abundance",
"college",
"culture",
"curiosity",
"diversity",
"intuitive",
"nurturing",
"protective"
]
}
},
{
"name": "Saturn",
"longitude": 291.94353953255387,
"latitude": 0.07390792755091395,
"sign": "Capricorn",
"degree": 21.94353953255387,
"speed": -0.07405290614678961,
"isRetrograde": true,
"house": 3,
"dignity": "domicile",
"interpretation": {
"summary": "Your Saturn in Capricorn in The Third House reveals how you express responsibility, time, and routine with ambitious and disciplined energy in the realm of the lower mind.",
"detailed": "Saturn represents responsibility, time, and routine. In Capricorn (Goat), this energy becomes ambitious, disciplined, patient. Located in The Third House, you direct this Capricorn Saturn energy toward the lower mind and communication. This creates a unique expression where your responsibility, time, and routine naturally manifests through ambitious, disciplined, patient approaches in matters related to the third house.",
"keywords": [
"ambition",
"boundaries",
"determination",
"discipline",
"experience",
"ambitious",
"disciplined",
"patient"
]
}
},
{
"name": "Uranus",
"longitude": 276.956281802796,
"latitude": -0.32815436960618005,
"sign": "Capricorn",
"degree": 6.956281802796013,
"speed": -0.0384483570994405,
"isRetrograde": true,
"house": 2,
"dignity": "peregrine",
"interpretation": {
"summary": "Your Uranus in Capricorn in The Second House reveals how you express individuality and revolution with ambitious and disciplined energy in the realm of money and personal finances.",
"detailed": "Uranus represents individuality and revolution. In Capricorn (Goat), this energy becomes ambitious, disciplined, patient. Located in The Second House, you direct this Capricorn Uranus energy toward money and personal finances and sense of self-worth and basic values. This creates a unique expression where your individuality and revolution naturally manifests through ambitious, disciplined, patient approaches in matters related to the second house.",
"keywords": [
"avant-garde",
"change",
"comic",
"determined",
"experimental",
"ambitious",
"disciplined",
"patient"
]
}
},
{
"name": "Neptune",
"longitude": 282.9139975022088,
"latitude": 0.8724956724681929,
"sign": "Capricorn",
"degree": 12.913997502208815,
"speed": -0.026536991986546354,
"isRetrograde": true,
"house": 3,
"dignity": "peregrine",
"interpretation": {
"summary": "Your Neptune in Capricorn in The Third House reveals how you express dreams, healing, and intuition with ambitious and disciplined energy in the realm of the lower mind.",
"detailed": "Neptune represents dreams, healing, and intuition. In Capricorn (Goat), this energy becomes ambitious, disciplined, patient. Located in The Third House, you direct this Capricorn Neptune energy toward the lower mind and communication. This creates a unique expression where your dreams, healing, and intuition naturally manifests through ambitious, disciplined, patient approaches in matters related to the third house.",
"keywords": [
"artistic",
"calm",
"compassionate",
"deep",
"dreams",
"ambitious",
"disciplined",
"patient"
]
}
},
{
"name": "Pluto",
"longitude": 224.99788103667183,
"latitude": 15.61090590671027,
"sign": "Scorpio",
"degree": 14.997881036671828,
"speed": -0.005732571919807583,
"isRetrograde": true,
"house": 1,
"dignity": "domicile",
"interpretation": {
"summary": "Your Pluto in Scorpio in The First House reveals how you express sex, death, and transformation with seductive and passionate energy in the realm of self-image.",
"detailed": "Pluto represents sex, death, and transformation. In Scorpio (Scorpion), this energy becomes seductive, passionate, independent. Located in The First House, you direct this Scorpio Pluto energy toward self-image and physical appearance. This creates a unique expression where your sex, death, and transformation naturally manifests through seductive, passionate, independent approaches in matters related to the first house.",
"keywords": [
"alchemy",
"bold",
"charismatic",
"complex",
"courageous",
"seductive",
"passionate",
"independent"
]
}
},
{
"name": "North Node",
"longitude": 307.35871686645265,
"latitude": 0,
"sign": "Aquarius",
"degree": 7.358716866452653,
"speed": -0.0031712752905264097,
"isRetrograde": true,
"house": 3,
"interpretation": {
"summary": "Your North Node in Aquarius in The Third House reveals how you express life purpose and destiny with imaginative and idealistic energy in the realm of the lower mind.",
"detailed": "North Node represents life purpose and destiny. In Aquarius (Water Bearer), this energy becomes imaginative, idealistic, intuitive. Located in The Third House, you direct this Aquarius North Node energy toward the lower mind and communication. This creates a unique expression where your life purpose and destiny naturally manifests through imaginative, idealistic, intuitive approaches in matters related to the third house.",
"keywords": [
"destiny",
"life purpose",
"soul growth",
"future direction",
"karmic reward",
"imaginative",
"idealistic",
"intuitive"
]
}
},
{
"name": "South Node",
"longitude": 127.35871686645265,
"latitude": 0,
"sign": "Leo",
"degree": 7.358716866452653,
"speed": -0.0031712752905264097,
"isRetrograde": true,
"house": 9,
"interpretation": {
"summary": "Your South Node in Leo in The Ninth House reveals how you express past life gifts and comfort zone with proud and bold energy in the realm of exploration.",
"detailed": "South Node represents past life gifts and comfort zone. In Leo (Lion), this energy becomes proud, bold, ambitious. Located in The Ninth House, you direct this Leo South Node energy toward exploration and religious beliefs and personal philosophy. This creates a unique expression where your past life gifts and comfort zone naturally manifests through proud, bold, ambitious approaches in matters related to the ninth house.",
"keywords": [
"innate talents",
"past life wisdom",
"natural abilities",
"comfort zone",
"mastered skills",
"proud",
"bold",
"ambitious"
]
}
},
{
"name": "Chiron",
"longitude": 109.25705196871604,
"latitude": -6.240259250272088,
"sign": "Cancer",
"degree": 19.25705196871604,
"speed": 0.10748734886365696,
"isRetrograde": false,
"house": 9,
"interpretation": {
"summary": "Your Chiron in Cancer in The Ninth House reveals how you express healing and inner wounds with intuitive and nurturing energy in the realm of exploration.",
"detailed": "Chiron represents healing and inner wounds. In Cancer (Crab), this energy becomes intuitive, nurturing, protective. Located in The Ninth House, you direct this Cancer Chiron energy toward exploration and religious beliefs and personal philosophy. This creates a unique expression where your healing and inner wounds naturally manifests through intuitive, nurturing, protective approaches in matters related to the ninth house.",
"keywords": [
"healing",
"wisdom",
"mentorship",
"teaching",
"empathy",
"intuitive",
"nurturing",
"protective"
]
}
},
{
"name": "Black Moon Lilith",
"longitude": 238.3402727210398,
"latitude": -4.828700516273704,
"sign": "Scorpio",
"degree": 28.34027272103981,
"speed": 0.1119058931179211,
"isRetrograde": false,
"house": 1,
"interpretation": {
"summary": "Your Black Moon Lilith in Scorpio in The First House reveals how you express primal instinct and the reclaimed self with seductive and passionate energy in the realm of self-image.",
"detailed": "Black Moon Lilith represents primal instinct and the reclaimed self. In Scorpio (Scorpion), this energy becomes seductive, passionate, independent. Located in The First House, you direct this Scorpio Black Moon Lilith energy toward self-image and physical appearance. This creates a unique expression where your primal instinct and the reclaimed self naturally manifests through seductive, passionate, independent approaches in matters related to the first house.",
"keywords": [
"authenticity",
"autonomy",
"instinct",
"raw power",
"self-possession",
"seductive",
"passionate",
"independent"
]
}
}
],
"houses": [
{
"number": 1,
"longitude": 216.9473683504864,
"sign": "Scorpio",
"degree": 6.947368350486414
},
{
"number": 2,
"longitude": 245.7049079943925,
"sign": "Sagittarius",
"degree": 5.704907994392499
},
{
"number": 3,
"longitude": 278.86442531913195,
"sign": "Capricorn",
"degree": 8.864425319131954
},
{
"number": 4,
"longitude": 314.37546066763866,
"sign": "Aquarius",
"degree": 14.375460667638663
},
{
"number": 5,
"longitude": 347.2692115961678,
"sign": "Pisces",
"degree": 17.269211596167793
},
{
"number": 6,
"longitude": 14.67330657058801,
"sign": "Aries",
"degree": 14.67330657058801
},
{
"number": 7,
"longitude": 36.947368350486386,
"sign": "Taurus",
"degree": 6.947368350486386
},
{
"number": 8,
"longitude": 65.7049079943925,
"sign": "Gemini",
"degree": 5.704907994392499
},
{
"number": 9,
"longitude": 98.86442531913195,
"sign": "Cancer",
"degree": 8.864425319131954
},
{
"number": 10,
"longitude": 134.3754606676387,
"sign": "Leo",
"degree": 14.375460667638691
},
{
"number": 11,
"longitude": 167.26921159616782,
"sign": "Virgo",
"degree": 17.26921159616782
},
{
"number": 12,
"longitude": 194.67330657058804,
"sign": "Libra",
"degree": 14.67330657058804
}
],
"houseSystem": "placidus",
"aspects": [
{
"planet1": "North Node",
"planet2": "South Node",
"type": "OPPOSITION",
"angle": 180,
"orb": 0,
"isApplying": false,
"strength": 100,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your North Node forms a very strong opposition (180) with South Node, currently separating (weakening). This challenging aspect highlights themes of accept, accepting, and balance.",
"keywords": [
"accept",
"accepting",
"balance",
"challenge",
"complacent",
"easy",
"growth",
"obstacle",
"relationship",
"struggle",
"talent",
"tension"
]
}
},
{
"planet1": "Mercury",
"planet2": "North Node",
"type": "OPPOSITION",
"angle": 180,
"orb": 0.07826851524703216,
"isApplying": true,
"strength": 99.0216435594121,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Mercury forms a very strong opposition (180) with North Node, currently applying (strengthening). This challenging aspect highlights themes of accept, accepting, and balance.",
"keywords": [
"accept",
"accepting",
"balance",
"challenge",
"complacent",
"easy",
"growth",
"obstacle",
"relationship",
"struggle",
"talent",
"tension"
]
}
},
{
"planet1": "Mercury",
"planet2": "South Node",
"type": "CONJUNCTION",
"angle": 0,
"orb": 0.07826851524704637,
"isApplying": true,
"strength": 99.02164355941193,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Mercury forms a very strong conjunction (0) with South Node, currently applying (strengthening). This neutral aspect highlights themes of blend, difficult, and unite.",
"keywords": [
"blend",
"difficult",
"unite",
"united"
]
}
},
{
"planet1": "Sun",
"planet2": "Jupiter",
"type": "CONJUNCTION",
"angle": 0,
"orb": 0.39457481533511896,
"isApplying": false,
"strength": 95.06781480831101,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Sun forms a very strong conjunction (0) with Jupiter, currently separating (weakening). This neutral aspect highlights themes of blend, difficult, and unite.",
"keywords": [
"blend",
"difficult",
"unite",
"united"
]
}
},
{
"planet1": "Jupiter",
"planet2": "Saturn",
"type": "OPPOSITION",
"angle": 180,
"orb": 0.6664061842696185,
"isApplying": false,
"strength": 91.66992269662977,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Jupiter forms a very strong opposition (180) with Saturn, currently separating (weakening). This challenging aspect highlights themes of accept, accepting, and balance.",
"keywords": [
"accept",
"accepting",
"balance",
"challenge",
"complacent",
"easy",
"growth",
"obstacle",
"relationship",
"struggle",
"talent",
"tension"
]
}
},
{
"planet1": "Mercury",
"planet2": "Uranus",
"type": "QUINCUNX",
"angle": 150,
"orb": 0.32416654840960746,
"isApplying": false,
"strength": 89.19444838634641,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Mercury forms a very strong quincunx (150) with Uranus, currently separating (weakening). This challenging aspect highlights themes of adjustment, tension, and adaptation.",
"keywords": [
"adjustment",
"tension",
"adaptation",
"redirection"
]
}
},
{
"planet1": "Sun",
"planet2": "Saturn",
"type": "OPPOSITION",
"angle": 180,
"orb": 1.0609809996047375,
"isApplying": false,
"strength": 86.73773750494078,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Sun forms a very strong opposition (180) with Saturn, currently separating (weakening). This challenging aspect highlights themes of accept, accepting, and balance.",
"keywords": [
"accept",
"accepting",
"balance",
"challenge",
"complacent",
"easy",
"growth",
"obstacle",
"relationship",
"struggle",
"talent",
"tension"
]
}
},
{
"planet1": "Uranus",
"planet2": "North Node",
"type": "SEMI_SEXTILE",
"angle": 30,
"orb": 0.4024350636566396,
"isApplying": false,
"strength": 86.58549787811202,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Uranus forms a very strong semi-sextile (30) with North Node, currently separating (weakening). This neutral aspect highlights themes of growth, subtle, and adjustment.",
"keywords": [
"growth",
"subtle",
"adjustment",
"awareness"
]
}
},
{
"planet1": "Uranus",
"planet2": "South Node",
"type": "QUINCUNX",
"angle": 150,
"orb": 0.4024350636566396,
"isApplying": false,
"strength": 86.58549787811202,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Uranus forms a very strong quincunx (150) with South Node, currently separating (weakening). This challenging aspect highlights themes of adjustment, tension, and adaptation.",
"keywords": [
"adjustment",
"tension",
"adaptation",
"redirection"
]
}
},
{
"planet1": "Neptune",
"planet2": "Black Moon Lilith",
"type": "SEMI_SQUARE",
"angle": 45,
"orb": 0.4262752188309946,
"isApplying": false,
"strength": 78.68623905845027,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Neptune forms a strong semi-square (45) with Black Moon Lilith, currently separating (weakening). This challenging aspect highlights themes of friction, irritation, and agitation.",
"keywords": [
"friction",
"irritation",
"agitation",
"minor tension"
]
}
},
{
"planet1": "Saturn",
"planet2": "Chiron",
"type": "OPPOSITION",
"angle": 180,
"orb": 2.6864875638378294,
"isApplying": true,
"strength": 66.41890545202713,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Saturn forms a strong opposition (180) with Chiron, currently applying (strengthening). This challenging aspect highlights themes of accept, accepting, and balance.",
"keywords": [
"accept",
"accepting",
"balance",
"challenge",
"complacent",
"easy",
"growth",
"obstacle",
"relationship",
"struggle",
"talent",
"tension"
]
}
},
{
"planet1": "Neptune",
"planet2": "Pluto",
"type": "SEXTILE",
"angle": 60,
"orb": 2.0838835344630127,
"isApplying": false,
"strength": 65.26860775894978,
"interpretation": "harmonious",
"aspectInterpretation": {
"summary": "Your Neptune forms a strong sextile (60) with Pluto, currently separating (weakening). This harmonious aspect highlights themes of ease, natural, and relationship.",
"keywords": [
"ease",
"natural",
"relationship",
"talent"
]
}
},
{
"planet1": "Moon",
"planet2": "Venus",
"type": "SEXTILE",
"angle": 60,
"orb": 2.3328559105867868,
"isApplying": false,
"strength": 61.11906815688688,
"interpretation": "harmonious",
"aspectInterpretation": {
"summary": "Your Moon forms a strong sextile (60) with Venus, currently separating (weakening). This harmonious aspect highlights themes of ease, natural, and relationship.",
"keywords": [
"ease",
"natural",
"relationship",
"talent"
]
}
},
{
"planet1": "Jupiter",
"planet2": "Chiron",
"type": "CONJUNCTION",
"angle": 0,
"orb": 3.352893748107448,
"isApplying": false,
"strength": 58.0888281486569,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Jupiter forms a moderate conjunction (0) with Chiron, currently separating (weakening). This neutral aspect highlights themes of blend, difficult, and unite.",
"keywords": [
"blend",
"difficult",
"unite",
"united"
]
}
},
{
"planet1": "Moon",
"planet2": "Black Moon Lilith",
"type": "QUINCUNX",
"angle": 150,
"orb": 1.2713340468812078,
"isApplying": true,
"strength": 57.62219843729308,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Moon forms a moderate quincunx (150) with Black Moon Lilith, currently applying (strengthening). This challenging aspect highlights themes of adjustment, tension, and adaptation.",
"keywords": [
"adjustment",
"tension",
"adaptation",
"redirection"
]
}
},
{
"planet1": "Sun",
"planet2": "Chiron",
"type": "CONJUNCTION",
"angle": 0,
"orb": 3.747468563442567,
"isApplying": false,
"strength": 53.156642956967914,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Sun forms a moderate conjunction (0) with Chiron, currently separating (weakening). This neutral aspect highlights themes of blend, difficult, and unite.",
"keywords": [
"blend",
"difficult",
"unite",
"united"
]
}
},
{
"planet1": "Pluto",
"planet2": "Chiron",
"type": "TRINE",
"angle": 120,
"orb": 4.2591709320442135,
"isApplying": false,
"strength": 46.76036334944733,
"interpretation": "harmonious",
"aspectInterpretation": {
"summary": "Your Pluto forms a moderate trine (120) with Chiron, currently separating (weakening). This harmonious aspect highlights themes of accept, accepting, and difficult.",
"keywords": [
"accept",
"accepting",
"difficult",
"natural",
"support",
"talent"
]
}
},
{
"planet1": "Sun",
"planet2": "Venus",
"type": "SEMI_SEXTILE",
"angle": 30,
"orb": 1.7315622314132213,
"isApplying": false,
"strength": 42.28125895289262,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Sun forms a moderate semi-sextile (30) with Venus, currently separating (weakening). This neutral aspect highlights themes of growth, subtle, and adjustment.",
"keywords": [
"growth",
"subtle",
"adjustment",
"awareness"
]
}
},
{
"planet1": "Sun",
"planet2": "Moon",
"type": "SQUARE",
"angle": 90,
"orb": 4.064418142000008,
"isApplying": false,
"strength": 41.936883685714164,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Sun forms a moderate square (90) with Moon, currently separating (weakening). This challenging aspect highlights themes of difficult, obstacle, and stress.",
"keywords": [
"difficult",
"obstacle",
"stress",
"tension"
]
}
},
{
"planet1": "Mars",
"planet2": "Uranus",
"type": "TRINE",
"angle": 120,
"orb": 4.832852544835703,
"isApplying": true,
"strength": 39.589343189553716,
"interpretation": "harmonious",
"aspectInterpretation": {
"summary": "Your Mars forms a weak trine (120) with Uranus, currently applying (strengthening). This harmonious aspect highlights themes of accept, accepting, and difficult.",
"keywords": [
"accept",
"accepting",
"difficult",
"natural",
"support",
"talent"
]
}
},
{
"planet1": "Moon",
"planet2": "Mars",
"type": "CONJUNCTION",
"angle": 0,
"orb": 5.054490583801698,
"isApplying": true,
"strength": 36.81886770247878,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Moon forms a weak conjunction (0) with Mars, currently applying (strengthening). This neutral aspect highlights themes of blend, difficult, and unite.",
"keywords": [
"blend",
"difficult",
"unite",
"united"
]
}
},
{
"planet1": "Moon",
"planet2": "Jupiter",
"type": "SQUARE",
"angle": 90,
"orb": 4.458992957335127,
"isApplying": false,
"strength": 36.30010060949819,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Moon forms a weak square (90) with Jupiter, currently separating (weakening). This challenging aspect highlights themes of difficult, obstacle, and stress.",
"keywords": [
"difficult",
"obstacle",
"stress",
"tension"
]
}
},
{
"planet1": "Sun",
"planet2": "Black Moon Lilith",
"type": "TRINE",
"angle": 120,
"orb": 5.335752188881202,
"isApplying": true,
"strength": 33.30309763898498,
"interpretation": "harmonious",
"aspectInterpretation": {
"summary": "Your Sun forms a weak trine (120) with Black Moon Lilith, currently applying (strengthening). This harmonious aspect highlights themes of accept, accepting, and difficult.",
"keywords": [
"accept",
"accepting",
"difficult",
"natural",
"support",
"talent"
]
}
},
{
"planet1": "Venus",
"planet2": "Jupiter",
"type": "SEMI_SEXTILE",
"angle": 30,
"orb": 2.1261370467483403,
"isApplying": false,
"strength": 29.128765108388656,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Venus forms a weak semi-sextile (30) with Jupiter, currently separating (weakening). This neutral aspect highlights themes of growth, subtle, and adjustment.",
"keywords": [
"growth",
"subtle",
"adjustment",
"awareness"
]
}
},
{
"planet1": "Jupiter",
"planet2": "Black Moon Lilith",
"type": "TRINE",
"angle": 120,
"orb": 5.730327004216321,
"isApplying": true,
"strength": 28.370912447295993,
"interpretation": "harmonious",
"aspectInterpretation": {
"summary": "Your Jupiter forms a weak trine (120) with Black Moon Lilith, currently applying (strengthening). This harmonious aspect highlights themes of accept, accepting, and difficult.",
"keywords": [
"accept",
"accepting",
"difficult",
"natural",
"support",
"talent"
]
}
},
{
"planet1": "Moon",
"planet2": "Saturn",
"type": "SQUARE",
"angle": 90,
"orb": 5.12539914160476,
"isApplying": false,
"strength": 26.780012262789143,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Moon forms a weak square (90) with Saturn, currently separating (weakening). This challenging aspect highlights themes of difficult, obstacle, and stress.",
"keywords": [
"difficult",
"obstacle",
"stress",
"tension"
]
}
},
{
"planet1": "Mercury",
"planet2": "Mars",
"type": "SQUARE",
"angle": 90,
"orb": 5.157019093245296,
"isApplying": false,
"strength": 26.328298667924344,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Mercury forms a weak square (90) with Mars, currently separating (weakening). This challenging aspect highlights themes of difficult, obstacle, and stress.",
"keywords": [
"difficult",
"obstacle",
"stress",
"tension"
]
}
},
{
"planet1": "Uranus",
"planet2": "Neptune",
"type": "CONJUNCTION",
"angle": 0,
"orb": 5.957715699412802,
"isApplying": false,
"strength": 25.528553757339978,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Uranus forms a weak conjunction (0) with Neptune, currently separating (weakening). This neutral aspect highlights themes of blend, difficult, and unite.",
"keywords": [
"blend",
"difficult",
"unite",
"united"
]
}
},
{
"planet1": "Mars",
"planet2": "North Node",
"type": "SQUARE",
"angle": 90,
"orb": 5.235287608492342,
"isApplying": true,
"strength": 25.210177021537973,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Mars forms a weak square (90) with North Node, currently applying (strengthening). This challenging aspect highlights themes of difficult, obstacle, and stress.",
"keywords": [
"difficult",
"obstacle",
"stress",
"tension"
]
}
},
{
"planet1": "Mars",
"planet2": "South Node",
"type": "SQUARE",
"angle": 90,
"orb": 5.235287608492342,
"isApplying": true,
"strength": 25.210177021537973,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Mars forms a weak square (90) with South Node, currently applying (strengthening). This challenging aspect highlights themes of difficult, obstacle, and stress.",
"keywords": [
"difficult",
"obstacle",
"stress",
"tension"
]
}
},
{
"planet1": "Neptune",
"planet2": "Chiron",
"type": "OPPOSITION",
"angle": 180,
"orb": 6.343054466507226,
"isApplying": false,
"strength": 20.711819168659673,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Neptune forms a weak opposition (180) with Chiron, currently separating (weakening). This challenging aspect highlights themes of accept, accepting, and balance.",
"keywords": [
"accept",
"accepting",
"balance",
"challenge",
"complacent",
"easy",
"growth",
"obstacle",
"relationship",
"struggle",
"talent",
"tension"
]
}
},
{
"planet1": "Venus",
"planet2": "Saturn",
"type": "QUINCUNX",
"angle": 150,
"orb": 2.7925432310179588,
"isApplying": false,
"strength": 6.915225632734712,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Venus forms a weak quincunx (150) with Saturn, currently separating (weakening). This challenging aspect highlights themes of adjustment, tension, and adaptation.",
"keywords": [
"adjustment",
"tension",
"adaptation",
"redirection"
]
}
},
{
"planet1": "Jupiter",
"planet2": "Pluto",
"type": "TRINE",
"angle": 120,
"orb": 7.612064680151661,
"isApplying": false,
"strength": 4.849191498104233,
"interpretation": "harmonious",
"aspectInterpretation": {
"summary": "Your Jupiter forms a weak trine (120) with Pluto, currently separating (weakening). This harmonious aspect highlights themes of accept, accepting, and difficult.",
"keywords": [
"accept",
"accepting",
"difficult",
"natural",
"support",
"talent"
]
}
}
],
"ascendant": {
"longitude": 216.9473683504864,
"sign": "Scorpio",
"degree": 6.947368350486414
},
"midheaven": {
"longitude": 134.3754606676387,
"sign": "Leo",
"degree": 14.375460667638691
},
"partOfFortune": {
"sign": "Leo",
"degree": 11.011786492486408,
"longitude": 131.0117864924864,
"sect": "day",
"house": 9
},
"vertex": {
"longitude": 77.23544691076316,
"sign": "Gemini",
"degree": 17.23544691076316,
"house": 8
},
"patterns": [
{
"kind": "T_SQUARE",
"name": "T-Square",
"planets": [
"Moon",
"Sun",
"Saturn"
],
"apex": "Moon",
"modality": "cardinal",
"dissociate": false,
"tightness": 62,
"interpretationKey": "aspectPattern.tSquare",
"interpretationVars": {
"apex": "Moon",
"apexSign": "Aries",
"end1": "Sun",
"end2": "Saturn"
},
"interpretation": "T-Square focused on Moon in Aries, tension between Sun and Saturn demands resolution at the apex, the primary growth engine of the chart."
},
{
"kind": "T_SQUARE",
"name": "T-Square",
"planets": [
"Moon",
"Jupiter",
"Saturn"
],
"apex": "Moon",
"modality": "cardinal",
"dissociate": false,
"tightness": 62,
"interpretationKey": "aspectPattern.tSquare",
"interpretationVars": {
"apex": "Moon",
"apexSign": "Aries",
"end1": "Jupiter",
"end2": "Saturn"
},
"interpretation": "T-Square focused on Moon in Aries, tension between Jupiter and Saturn demands resolution at the apex, the primary growth engine of the chart."
},
{
"kind": "STELLIUM",
"name": "Stellium",
"planets": [
"Uranus",
"Neptune",
"Saturn"
],
"tightness": 100,
"interpretationKey": "aspectPattern.stelliumSameSign",
"interpretationVars": {
"count": "3",
"sign": "Capricorn",
"planets": "Uranus, Neptune, and Saturn"
},
"interpretation": "Stellium of 3 planets in Capricorn, concentrated energy demanding mastery of Capricorn themes through Uranus, Neptune, and Saturn."
}
],
"aspectsInterpretation": {
"summary": "Your chart contains 33 aspects: 7 harmonious, 17 challenging, and 9 neutral. The balanced mix of aspects suggests a well-rounded chart with both natural talents and growth opportunities.",
"dominant": "balanced",
"harmonious": 7,
"challenging": 17,
"neutral": 9
},
"summary": {
"dominantElement": "Earth",
"dominantModality": "Cardinal",
"retrogradePlanets": [
"Saturn",
"Uranus",
"Neptune",
"Pluto",
"North Node",
"South Node"
],
"elementDistribution": {
"Fire": 2,
"Earth": 4,
"Air": 1,
"Water": 3
},
"modalityDistribution": {
"Cardinal": 6,
"Fixed": 3,
"Mutable": 1
}
}
}Response fields
| Field | Type | Description |
|---|---|---|
| birthDetails* | object | Birth details echoed back from the request. Confirms the input used for this chart calculation. |
| birthDetails.date* | string | Birth date used for this chart (YYYY-MM-DD). |
| birthDetails.time* | string | Birth time used for this chart (HH:MM:SS, 24-hour). |
| birthDetails.latitude* | number | Birth latitude in decimal degrees. |
| birthDetails.longitude* | number | Birth longitude in decimal degrees. |
| birthDetails.timezone* | number | Timezone offset from UTC in decimal hours. |
| planets* | array of object | All 14 celestial bodies (10 classical planets, lunar nodes, Chiron, Black Moon Lilith) with zodiac signs, house placements, and interpretations. |
| planets[].name* | string | Planet or point name (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, South Node, Chiron, Black Moon Lilith). Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use nameLocalized for anything a reader sees. The lunar nodes follow the request nodeType, which defaults to the true (osculating) node; pass "mean" for the smoothed node. The two differ by up to about 1.8 degrees and no other body is affected. |
| planets[].nameLocalized | string | Planet or point name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| planets[].longitude* | number | Apparent geocentric tropical longitude on the true ecliptic of date, in degrees (0-360): light time and aberration applied, nutation included, the convention desktop chart software and the NASA JPL Horizons observer tables print, so it compares directly with either. |
| planets[].latitude* | number | Apparent geocentric ecliptic latitude of date, in degrees. |
| planets[].sign* | string | Tropical zodiac sign this planet occupies. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use signLocalized for anything a reader sees. |
| planets[].signLocalized | string | Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| planets[].degree* | number | Degree within the zodiac sign (0-29.999). |
Show all fieldsShow fewer fields
| Field | Type | Description |
|---|---|---|
| planets[].house* | number | House placement (1-12) based on the selected house system. |
| planets[].speed* | number | Daily motion in degrees per day. Negative values indicate retrograde. |
| planets[].isRetrograde* | boolean | Whether the planet is in retrograde motion. |
| planets[].dignity | string enum | Essential dignity of this body in the sign it occupies: domicile (the sign it rules, its strongest placement), exaltation (honoured and amplified), detriment (opposite its rulership, where it struggles), fall (opposite its exaltation, where it is weakened), or peregrine (in none of its own dignity signs). Absent for the lunar nodes, Chiron and Black Moon Lilith, which rule no sign and therefore hold no dignity at all, so an absent field and peregrine are different answers. Derived by sign only, so triplicity, bounds and face are not considered. Always English, whatever the lang parameter says, so it stays safe to compare against in code. The four dignity signs behind it are published per body by GET /planet-meanings/{id}. |
| planets[].interpretation | object | Planet-in-sign-in-house interpretation. Narrative analysis of what this placement means in the natal chart. |
| planets[].interpretation.summary* | string | One-sentence interpretation of this planet in its sign and house placement. |
| planets[].interpretation.detailed* | string | Multi-sentence detailed interpretation with personality insights. |
| planets[].interpretation.keywords* | array of string | Key personality traits and themes for this placement. |
| houses* | array of object | All 12 house cusps with zodiac positions. House cusps divide the chart into life areas. |
| houses[].number* | number | House number (1-12). |
| houses[].longitude* | number | Ecliptic longitude of this house cusp (0-360). |
| houses[].sign* | string | Zodiac sign on this house cusp. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees. |
| houses[].signLocalized | string | Zodiac sign name on this cusp in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| houses[].degree* | number | Degree within the zodiac sign (0-29.999). |
| houseSystem* | string | House system used for this chart (placidus, whole-sign, equal, or koch). |
| aspects* | array of object | All planetary aspects found in this chart with orbs, strength, and interpretation. |
| aspects[].planet1* | string | First planet in the aspect pair. Always English, whatever the lang parameter says. Use planet1Localized for anything a reader sees. |
| aspects[].planet1Localized | string | First planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| aspects[].planet2* | string | Second planet in the aspect pair. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees. |
| aspects[].planet2Localized | string | Second planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| aspects[].type* | string | Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.). Always English, whatever the lang parameter says. Use typeLocalized for anything a reader sees. |
| aspects[].typeLocalized | string | Aspect type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| aspects[].angle* | number | Exact angle of this aspect type in degrees. |
| aspects[].orb* | number | Distance from exact aspect in degrees. Tighter orb means stronger influence. |
| aspects[].isApplying* | boolean | Whether the aspect is applying (growing stronger) or separating (fading). |
| aspects[].strength* | number | Aspect strength percentage (0-100) based on orb tightness. |
| aspects[].interpretation* | string | Aspect nature: harmonious, challenging, or neutral. Always English, whatever the lang parameter says, because it is an identifier to compare and style on. Read aspectInterpretation for the sentence a reader sees. |
| aspects[].aspectInterpretation* | object | Narrative interpretation of this aspect for this chart. The reference description of the aspect TYPE is not repeated per row, use GET or POST /astrology/aspects for that card. |
| aspects[].aspectInterpretation.summary* | string | One-sentence read of THIS pair: which two bodies, how tight the aspect is, whether it is applying or separating, and how it is classified. Translated in place, so it arrives in the requested language. |
| aspects[].aspectInterpretation.keywords* | array of string | Themes this aspect activates between the two bodies. Translated in place, so they arrive in the requested language. |
| patterns | array of object | Detected multi-planet aspect configurations (Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, Stellium). Grand Cross suppresses contained T-Squares, Kite suppresses underlying Grand Trine. |
| patterns[].kind* | string enum | Pattern kind identifier. GRAND_TRINE (3 trines, harmonious flow), KITE (Grand Trine with a focal outlet planet), T_SQUARE (opposition with squared apex, growth engine), GRAND_CROSS (4 planets in 2 oppositions and 4 squares, peak tension), YOD (Finger of Fate, fated adjustment), MYSTIC_RECTANGLE (oppositions softened by trines and sextiles), STELLIUM (3+ planets clustered in a sign or 10-degree arc). |
| patterns[].name* | string | Human-readable name of the configuration as used in astrological literature. |
| patterns[].planets* | array of string | Participating bodies in canonical order. For Kite, T-Square, and Yod the apex planet appears first. |
| patterns[].apex | string | Focal planet for Kite, T-Square, and Yod patterns. Receives the released energy of the configuration and is the recommended integration point. |
| patterns[].element | string enum | Dominant element when the pattern is element-coherent (Grand Trine, Kite). Reported lowercase. Absent for patterns whose meaning does not pivot on element. |
| patterns[].modality | string enum | Dominant modality for tension-based patterns (T-Square, Grand Cross). Cardinal initiates, Fixed sustains, Mutable adapts. |
| patterns[].dissociate | boolean | True if the pattern is out-of-sign (one or more planets in a neighboring element or modality). Dissociate patterns are still valid but operate with weakened thematic coherence. |
| patterns[].tightness* | number | Tightness score (0-100) derived from the average orb tightness across all defining aspects. Higher means closer to exact and stronger thematic expression. |
| patterns[].interpretation* | string | Concise one-line interpretation naming the participating planets and theme. Localized to the requested language via the lang query parameter (defaults to English). |
| patterns[].interpretationKey* | string | Stable template identifier used to render the interpretation. Useful for clients that wish to swap in a custom narrative template while preserving the structured variables. |
| patterns[].interpretationVars* | object | Variables that were interpolated into the interpretation template. Names already resolved to the requested language where appropriate. |
| aspectsInterpretation* | object | Aspect pattern analysis showing the balance of harmonious vs challenging energies in the chart. |
| aspectsInterpretation.summary* | string | Narrative summary of the overall aspect pattern in this chart. |
| aspectsInterpretation.dominant* | string | Whether the chart is predominantly harmonious, challenging, or balanced. |
| aspectsInterpretation.harmonious* | number | Count of harmonious aspects (trine, sextile). |
| aspectsInterpretation.challenging* | number | Count of challenging aspects (square, opposition). |
| aspectsInterpretation.neutral* | number | Count of neutral aspects (conjunction). |
| ascendant* | object | Ascendant (rising sign). The eastern horizon at birth, defining outward personality and physical appearance. |
| ascendant.sign* | string | Zodiac sign on the Ascendant (rising sign). Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees. |
| ascendant.signLocalized | string | Ascendant sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| ascendant.degree* | number | Degree within the Ascendant sign (0-29.999). |
| ascendant.longitude* | number | Absolute ecliptic longitude of the Ascendant (0-360). |
| midheaven* | object | Midheaven (MC). The highest point of the ecliptic at birth, representing career direction and public image. |
| midheaven.sign* | string | Zodiac sign on the Midheaven (MC). Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees. |
| midheaven.signLocalized | string | Midheaven sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| midheaven.degree* | number | Degree within the Midheaven sign (0-29.999). |
| midheaven.longitude* | number | Absolute ecliptic longitude of the Midheaven (0-360). |
| partOfFortune* | object | Part of Fortune (Lot of Fortune). A point derived from the Ascendant and the two luminaries that marks an area of ease, vitality, and material wellbeing in the chart. |
| partOfFortune.sign* | string | Zodiac sign holding the Part of Fortune. |
| partOfFortune.degree* | number | Degree within the Part of Fortune sign (0-29.999). |
| partOfFortune.longitude* | number | Absolute ecliptic longitude of the Part of Fortune (0-360). |
| partOfFortune.house* | integer | House containing this point, resolved against the same cusps as `planets[].house` and using the requested house system. Read this field rather than inferring a house from the sign: the two disagree whenever a house spans more than one sign, which is most of the time outside Whole Sign. |
| partOfFortune.sect* | string enum | Chart sect used for the calculation. Day (diurnal) when the Sun is above the horizon, night (nocturnal) when below. Day charts use Ascendant plus Moon minus Sun, night charts use Ascendant plus Sun minus Moon. |
| partOfFortune.signLocalized | string | Part of Fortune sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| vertex* | object | Vertex. The western intersection of the prime vertical with the ecliptic, often read as a point of fated encounters and turning-point relationships. The opposite point is the Anti-Vertex. |
Supported options
lang
entrdeeshiptfrruzh-Hanszh-Hant
nodeType
meantrue
houseSystem
placiduswhole-signequalkoch
Call it in your language.
Every snippet is generated from the live OpenAPI spec, so method names, parameters, and fields always match production.
TypeScript
import { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.astrology.generateNatalChart({ body: { date: '1990-07-15', time: '14:30:00', latitude: 40.7128, longitude: -74.006, timezone: 'America/New_York' } })Install: npm install @roxyapi/sdk
Python
from roxy_sdk import create_roxy
roxy = create_roxy("YOUR_API_KEY")
result = roxy.astrology.generate_natal_chart(date='1990-07-15', time='14:30:00', latitude=40.7128, longitude=-74.006, timezone='America/New_York')Install: pip install roxy-sdk
PHP
use function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->astrology->generateNatalChart(date: '1990-07-15', time: '14:30:00', latitude: 40.7128, longitude: -74.006, timezone: 'America/New_York');Install: composer require roxyapi/sdk
C#
using RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Astrology.NatalChart.PostAsync(new() { /* request fields above */ });Install: dotnet add package RoxyApi.Sdk
Go
import roxyapi "github.com/RoxyAPI/sdk-go"
roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Astrology.GenerateNatalChart(ctx, nil, roxyapi.GenerateNatalChartJSONRequestBody{ /* request fields above */ })Install: go get github.com/RoxyAPI/sdk-go
cURL
curl -X POST "https://roxyapi.com/api/v2/astrology/natal-chart" \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"1990-07-15","time":"14:30:00","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'Prefer to try before you write code? Run this Western Astrology endpoint live in the API playground and inspect a real production response.
Remote MCP for AI agents
Every Western Astrology endpoint is a callable tool on the Remote MCP server over Streamable HTTP. No local setup, no Docker. Claude, ChatGPT, Cursor, and any MCP client auto-discover the tools and ground their answers in verified data.
Claude Code / Cursor
claude mcp add --transport http \
roxy-astrology https://roxyapi.com/mcp/astrology \
--header "X-API-Key: YOUR_KEY"Tool name for POST /astrology/natal-chart: post_astrology_natal_chart. Full MCP setup guide
What you can build
Launch natal chart apps with professional-grade accuracy: birth charts, planet positions, house placements, aspects, and element analysis ready for your UI
Add zodiac compatibility scoring to dating apps: synastry analysis, composite charts, and compatibility scores with detailed relationship dynamics
Ship personalized horoscope platforms: editorial daily, weekly, monthly, and yearly columns with unique content per sign, the dated events each one rests on returned beside the prose for fact-checking, active transit metadata, Moon phase data, and any past or future period on request for editorial pre-publishing
Build AI astrology chatbots with MCP: your OpenAI, Claude, or Gemini agent auto-discovers and calls every astrology endpoint with zero integration code
Power wellness and lifestyle apps with real-time transits, moon phase calendars, solar returns, and planetary movement alerts for self-discovery features
Create astrology content engines: automated zodiac content with house-based uniqueness per sign, horoscope newsletters with real lunar event dates, transit alerts, and year-ahead pages built from every eclipse and every retrograde and direct station of the year with the house each one falls in for that sign
Drop-in UI components and no-code widgets.
Render Natal Chart API responses without building charts yourself. Install the npm package and drop these into Next.js, React, Vue, Svelte, Angular, or plain HTML, or embed the very same component on Squarespace, Wix, or WordPress by pasting one snippet, with no backend and no build step. They belong to one library that covers the entire spiritual stack rather than astrology alone, MIT licensed and included in every plan at no extra cost, never a separate product and never an upsell. The Natal Chart API calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.
MIT licensedFramework agnosticThemeable via CSS variablesnpm or CDN
Natal chart widget snippet
Western planets table widget snippet
The complete UI libraryExplore Roxy UI
Western planets table widget snippet
The complete UI libraryExplore Roxy UI
Show all Natal Chart UI componentsShow fewer Natal Chart UI components
| Element | Renders |
|---|---|
| <roxy-natal-chart> | Natal chart wheel with planet glyphs and aspect lines |
| <roxy-western-planets-table> | Sign, degree, house, motion columns plus ASC, MC, PoF, Vertex |
Related capabilities
Natal Chart API FAQ
What does the Natal Chart API return?
Calculate complete Western astrology natal chart (birth chart) with tropical zodiac. Every response is structured JSON with documented fields, not free text, so you map it straight into your product.
How do I authenticate with the Natal Chart API?
Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.
Does the Natal Chart API support multiple languages?
Yes. Append the lang query parameter to any endpoint for responses in English, German, Spanish, French, Hindi, Portuguese, Russian and Turkish. The translated payload includes the full interpretation text, not just field labels.
Do I need coordinates to call the Natal Chart API?
No. Call GET /location/search with a city name first, then pass latitude, longitude, and timezone from the first result into the request. Never ask users to type coordinates. Timezone accepts a decimal offset or an IANA name.
Is the Natal Chart API available over Remote MCP for AI agents?
Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/astrology over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.
How is the Natal Chart API billed?
Flat pricing: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 18 domains, so the Natal Chart API is included at no extra cost.
What nodeType values does the Natal Chart API accept?
The nodeType parameter accepts mean, true. Case-insensitive where it is a path value.
Start using Natal Chart API today.
Birth charts checked cusp by cusp, and horoscopes that name the dated sky events behind each reading.
All 18 domains included with every plan. Every endpoint, MCP server, SDK, and templates.
Plans from $39/mo, starting at $1.80 per domain on annual billing. No credit card required for testing.
View Pricing & Get API Key