post

/api/v1/chart/natal

Calculate a natal chart

Overview

Calculate a complete natal birth chart including positions, houses, aspects, element/modality balance, and chart ruler.

Request Body

birthDate string required
Birth date in YYYY-MM-DD format
birthTime string
Birth time in HH:MM format (24h). If omitted, houses are unavailable.
latitude number required
Birth location latitude
longitude number required
Birth location longitude
houseSystem string
House system
Enum:
PlacidusKochEqualWholeCampanusRegiomontanusMorinusPorphyryAlcabitiusTopocentricMeridianVehlowEqualNaturalGraduationSripati
orbProfile string
Named orb profile to use. Determines base orbs for each aspect type and planet modifiers. Options: modern-western (generous), traditional (moderate), vedic (tight, no planet modifiers), tight (very tight, research-grade).
Enum:
modern-westerntraditionalvedictight

Response

200 — Complete natal chart

birthDate string required
birthTime string
latitude number required
longitude number required
houseSystem string required
Enum:
PlacidusKochEqualWholeCampanusRegiomontanusMorinusPorphyryAlcabitiusTopocentricMeridianVehlowEqualNaturalGraduationSripati
positions array required

array of object

body string required
Enum:
SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex
position object required
longitude number required
Ecliptic longitude in degrees (0-360)
sign string required
Zodiac sign
Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
degree number required
Degree within the sign (0-30)
minute number required
Arc minutes within the degree
isRetrograde boolean required
Whether the body appears to be moving backward
houses array

array of object

house number required
House number (1-12)
cusp object required
longitude number required
Ecliptic longitude in degrees (0-360)
sign string required
Zodiac sign
Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
degree number required
Degree within the sign (0-30)
minute number required
Arc minutes within the degree
isRetrograde boolean required
Whether the body appears to be moving backward
housesAvailable boolean required
ascendant number
ascendantSign string
Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
midheaven number
midheavenSign string
Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
aspects array required

array of object

body1 string required
Enum:
SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex
body2 string required
Enum:
SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex
type string required
Enum:
conjunctionsextilesquaretrineoppositionquincunxsemiSextilesemiSquaresesquiquadratequintilebiquintile
orb number required
The difference from exact aspect in degrees
isApplying boolean required
Whether the aspect is applying (getting closer) or separating
elementBalance object required
fire number required
earth number required
air number required
water number required
dominant string required
modalityBalance object required
cardinal number required
fixed number required
mutable number required
dominant string required
chartRuler object
planet string required
sign string required
longitude number required
isRetrograde boolean required
partOfFortune object
longitude number required
sign string required
degree number required
dignities array

array of object

body string required
sign string required
dignity string required
score number required
combustionStatuses array

array of object

body string required
status string required
Enum:
cazimicombustunderTheBeamsfree
mutualReceptions array

array of object

body1 string required
body2 string required
sign1 string required
sign2 string required
type string required
Enum:
domicileexaltationmixed
outOfBoundsPlanets array

array of object

body string required
declination number required
decanInfo array

array of object

body string required
decan number required
faceRuler string required
speedClassifications array

array of object

body string required
dailyMotion number required
classification string required
Enum:
fastaverageslowretrograde
besiegedPlanets array

array of object

body string required
isBesieged boolean required
besiegingMalefics array

array of string

Example Request

cURL
curl "https://api.almuten.io/api/v1/chart/natal" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{}'

Example Response

JSON
{
  "birthDate": "",
  "birthTime": "",
  "latitude": 0,
  "longitude": 0,
  "houseSystem": "Placidus",
  "positions": [
    {
      "body": "Sun",
      "position": {
        "longitude": 245.5,
        "sign": "Sagittarius",
        "degree": 5,
        "minute": 30,
        "isRetrograde": false
      }
    }
  ],
  "houses": [
    {
      "house": 1,
      "cusp": {
        "longitude": 245.5,
        "sign": "Sagittarius",
        "degree": 5,
        "minute": 30,
        "isRetrograde": false
      }
    }
  ],
  "housesAvailable": true,
  "ascendant": 0,
  "ascendantSign": "Aries",
  "midheaven": 0,
  "midheavenSign": "Aries",
  "aspects": [
    {
      "body1": "Sun",
      "body2": "Moon",
      "type": "trine",
      "orb": 2.5,
      "isApplying": true
    }
  ],
  "elementBalance": {
    "fire": 0,
    "earth": 0,
    "air": 0,
    "water": 0,
    "dominant": ""
  },
  "modalityBalance": {
    "cardinal": 0,
    "fixed": 0,
    "mutable": 0,
    "dominant": ""
  },
  "chartRuler": {
    "planet": "",
    "sign": "",
    "longitude": 0,
    "isRetrograde": true
  },
  "partOfFortune": {
    "longitude": 0,
    "sign": "",
    "degree": 0
  },
  "dignities": [
    {
      "body": "",
      "sign": "",
      "dignity": "",
      "score": 0
    }
  ],
  "combustionStatuses": [
    {
      "body": "",
      "status": "cazimi"
    }
  ],
  "mutualReceptions": [
    {
      "body1": "",
      "body2": "",
      "sign1": "",
      "sign2": "",
      "type": "domicile"
    }
  ],
  "outOfBoundsPlanets": [
    {
      "body": "",
      "declination": 0
    }
  ],
  "decanInfo": [
    {
      "body": "",
      "decan": 1,
      "faceRuler": ""
    }
  ],
  "speedClassifications": [
    {
      "body": "",
      "dailyMotion": 0,
      "classification": "fast"
    }
  ],
  "besiegedPlanets": [
    {
      "body": "",
      "isBesieged": true,
      "besiegingMalefics": [
        ""
      ]
    }
  ]
}