Skip to content

Natal Chart​

POST
/api/calc/natal

Calculate a natal (birth) chart with planetary positions, house cusps, and aspects. By default the Moon is topocentric (parallax-corrected for the birth location); set moonCenter to geocentric for Earth-center Moon positions.

Authorizations​

ApiKeyAuth

API key for authentication. Get your API key from the dashboard.

Type
API Key (header: X-Api-Key)

Request Body​

application/json
JSON
{
  
"dateTime": "string",
  
"location": {
  
  
"longitude": 0,
  
  
"latitude": 0,
  
  
"timezone": "string"
  
},
  
"houseSystem": "placidus",
  
"moonCenter": "topocentric",
  
"language": "en",
  
"includeText": false,
  
"includeReadableEntities": false,
  
"points": [
  
  
"string"
  
],
  
"orbs": {
  
  
"additionalProperties": 0
  
},
  
"include": [
  
  
"string"
  
],
  
"traditional": {
  
  
"sectMethod": "string",
  
  
"horizon": "string",
  
  
"reverseLotsByNight": true,
  
  
"lots": [
  
  
  
"string"
  
  
],
  
  
"bounds": "string",
  
  
"triplicity": "string",
  
  
"antisciaOrb": 0
  
}
}

Responses​

Calculate natal chart

