Skip to content

Declinaciones ​

Una carta astral es una proyección sobre la eclíptica, y esa proyección descarta un eje. La declinación es lo que queda cuando los mismos cuerpos se miden desde el ecuador celeste — la segunda tabla de una efeméride impresa, y la coordenada que no aparece en ninguna rejilla de aspectos.

En ese eje viven dos cosas, y ninguna es visible en una carta zodiacal:

  • Paralelos y contraparalelos. Dos cuerpos en la misma declinación forman un paralelo, que se comporta como una conjunción. La misma distancia al ecuador en lados opuestos es un contraparalelo, que se comporta como una oposición. Ambos pueden darse entre cuerpos que no forman ningún aspecto en longitud.
  • Fuera de límites (out of bounds). Un cuerpo más allá de la declinación máxima del propio Sol. La Luna lo está unos días al mes en torno a una parada lunar mayor; Mercurio, Venus, Marte y Plutón a intervalos. Es una condición real y muy discutida, y casi ningún software de consumo la informa.

Módulo Requerido

Ambos endpoints requieren el módulo declination:calc. Está incluido en todos los planes y no se vende por separado.

Declinaciones para un momento ​

bash
curl -X POST "https://api.astroapi.cloud/api/calc/declination" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    },
    "orb": 1
  }'

Parámetros ​

ParámetroTipoObligatorioDescripción
dateTimestringSíYYYY-MM-DDTHH:mm, hora local del reloj en location
locationobjectSílatitude, longitude y una timezone IANA
pointsarrayNoPuntos a calcular. Por defecto los diez cuerpos, ambos nodos y ambas Lilith
orbnumberNoOrbe para paralelos y contraparalelos, de 0 a 3 grados. Por defecto 1
moonCenterstringNotopocentric (por defecto) o geocentric

Un orbe aquí no es un orbe allí

Un orbe de declinación es mucho más estrecho que un orbe de longitud. Un grado es la convención y el valor por defecto; más allá de dos grados, casi todo es paralelo a algo.

Respuesta ​

json
{
  "data": {
    "dateTime": "1990-06-15T12:30:00.000Z",
    "points": {
      "sun": {
        "pointId": "sun",
        "declination": 23.32,
        "declinationDms": [23, 19, 12],
        "rightAscension": 84.1,
        "latitude": 0,
        "speedDeclination": 0.04,
        "outOfBounds": false,
        "hemisphere": "north"
      },
      "moon": {
        "pointId": "moon",
        "declination": -18.44,
        "declinationDms": [18, 26, 24],
        "rightAscension": 312.7,
        "latitude": -4.61,
        "speedDeclination": -3.1,
        "outOfBounds": false,
        "hemisphere": "south"
      }
    },
    "aspects": [
      {
        "pointA": "venus",
        "pointB": "mars",
        "aspect": "parallel",
        "orb": 0.31,
        "applying": true,
        "declinationA": 21.08,
        "declinationB": 21.39
      }
    ],
    "extremes": {
      "northernmost": "sun",
      "southernmost": "moon",
      "outOfBoundsCount": 0
    },
    "obliquity": 23.4405
  }
}

declinationDms es la magnitud como [grados, minutos, segundos]; el lado está en hemisphere y en el signo de declination. speedDeclination son grados por día, y negativo significa hacia el sur — es lo que indica si un paralelo se está formando o separando, la misma pregunta que responde applying para un aspecto en longitud.

El límite de fuera de límites ​

obliquity es la oblicuidad verdadera de la eclíptica en la fecha solicitada — la declinación máxima del propio Sol y, por tanto, el límite contra el que se juzgó outOfBounds. Se devuelve para que un cliente pueda dibujar la banda sin inventar su propio límite.

La cifra convencional es 23°26'. La real se mueve: la nutación la desplaza hasta nueve segundos de arco, y eso basta para decidir un caso límite en un sentido u otro. Comparar contra la obliquity devuelta y comparar contra un 23.4367 fijo discrepan sobre un cuerpo situado justo en la línea.

