Cartas Natales

Calcula cartas natales completas con posiciones planetarias, cúspides de casas y aspectos.

Cálculo Básico

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
dateTime	string	Sí	Fecha y hora en formato YYYY-MM-DDTHH:mm
location.latitude	number	Sí	Latitud (-90 a 90)
location.longitude	number	Sí	Longitud (-180 a 180)
location.timezone	string	Sí	Identificador de zona horaria IANA
houseSystem	string	No	Sistema de casas (por defecto: "placidus")
points	array	No	Puntos celestes a calcular (ver Puntos Disponibles más abajo)
orbs	object	No	Valores de orbe personalizados por tipo de aspecto (ej., { "conjunction": 8, "opposition": 6 })
language	string	No	Código de idioma para contenido textual (por defecto: "en")
includeText	boolean	No	Incluir texto de interpretación (por defecto: false)
includeReadableEntities	boolean	No	Incluir títulos legibles de entidades (por defecto: false)

Sistemas de Casas

• placidus — Placidus (por defecto)
• koch — Koch
• equal — Casas Iguales
• whole — Signo Completo
• campanus — Campanus
• regiomontanus — Regiomontanus
• porphyry — Porphyry

Respuesta

{
  "data": {
    "dateTime": "1990-06-15T12:30:00.000Z",
    "points": {
      "sun": {
        "pointId": "sun",
        "longitude": 84.5,
        "sign": "gemini",
        "signTitle": "Gemini",
        "degreesInSign": 24.5,
        "degreesInSignDms": [24, 30, 0],
        "houseNumber": 10,
        "houseId": "house-10",
        "retrograde": false,
        "pointTitle": "Sun",
        "houseTitle": "10th House"
      },
      "moon": {
        "pointId": "moon",
        "longitude": 245.2,
        "sign": "sagittarius",
        "signTitle": "Sagittarius",
        "degreesInSign": 5.2,
        "degreesInSignDms": [5, 12, 0],
        "houseNumber": 4,
        "houseId": "house-4",
        "retrograde": false,
        "pointTitle": "Moon",
        "houseTitle": "4th House"
      }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": { "pointId": "descendant", "longitude": 0.5, "sign": "aries", ... },
      "midheaven": { "pointId": "midheaven", "longitude": 270.2, "sign": "capricorn", ... },
      "imumCoeli": { "pointId": "imumCoeli", "longitude": 90.2, "sign": "cancer", ... }
    },
    "houses": {
      "cusps": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 210.3, "longitudeDms": { "degrees": 210, "minutes": 18, "seconds": 0 }, "sign": "scorpio" }
      ],
      "ascmc": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 270.2, "longitudeDms": { "degrees": 270, "minutes": 12, "seconds": 0 }, "sign": "capricorn" }
      ]
    },
    "aspects": [
      {
        "pointA": "sun",
        "pointB": "moon",
        "aspect": "opposition",
        "angle": 160.7,
        "orb": 0.7,
        "applying": false,
        "pointATitle": "Sun",
        "pointBTitle": "Moon",
        "aspectTitle": "Opposition"
      }
    ],
    "chart": {
      "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..."
    }
  }
}

Cúspides de Casas

Cada objeto de cúspide incluye longitude (grados eclípticos), longitudeDms (grados/minutos/segundos) y sign (ID del signo zodiacal). La primera cúspide (cusps[0]) es el Ascendente. El array ascmc contiene el Ascendente, MC, ARMC y Vértex.

Puntos Disponibles

Usa el parámetro points para seleccionar qué puntos celestes calcular. Si se omite, se utiliza el conjunto predeterminado.

Puntos Predeterminados

sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, meanNode, trueNode, meanApogee, osculatingApog

Todos los Puntos Disponibles

Point ID	Descripción
sun	Sol
moon	Luna
mercury	Mercurio
venus	Venus
mars	Marte
jupiter	Júpiter
saturn	Saturno
uranus	Urano
neptune	Neptuno
pluto	Plutón
meanNode	Nodo Norte Medio
trueNode	Nodo Norte Verdadero
meanApogee	Lilith Media (Luna Negra)
osculatingApog	Lilith Verdadera (Luna Negra)
chiron	Quirón
pholus	Folo
ceres	Ceres
pallas	Palas
juno	Juno
vesta	Vesta
interpolatedLunarApogee	Apogeo Lunar Interpolado
interpolatedLunarPerigee	Perigeo Lunar Interpolado (Priapo)
earth	Tierra

Ejemplo: Calcular Solo Sol y Marte

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "points": ["sun", "mars"]
  }'

La respuesta tendrá sun y mars en el objeto points, y los cuatro ángulos en el objeto angles:

{
  "data": {
    "points": {
      "sun": { "pointId": "sun", "longitude": 84.5, "sign": "gemini", ... },
      "mars": { "pointId": "mars", "longitude": 12.3, "sign": "aries", ... }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": { "pointId": "descendant", "longitude": 0.5, "sign": "aries", ... },
      "midheaven": { "pointId": "midheaven", "longitude": 270.2, "sign": "capricorn", ... },
      "imumCoeli": { "pointId": "imumCoeli", "longitude": 90.2, "sign": "cancer", ... }
    },
    "houses": { ... },
    "aspects": [ ... ]
  }
}

Ángulos

Los cuatro ángulos (ascendant, descendant, midheaven, imumCoeli) siempre se incluyen en el objeto angles, independientemente del parámetro points. Los ángulos se derivan de los cálculos de casas, no de la efeméride, por lo que tienen una estructura más simple (sin datos de velocidad o retrogradación). El array ascmc en la respuesta de houses también siempre contiene las longitudes brutas de los ángulos.

Luna y Sol

Calcula la fase lunar, la iluminación, los horarios de salida/puesta y los datos de posición del Sol.

POST /api/calc/moon-sun

curl -X POST "https://api.astroapi.cloud/api/calc/moon-sun" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "2024-06-15T12:00",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    }
  }'

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
dateTime	string	Sí	Fecha y hora en formato YYYY-MM-DDTHH:mm
location.latitude	number	Sí	Latitud (-90 a 90)
location.longitude	number	Sí	Longitud (-180 a 180)
location.timezone	string	Sí	Identificador de zona horaria IANA

Módulo Requerido

Este endpoint requiere el módulo module:moon.

Respuesta

{
  "data": {
    "moon": {
      "phaseName": "Waxing Gibbous",
      "phase": 0.62,
      "illumination": 0.78,
      "age": 9.2,
      "distance": 384400,
      "diameterDegrees": 0.52,
      "rise": "2024-06-15T14:23:00Z",
      "set": "2024-06-16T02:15:00Z"
    },
    "sun": {
      "rise": "2024-06-15T05:18:00Z",
      "set": "2024-06-15T22:03:00Z",
      "transit": "2024-06-15T13:40:00Z",
      "distance": 151820000,
      "diameterDegrees": 0.524,
      "twilight": {
        "civil": {
          "begin": "2024-06-15T04:38:00Z",
          "end": "2024-06-15T22:43:00Z"
        },
        "nautical": {
          "begin": "2024-06-15T03:32:00Z",
          "end": "2024-06-15T23:49:00Z"
        },
        "astronomical": {
          "begin": null,
          "end": null
        }
      }
    }
  }
}

Precisión de Cálculo

AstroAPI lee directamente la efeméride JPL DE442 de la NASA para posiciones planetarias con precisión de sub-milisegundo de arco. Consulta la página Precisión de Cálculo para todos los detalles sobre nuestras fuentes de datos y correcciones.