POST /v1/natal
Western tropical natal chart: planets, houses, aspects and patterns. Supports JSON or circular wheel SVG.
Authorization
ApiKeyAuth X-API-Key<token>
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/natal" \ -H "Content-Type: application/json" \ -d '{ "date": "1990-01-15T10:30:00", "lat": 28.6139, "lng": 77.209 }'{ "success": true, "data": { "planets": [ { "planet": "Sun", "tropicalLongitude": 294.7812692151134, "latitude": -0.00008836049781917987, "speed": 1.0182561000279526, "isRetrograde": false, "sign": 9, "signName": "Capricorn", "degreeInSign": 24.78126921511341, "element": "Earth", "modality": "Cardinal", "dignity": "Peregrine" }, { "planet": "Moon", "tropicalLongitude": 163.84523979153187, "latitude": -2.4118781965025513, "speed": 12.579355179917021, "isRetrograde": false, "sign": 5, "signName": "Virgo", "degreeInSign": 13.845239791531867, "element": "Earth", "modality": "Mutable", "dignity": "Peregrine" }, { "planet": "Mercury", "tropicalLongitude": 281.56119066903284, "latitude": 3.378983017415895, "speed": -0.7666188895386178, "isRetrograde": true, "sign": 9, "signName": "Capricorn", "degreeInSign": 11.56119066903284, "element": "Earth", "modality": "Cardinal", "dignity": "Peregrine" }, { "planet": "Venus", "tropicalLongitude": 300.8584296213779, "latitude": 5.340627843819348, "speed": -0.5899969519983308, "isRetrograde": true, "sign": 10, "signName": "Aquarius", "degreeInSign": 0.8584296213779226, "element": "Air", "modality": "Fixed", "dignity": "Peregrine" }, { "planet": "Mars", "tropicalLongitude": 259.7014705108734, "latitude": -0.1886575069472907, "speed": 0.7117720663103958, "isRetrograde": false, "sign": 8, "signName": "Sagittarius", "degreeInSign": 19.701470510873378, "element": "Fire", "modality": "Mutable", "dignity": "Peregrine" }, { "planet": "Jupiter", "tropicalLongitude": 93.40035181392062, "latitude": -0.08342275554394822, "speed": -0.11779723225284712, "isRetrograde": true, "sign": 3, "signName": "Cancer", "degreeInSign": 3.400351813920622, "element": "Water", "modality": "Cardinal", "dignity": "Exaltation" }, { "planet": "Saturn", "tropicalLongitude": 287.2801143362652, "latitude": 0.27717249381151965, "speed": 0.11785416783422642, "isRetrograde": false, "sign": 9, "signName": "Capricorn", "degreeInSign": 17.28011433626523, "element": "Earth", "modality": "Cardinal", "dignity": "Domicile" }, { "planet": "Uranus", "tropicalLongitude": 276.5963681410458, "latitude": -0.27261144310802976, "speed": 0.057881564452579894, "isRetrograde": false, "sign": 9, "signName": "Capricorn", "degreeInSign": 6.596368141045787, "element": "Earth", "modality": "Cardinal", "dignity": "Peregrine" }, { "planet": "Neptune", "tropicalLongitude": 282.5549188742109, "latitude": 0.845763773148218, "speed": 0.03720486135482587, "isRetrograde": false, "sign": 9, "signName": "Capricorn", "degreeInSign": 12.554918874210898, "element": "Earth", "modality": "Cardinal", "dignity": "Peregrine" }, { "planet": "Pluto", "tropicalLongitude": 227.4222043191778, "latitude": 15.376551772340724, "speed": 0.020479166343023717, "isRetrograde": false, "sign": 7, "signName": "Scorpio", "degreeInSign": 17.42220431917781, "element": "Water", "modality": "Fixed", "dignity": "Domicile" }, { "planet": "Chiron", "tropicalLongitude": 102.87919841919307, "latitude": -7.30758220080813, "speed": -0.06676052098173575, "isRetrograde": true, "sign": 3, "signName": "Cancer", "degreeInSign": 12.879198419193074, "element": "Water", "modality": "Cardinal", "dignity": "Peregrine" }, { "planet": "NorthNode", "tropicalLongitude": 316.57090075761585, "latitude": 0, "speed": 0.02710413251670063, "isRetrograde": false, "sign": 10, "signName": "Aquarius", "degreeInSign": 16.570900757615846, "element": "Air", "modality": "Fixed", "dignity": "Peregrine" }, { "planet": "SouthNode", "tropicalLongitude": 136.57090075761585, "latitude": 0, "speed": 0.02710413251670063, "isRetrograde": false, "sign": 4, "signName": "Leo", "degreeInSign": 16.570900757615846, "element": "Fire", "modality": "Fixed", "dignity": "Peregrine" } ], "houses": { "houses": [ { "number": 1, "sign": 11, "signName": "Pisces", "cuspDegree": 355.1494760535659, "planetsInHouse": [], "rulerPlanet": "Neptune" }, { "number": 2, "sign": 1, "signName": "Taurus", "cuspDegree": 33.54039793298432, "planetsInHouse": [], "rulerPlanet": "Venus" }, { "number": 3, "sign": 2, "signName": "Gemini", "cuspDegree": 62.62761433506711, "planetsInHouse": [], "rulerPlanet": "Mercury" }, { "number": 4, "sign": 2, "signName": "Gemini", "cuspDegree": 86.88028285082646, "planetsInHouse": [ "Jupiter", "Chiron" ], "rulerPlanet": "Mercury" }, { "number": 5, "sign": 3, "signName": "Cancer", "cuspDegree": 110.70372692397285, "planetsInHouse": [ "SouthNode" ], "rulerPlanet": "Moon" }, { "number": 6, "sign": 4, "signName": "Leo", "cuspDegree": 138.44302656070698, "planetsInHouse": [ "Moon" ], "rulerPlanet": "Sun" }, { "number": 7, "sign": 5, "signName": "Virgo", "cuspDegree": 175.14947605356588, "planetsInHouse": [], "rulerPlanet": "Mercury" }, { "number": 8, "sign": 7, "signName": "Scorpio", "cuspDegree": 213.54039793298432, "planetsInHouse": [ "Pluto" ], "rulerPlanet": "Pluto" }, { "number": 9, "sign": 8, "signName": "Sagittarius", "cuspDegree": 242.62761433506716, "planetsInHouse": [ "Mars" ], "rulerPlanet": "Jupiter" }, { "number": 10, "sign": 8, "signName": "Sagittarius", "cuspDegree": 266.88028285082646, "planetsInHouse": [ "Mercury", "Saturn", "Uranus", "Neptune" ], "rulerPlanet": "Jupiter" }, { "number": 11, "sign": 9, "signName": "Capricorn", "cuspDegree": 290.7037269239729, "planetsInHouse": [ "Sun", "Venus", "NorthNode" ], "rulerPlanet": "Saturn" }, { "number": 12, "sign": 10, "signName": "Aquarius", "cuspDegree": 318.44302656070704, "planetsInHouse": [], "rulerPlanet": "Uranus" } ], "ascendant": 355.1494760535658, "midheaven": 266.88028285082646 }, "aspects": [ { "planet1": "Sun", "planet2": "Venus", "type": "Conjunction", "angle": 6.077160406264511, "orb": 6.077160406264511, "applying": true, "nature": "neutral", "isMajor": true }, { "planet1": "Sun", "planet2": "Saturn", "type": "Conjunction", "angle": 7.501154878848183, "orb": 7.501154878848183, "applying": false, "nature": "neutral", "isMajor": true }, { "planet1": "Moon", "planet2": "Mercury", "type": "Trine", "angle": 117.71595087750097, "orb": 2.2840491224990274, "applying": false, "nature": "harmonic", "isMajor": true }, { "planet1": "Moon", "planet2": "Mars", "type": "Square", "angle": 95.85623071934151, "orb": 5.856230719341511, "applying": false, "nature": "tense", "isMajor": true }, { "planet1": "Moon", "planet2": "Saturn", "type": "Trine", "angle": 123.43487454473336, "orb": 3.4348745447333613, "applying": false, "nature": "harmonic", "isMajor": true }, { "planet1": "Moon", "planet2": "Uranus", "type": "Trine", "angle": 112.75112834951392, "orb": 7.24887165048608, "applying": false, "nature": "harmonic", "isMajor": true }, { "planet1": "Moon", "planet2": "Neptune", "type": "Trine", "angle": 118.70967908267903, "orb": 1.2903209173209689, "applying": false, "nature": "harmonic", "isMajor": true }, { "planet1": "Moon", "planet2": "Pluto", "type": "Sextile", "angle": 63.57696452764594, "orb": 3.5769645276459414, "applying": false, "nature": "harmonic", "isMajor": true }, { "planet1": "Moon", "planet2": "Chiron", "type": "Sextile", "angle": 60.96604137233879, "orb": 0.9660413723387933, "applying": false, "nature": "harmonic", "isMajor": true }, { "planet1": "Mercury", "planet2": "Saturn", "type": "Conjunction", "angle": 5.718923667232389, "orb": 5.718923667232389, "applying": false, "nature": "neutral", "isMajor": true }, { "planet1": "Mercury", "planet2": "Uranus", "type": "Conjunction", "angle": 4.964822527987053, "orb": 4.964822527987053, "applying": true, "nature": "neutral", "isMajor": true }, { "planet1": "Mercury", "planet2": "Neptune", "type": "Conjunction", "angle": 0.9937282051780585, "orb": 0.9937282051780585, "applying": false, "nature": "neutral", "isMajor": true }, { "planet1": "Mercury", "planet2": "Pluto", "type": "Sextile", "angle": 54.13898634985503, "orb": 5.861013650144969, "applying": false, "nature": "harmonic", "isMajor": true }, { "planet1": "Mercury", "planet2": "Chiron", "type": "Opposition", "angle": 178.68199224983977, "orb": 1.318007750160234, "applying": false, "nature": "tense", "isMajor": true }, { "planet1": "Mars", "planet2": "NorthNode", "type": "Sextile", "angle": 56.86943024674247, "orb": 3.1305697532575323, "applying": false, "nature": "harmonic", "isMajor": true }, { "planet1": "Mars", "planet2": "SouthNode", "type": "Trine", "angle": 123.13056975325753, "orb": 3.1305697532575323, "applying": false, "nature": "harmonic", "isMajor": true }, { "planet1": "Jupiter", "planet2": "Uranus", "type": "Opposition", "angle": 176.80398367287484, "orb": 3.1960163271251645, "applying": false, "nature": "tense", "isMajor": true }, { "planet1": "Saturn", "planet2": "Neptune", "type": "Conjunction", "angle": 4.72519546205433, "orb": 4.72519546205433, "applying": false, "nature": "neutral", "isMajor": true }, { "planet1": "Saturn", "planet2": "Pluto", "type": "Sextile", "angle": 59.85791001708742, "orb": 0.14208998291258013, "applying": true, "nature": "harmonic", "isMajor": true }, { "planet1": "Saturn", "planet2": "Chiron", "type": "Opposition", "angle": 175.59908408292785, "orb": 4.400915917072155, "applying": false, "nature": "tense", "isMajor": true }, { "planet1": "Uranus", "planet2": "Neptune", "type": "Conjunction", "angle": 5.9585507331651115, "orb": 5.9585507331651115, "applying": true, "nature": "neutral", "isMajor": true }, { "planet1": "Uranus", "planet2": "Chiron", "type": "Opposition", "angle": 173.7171697218527, "orb": 6.282830278147287, "applying": true, "nature": "tense", "isMajor": true }, { "planet1": "Neptune", "planet2": "Pluto", "type": "Sextile", "angle": 55.13271455503309, "orb": 4.86728544496691, "applying": true, "nature": "harmonic", "isMajor": true }, { "planet1": "Neptune", "planet2": "Chiron", "type": "Opposition", "angle": 179.67572045501782, "orb": 0.3242795449821756, "applying": true, "nature": "tense", "isMajor": true }, { "planet1": "Pluto", "planet2": "Chiron", "type": "Trine", "angle": 124.54300589998473, "orb": 4.543005899984735, "applying": false, "nature": "harmonic", "isMajor": true }, { "planet1": "Pluto", "planet2": "NorthNode", "type": "Square", "angle": 89.14869643843804, "orb": 0.8513035615619629, "applying": true, "nature": "tense", "isMajor": true }, { "planet1": "Pluto", "planet2": "SouthNode", "type": "Square", "angle": 90.85130356156196, "orb": 0.8513035615619629, "applying": true, "nature": "tense", "isMajor": true }, { "planet1": "NorthNode", "planet2": "SouthNode", "type": "Opposition", "angle": 180, "orb": 0, "applying": false, "nature": "tense", "isMajor": true } ], "patterns": [ { "type": "T-Square", "description": "High tension and drive focused on Pluto (Apex), challenged by NorthNode opposing SouthNode", "planets": [ "NorthNode", "Pluto", "SouthNode" ] }, { "type": "Stellium", "description": "A heavy concentration of energy in Capricorn: Sun, Mercury, Saturn, Uranus, Neptune", "planets": [ "Mercury", "Neptune", "Saturn", "Sun", "Uranus" ] } ] }}GET /v1/moon-phase/calendar
Lunar calendar for a date range: every New Moon, First Quarter, Full Moon and Last Quarter with exact UTC moments, plus the phase at range start and the next principal phase.
POST /v1/western
Full tropical chart: planets, aspects, patterns and houses. Supports JSON or circular wheel SVG.