El Sol nunca está fuera de límites

Por definición — la condición es «más allá del Sol». Un cuerpo exactamente en el límite no está fuera de límites; tiene que estar más allá.

Declinación a lo largo de un período ​

La otra mitad, y la razón de que esto sea su propio endpoint en lugar de un campo de una carta natal: un gráfico de declinación es una serie temporal, y las fechas en que un cuerpo cruza el límite de fuera de límites son lo que un astrólogo realmente anota.

bash
curl -X POST "https://api.astroapi.cloud/api/calc/declination/series" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": "2025-01-01",
    "endDate": "2025-12-31",
    "stepDays": 2,
    "points": ["sun", "moon", "mercury", "venus", "mars", "pluto"]
  }'

Parámetros ​

ParámetroTipoObligatorioDescripción
startDatestringSíYYYY-MM-DD o ISO 8601
endDatestringSíYYYY-MM-DD o ISO 8601
stepDaysnumberNoDías entre puntos de la serie, de 0,25 a 30. Por defecto 1
pointsarrayNoPuntos a trazar. Valores por defecto como arriba

Respuesta ​

json
{
  "data": {
    "startDate": "2025-01-01T00:00:00.000Z",
    "endDate": "2025-12-31T23:59:00.000Z",
    "stepDays": 2,
    "points": ["sun", "moon", "mercury", "venus", "mars", "pluto"],
    "series": {
      "moon": [
        ["2025-01-01T00:00:00.000Z", -14.02],
        ["2025-01-03T00:00:00.000Z", 8.71]
      ]
    },
    "crossings": [
      {
        "pointId": "moon",
        "date": "2025-03-06T07:41:12.000Z",
        "direction": "out",
        "declination": 23.4392
      },
      {
        "pointId": "moon",
        "date": "2025-03-10T02:18:55.000Z",
        "direction": "in",
        "declination": 23.4392
      }
    ]
  }
}

Los cruces no se muestrean a stepDays ​

Una salida de la Luna más allá del límite dura un par de días. Una serie trazada con paso semanal pasaría por encima sin verla — por eso los cruces se buscan en una rejilla más fina que aquella a la que se devuelve la serie, y cada uno se refina después contra la efeméride hasta el segundo.

La consecuencia práctica: un stepDays amplio le cuesta la forma de la curva, nunca una fecha de cruce. Pida la resolución que necesite el gráfico y nada más.

El límite de la serie ​

Una serie está limitada a 400 puntos. Un año con paso diario son 365; una década con paso diario son 3653 y vuelve como un 400 con el consejo de ampliar el paso:

json
{
  "error": "That range at a 1-day step is 3654 points; the limit is 400. Widen stepDays or shorten the range."
}

En cualquier caso, esto es una sola petición. Construir la misma tabla con 400 llamadas individuales cuesta 400 peticiones de su cuota mensual; el endpoint de serie las calcula en una sola pasada y cuenta como una.

Declinación en una carta natal ​

Desde la versión de API 2026-09-10, cada punto de una respuesta de carta natal también lleva declination y outOfBounds, de modo que una rueda puede marcar un cuerpo fuera de límites sin una segunda llamada:

bash
curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "X-Api-Version: 2026-09-10" \
  -H "Content-Type: application/json" \
  -d '{ "dateTime": "1990-06-15T14:30", "location": { "latitude": 52.37, "longitude": 4.89, "timezone": "Europe/Amsterdam" } }'

Un cliente en una versión anterior conserva la forma de respuesta que siempre ha recibido. Consulte Versionado de la API para saber cómo fijar una versión.

La respuesta natal lleva solo esos dos campos. Paralelos, contraparalelos, ascensión recta, velocidad de declinación y la serie viven todos en los endpoints anteriores.

Lo que esto no es ​

Aquí no hay vista 3D, y es deliberado. La imagen correcta de la declinación es una línea contra un eje; una esfera celeste lo hace más bonito sin hacerlo más claro.

AstroAPI Documentation