application/vnd.api+json
JSON
{
  
"data": {
  
  
"dateTime": "string",
  
  
"aspects": [
  
  
  
{
  
  
  
  
"pointA": "string",
  
  
  
  
"pointB": "string",
  
  
  
  
"aspect": "string",
  
  
  
  
"angle": 0,
  
  
  
  
"orb": 0,
  
  
  
  
"applying": true,
  
  
  
  
"text": "string"
  
  
  
}
  
  
],
  
  
"points": {
  
  
  
"additionalProperties": {
  
  
  
  
"pointId": "string",
  
  
  
  
"longitude": 0,
  
  
  
  
"speedLongitude": 0,
  
  
  
  
"speedLatitude": 0,
  
  
  
  
"speedDistance": 0,
  
  
  
  
"retrograde": true,
  
  
  
  
"houseId": "string",
  
  
  
  
"houseNumber": 0,
  
  
  
  
"degreesInSign": 0,
  
  
  
  
"degreesInSignDms": [
  
  
  
  
  
0
  
  
  
  
],
  
  
  
  
"sign": "string",
  
  
  
  
"declination": 0,
  
  
  
  
"outOfBounds": true
  
  
  
}
  
  
},
  
  
"angles": {
  
  
  
"additionalProperties": {
  
  
  
  
"pointId": "string",
  
  
  
  
"longitude": 0,
  
  
  
  
"degreesInSign": 0,
  
  
  
  
"degreesInSignDms": [
  
  
  
  
  
0
  
  
  
  
],
  
  
  
  
"sign": "string"
  
  
  
}
  
  
},
  
  
"houses": {
  
  
  
"cusps": [
  
  
  
  
{
  
  
  
  
  
"longitude": 0,
  
  
  
  
  
"longitudeDms": {
  
  
  
  
  
  
"degrees": 0,
  
  
  
  
  
  
"minutes": 0,
  
  
  
  
  
  
"seconds": 0
  
  
  
  
  
},
  
  
  
  
  
"sign": "string"
  
  
  
  
}
  
  
  
],
  
  
  
"ascmc": [
  
  
  
  
{
  
  
  
  
  
"longitude": 0,
  
  
  
  
  
"longitudeDms": {
  
  
  
  
  
  
"degrees": 0,
  
  
  
  
  
  
"minutes": 0,
  
  
  
  
  
  
"seconds": 0
  
  
  
  
  
},
  
  
  
  
  
"sign": "string"
  
  
  
  
}
  
  
  
]
  
  
},
  
  
"chart": {
  
  
  
"url": "string"
  
  
},
  
  
"traditional": {
  
  
  
"sect": {
  
  
  
  
"isDay": true,
  
  
  
  
"sect": "string",
  
  
  
  
"method": "string",
  
  
  
  
"degreesFromBoundary": 0,
  
  
  
  
"sunAltitude": 0,
  
  
  
  
"sectLight": "string",
  
  
  
  
"maleficOfSect": "string",
  
  
  
  
"beneficOfSect": "string",
  
  
  
  
"methodsDisagree": true
  
  
  
},
  
  
  
"lots": [
  
  
  
  
{
  
  
  
  
  
"id": "string",
  
  
  
  
  
"label": "string",
  
  
  
  
  
"longitude": 0,
  
  
  
  
  
"sign": "string",
  
  
  
  
  
"degreesInSign": 0,
  
  
  
  
  
"house": 0,
  
  
  
  
  
"quadrantHouse": 0,
  
  
  
  
  
"ruler": "string",
  
  
  
  
  
"rulerPosition": {
  
  
  
  
  
  
"longitude": 0,
  
  
  
  
  
  
"sign": "string",
  
  
  
  
  
  
"house": 0,
  
  
  
  
  
  
"quadrantHouse": 0,
  
  
  
  
  
  
"signsFromLot": 0
  
  
  
  
  
},
  
  
  
  
  
"formula": "string",
  
  
  
  
  
"reversed": true
  
  
  
  
}
  
  
  
],
  
  
  
"dignities": [
  
  
  
  
{
  
  
  
  
  
"pointId": "string",
  
  
  
  
  
"longitude": 0,
  
  
  
  
  
"sign": "string",
  
  
  
  
  
"essential": {
  
  
  
  
  
  
"dignities": [
  
  
  
  
  
  
  
"string"
  
  
  
  
  
  
],
  
  
  
  
  
  
"debilities": [
  
  
  
  
  
  
  
"string"
  
  
  
  
  
  
],
  
  
  
  
  
  
"score": 0,
  
  
  
  
  
  
"rulers": {
  
  
  
  
  
  
  
"domicile": "string",
  
  
  
  
  
  
  
"exaltation": "string",
  
  
  
  
  
  
  
"triplicity": "string",
  
  
  
  
  
  
  
"bound": "string",
  
  
  
  
  
  
  
"face": "string"
  
  
  
  
  
  
},
  
  
  
  
  
  
"exactExaltation": true
  
  
  
  
  
},
  
  
  
  
  
"accidental": {
  
  
  
  
  
  
"house": 0,
  
  
  
  
  
  
"quadrantHouse": 0,
  
  
  
  
  
  
"angularity": "string",
  
  
  
  
  
  
"quadrantAngularity": "string",
  
  
  
  
  
  
"inJoy": true,
  
  
  
  
  
  
"retrograde": true,
  
  
  
  
  
  
"solarPhase": "string",
  
  
  
  
  
  
"distanceFromSun": 0,
  
  
  
  
  
  
"orientality": "string",
  
  
  
  
  
  
"overcomeBy": [
  
  
  
  
  
  
  
"string"
  
  
  
  
  
  
],
  
  
  
  
  
  
"overcomes": [
  
  
  
  
  
  
  
"string"
  
  
  
  
  
  
],
  
  
  
  
  
  
"enclosure": {
  
  
  
  
  
  
  
"kind": "string",
  
  
  
  
  
  
  
"before": "string",
  
  
  
  
  
  
  
"after": "string"
  
  
  
  
  
  
}
  
  
  
  
  
}
  
  
  
  
}
  
  
  
],
  
  
  
"antiscia": [
  
  
  
  
{
  
  
  
  
  
"pointId": "string",
  
  
  
  
  
"longitude": 0,
  
  
  
  
  
"antiscion": {
  
  
  
  
  
  
"longitude": 0,
  
  
  
  
  
  
"sign": "string",
  
  
  
  
  
  
"degreesInSign": 0,
  
  
  
  
  
  
"house": 0,
  
  
  
  
  
  
"quadrantHouse": 0
  
  
  
  
  
},
  
  
  
  
  
"contraAntiscion": {
  
  
  
  
  
  
"longitude": 0,
  
  
  
  
  
  
"sign": "string",
  
  
  
  
  
  
"degreesInSign": 0,
  
  
  
  
  
  
"house": 0,
  
  
  
  
  
  
"quadrantHouse": 0
  
  
  
  
  
},
  
  
  
  
  
"contacts": [
  
  
  
  
  
  
{
  
  
  
  
  
  
  
"pointId": "string",
  
  
  
  
  
  
  
"kind": "string",
  
  
  
  
  
  
  
"orb": 0
  
  
  
  
  
  
}
  
  
  
  
  
]
  
  
  
  
}
  
  
  
],
  
  
  
"triplicity": {
  
  
  
  
"scheme": "string",
  
  
  
  
"sectLight": {
  
  
  
  
  
"pointId": "string",
  
  
  
  
  
"sign": "string",
  
  
  
  
  
"element": "string",
  
  
  
  
  
"ruler": "string",
  
  
  
  
  
"day": "string",
  
  
  
  
  
"night": "string",
  
  
  
  
  
"participating": "string"
  
  
  
  
}
  
  
  
},
  
  
  
"applied": {
  
  
  
  
"sectMethod": "string",
  
  
  
  
"horizonAltitude": 0,
  
  
  
  
"reverseLotsByNight": true,
  
  
  
  
"lots": [
  
  
  
  
  
"string"
  
  
  
  
],
  
  
  
  
"bounds": "string",
  
  
  
  
"triplicity": "string",
  
  
  
  
"antisciaOrb": 0
  
  
  
}
  
  
}
  
}
}

Playground​

Authorization
Body

Samples​

Powered by VitePress OpenAPI

AstroAPI Documentation