POST/api/astro/house_hora/1 crédito

Relaciones entre casas

La estructura de relaciones de una carta natal: qué signos aspectan a cuáles, qué planetas aspectan a cuáles, quién es amigo de quién y qué planetas señalan los textos clásicos como decisivos para los puntos de inflexión de una carta. Es buena parte del mecanismo con el que se juzga una carta en los sistemas de Jaimini y parashari, disponible pieza a pieza. Hay tres grupos. Las claves de tipos de casas (`trikonas`, `kendras`, `quadrants`, `dushthanas`, `chathusras`, `upachayas`) son pura geometría: doce filas, una por signo, con números de signo del 1 al 12, que no dependen de la carta. Las claves de aspectos y relaciones (`raasi_drishti_of_the_planet`, las tres claves `aspected_*_of_the_planet`, las dos claves `*_of_the_raasi`, `argala`, `associations_of_the_planet`, las tres claves de amistad natural y `baadhakas_of_raasi`) describen cómo se relacionan entre sí los cuerpos de la carta. Las claves de Jaimini (`chara_karakas`, `marakas`, `brahma`, `rudra`, `maheshwara`, `trishoola_rasis`, `order_of_planets_by_strength`) indican los planetas que importan para la longevidad y para fechar los grandes acontecimientos. Los planetas se devuelven siempre como índices: 0 Sol, 1 Luna, 2 Marte, 3 Mercurio, 4 Júpiter, 5 Venus, 6 Saturno, 7 Rahu, 8 Ketu. Los signos tienen base cero (de 0 Aries a 11 Piscis) en las claves de aspectos y de Jaimini, pero base uno (del 1 al 12) en las claves de tipos de casas, así que comprueba cuál estás leyendo. El campo `planet` de la solicitud va con inicial mayúscula y distingue mayúsculas y minúsculas ('Sun', no 'sun'), y `raasi` es un entero con base cero sin comprobación de límites, así que un valor fuera de 0–11 hace fallar la solicitud.

https://api.occultapi.com/api/astro/house_hora/

Probar solicitud

Autenticación

Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Campos de la solicitud

Campo	Tipo	Obligatorio	Notas
date_time	string (date-time)	obligatorio	El momento del cálculo, en ISO 8601. Incluye SIEMPRE la diferencia con UTC o una Z final: un valor sin zona horaria se interpreta como Asia/Kolkata (UTC+05:30), no como UTC, y puede devolver con un 200 el resultado del día anterior. '2026-09-01T06:00:00Z' y '2026-09-01 06:00:00' son instantes distintos y dan respuestas distintas. Restricción de FORMATO. DRF DateTimeField: solo ISO-8601 (formatos de entrada por defecto de DRF), p. ej., "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" o "2026-09-01 06:00:00" (sin zona horaria = se toma como UTC).
keys	array	obligatorio	Los cálculos que quieres recibir, como lista de nombres. Consulta la tabla de claves de este endpoint; un nombre que no se reconoce invalida toda la solicitud. Cada llamada cuesta un crédito, pidas las claves que pidas, así que pide todo lo que necesites de una vez en lugar de hacer varias llamadas. `trikonasdushthanaschathusrasquadrantskendrasupachayaschara_karakasraasi_drishti_of_the_planetaspected_planets_of_the_planetaspected_rasis_of_the_planetaspected_houses_of_the_planetaspected_houses_of_the_raasi` Array de cadenas. Las claves que terminan en '_of_the_planet', además de 'associations_of_the_planet', requieren `planet`; las claves que terminan en '_of_the_raasi', además de 'baadhakas_of_raasi', requieren `raasi`.
latitude	number (double)	obligatorio	Latitud del lugar, en grados decimales. Los valores positivos indican el norte y los negativos, el sur. Ejemplo: 26.9124 para Jaipur, 40.7128 para Nueva York. No se aceptan minutos ni segundos: conviértelos antes. min -90 · max 90
longitude	number (double)	obligatorio	Longitud del lugar, en grados decimales. Los valores positivos indican el este y los negativos, el oeste. Ejemplo: 75.7873 para Jaipur, -74.0060 para Nueva York. Cuidado con el signo: si falta el menos, Nueva York acaba en China. min -180 · max 180
node	string	obligatorio	`truemean` En minúsculas; distingue mayúsculas y minúsculas. 'true' usa los nodos lunares verdaderos y 'mean', los nodos medios. Cualquier otro valor produce un KeyError -> 400. Se reenvía.
planet	string	obligatorio	`SunMoonMarsMercuryJupiterVenusSaturnRahuKetu` DISTINGUE mayúsculas y minúsculas, con inicial mayúscula: ojo, no es igual que los nombres celestes en minúsculas que usa /api/astro/chart_analysis/.
raasi	integer	obligatorio	`01234567891011` Un entero, no una cadena. Se usa como índice de signo con BASE 0: 0 = Aries... 11 = Piscis. No hay comprobación de límites, así que los valores fuera de rango lanzan IndexError -> 400 y los negativos se cuentan desde el final sin aviso.
timezone_as_float	number (double)	obligatorio	Diferencia horaria del lugar con UTC, en horas y con decimales. Ejemplo: 5.5 para la India (UTC+05:30), -5 para Nueva York en invierno, 5.75 para Nepal. NO se contrasta con date_time: si los dos no coinciden, recibes una respuesta correcta para un momento equivocado, así que toma ambos valores de la misma fuente. Usa la diferencia vigente en esa fecha, no la de hoy: para un nacimiento en verano en un país con horario de verano, hace falta la diferencia de verano. min -12 · max 14

Claves disponibles (29)

Indica en keys exactamente los cálculos que quieres. Si una clave no existe, se rechaza toda la solicitud. Pidas las que pidas, se cobra 1 crédito, así que agrúpalas en una sola llamada.

Clave	Campos adicionales	Descripción
argala	—	Argala y virodhargala de toda la carta, como lista de dos elementos. El primero es el argala, la intervención que ejerce una casa: doce filas, una por casa a partir del ascendente, cada una con cuatro cadenas para la 2.ª, 4.ª, 5.ª y 11.ª desde esa casa, con los índices de los planetas que la ocupan unidos por '/' y una cadena vacía si no hay ninguno. El segundo es el virodhargala, lo que obstruye esa intervención, con la misma estructura para la 12.ª, 10.ª, 9.ª y 3.ª, tomadas en ese orden para que las columnas se correspondan con las del argala.
aspected_houses_of_the_planet	planet	Los mismos aspectos de graha drishti que `aspected_rasis_of_the_planet`, pero expresados como números de casa contados desde el ascendente, del 1 al 12, en lugar de como índices de signo. Requiere `planet`.
aspected_houses_of_the_raasi	raasi	Las casas, del 1 al 12 contadas desde el ascendente, que el signo dado aspecta bajo rasi drishti: todas, las ocupe o no un planeta. Requiere `raasi` como índice de signo con base cero.
aspected_planets_of_the_planet	planet	Los planetas que el planeta dado aspecta bajo graha drishti (el aspecto planetario parashari, en el que todo planeta ve la 7.ª casa y Marte, Júpiter y Saturno tienen sus aspectos adicionales). Devuelve una lista de índices de planetas. Requiere `planet`.
aspected_raasis_of_the_raasi	raasi	La misma relación de rasi drishti que `aspected_houses_of_the_raasi`, devuelta como índices de signo con base cero en lugar de números de casa, así que no depende en absoluto del ascendente. Requiere `raasi`.
aspected_rasis_of_the_planet	planet	Los signos que el planeta dado aspecta bajo graha drishti, como lista de índices de signo con base cero, de 0 para Aries a 11 para Piscis. Es la forma por signos de `aspected_houses_of_the_planet`. Requiere `planet`.
associations_of_the_planet	planet	Todos los planetas con los que el planeta dado tiene un vínculo significativo por cualquiera de las tres vías clásicas: compartir signo con él, aspectarlo bajo graha drishti o estar en un intercambio de signos parivartana con él. Devuelve una lista de índices de planetas sin duplicados. Requiere `planet`.
baadhakas_of_raasi	raasi	La casa baadhaka, u obstructora, para un signo ascendente dado y los planetas que la rigen: la 11.ª para los signos móviles, la 9.ª para los fijos y la 7.ª para los duales. Devuelve una lista de dos elementos: [el signo baadhaka con base cero, una lista de los índices de los planetas que lo rigen]. Requiere `raasi`.
brahma	—	Brahma, el planeta que Jaimini asocia con el sostenimiento de la vida. Es el más fuerte de los señores de las casas 6, 8 y 12 contadas desde el ascendente o desde la séptima casa (la que sea más fuerte), sin contar a Rahu y Ketu; los empates se deshacen por dignidad, por estar en signo impar y por la posición dentro de la mitad. Devuelve un único índice de planeta.
chara_karakas	—	Los ocho chara karakas, como lista de ocho índices de planetas ordenados de mayor a menor grado dentro de su signo. La primera entrada es el Atmakaraka y el resto sigue el orden habitual (Amatya, Bhratri, Matri, Pitri, Putra, Gnati, Dara). Ketu queda fuera, y Rahu se ordena según su longitud invertida, como exige la regla clásica.
chathusras	—	Doce filas de dos números de signo 1–12. Tal como está implementado, cada fila da el 3.º y el 5.º desde el signo (la fila 1 es [3, 5]) en lugar del 4.º y el 8.º que nombra el par clásico chatusra.
dushthanas	—	Doce filas de tres números de signo 1–12. Tal como está implementado, cada fila da el propio signo, el 3.º desde él y el 7.º desde él (la fila 1 es [1, 3, 7]), que no es el conjunto clásico de dusthanas 6.º/8.º/12.º; así que tómalo como lo que calcula el código, no como los dusthanas de los manuales.
kendras	—	Los cuadrantes de cada signo: doce filas, una por signo, cada una con una lista de cuatro números de signo del 1 al 12. La fila 0 es Aries. No recibe argumentos. Su estructura no es la misma que la de la clave `kendras` de /api/astro/strength/, que recibe un `asc_house` y devuelve una única lista plana de cuatro índices con base CERO: mezclar las dos numeraciones, que se diferencian en uno, es el error que hay que evitar.
maheshwara	—	El mismo valor que `maheshwara_from_planet_positions`: esta clave la llama directamente y devuelve el mismo índice de planeta. Pide una u otra.
maheshwara_from_planet_positions	—	Maheshwara, el planeta que Jaimini asocia con la forma de la muerte: el señor del octavo signo desde el Atmakaraka, con las sustituciones clásicas cuando ese señor está en su propio signo o en conjunción u oposición con un nodo. Devuelve un único índice de planeta; si el resultado fuera Rahu o Ketu, se sustituye por Mercurio o Júpiter, respectivamente.
marakas	—	Los mismos planetas maraka que `marakas_from_planet_positions`, pero calculados a partir de la carta en forma casa-planeta. El resultado es la misma lista de índices de planetas, así que pide una de las dos claves, no ambas.
marakas_from_planet_positions	—	Los planetas maraka, o causantes de muerte: los señores de las casas 2 y 7, junto con cualquier planeta situado en alguna de esas casas o junto a alguno de esos señores. Devuelve una lista de índices de planetas sin un orden concreto. Se calcula a partir de la carta en forma de posiciones planetarias.
natural_enemies_of_planets	—	La tabla estándar de enemistad, como lista de nueve listas indexadas por planeta 0–8, cada una con los planetas hostiles a ese planeta. Es fija e independiente de la carta, y complementa a `natural_neutral_of_planets`.
natural_friends_of_planets	—	Amistad planetaria permanente, calculada a partir de las regencias de signos de esta carta: un objeto indexado por índice de planeta 0–8, cada uno con una lista de los índices de sus planetas amigos. En los siete planetas clásicos, el señor del signo de exaltación se incluye junto con los señores de los signos amigos.
natural_neutral_of_planets	—	La tabla estándar de neutralidad, como lista de nueve listas indexadas por planeta 0–8, cada una con los planetas neutrales respecto a ese planeta. A diferencia de `natural_friends_of_planets`, es la tabla clásica fija y no depende en absoluto de la carta.
order_of_planets_by_strength	—	Los nueve planetas ordenados del más fuerte al más débil, como lista de nueve índices de planetas. El orden sale de la comparación de fortaleza por pares del motor, la misma que se usa para elegir entre los señores candidatos en los cálculos de Rudra y Maheshwara.
planets_aspecting_the_planet	planet	Debería devolver los planetas que proyectan graha drishti sobre el planeta dado, como lista de índices de planetas. Tal como está, compara el nombre del planeta (con inicial mayúscula) con listas de índices de planetas, así que devuelve una lista vacía para cualquier valor; en su lugar, consulta `aspected_planets_of_the_planet` para cada planeta e invierte el resultado.
quadrants	—	Los ángulos de cada signo: doce filas, cada una con cuatro números de signo 1–12: el propio signo y el 4.º, 7.º y 10.º desde él. La fila 1 es [1, 4, 7, 10]. En este endpoint es un alias de `kendras`: siempre coinciden, así que pedir los dos solo ocupa sitio en la respuesta.
raasi_drishti_of_the_planet	planet	Los planetas situados en los signos que el propio signo del planeta dado aspecta bajo rasi drishti (el aspecto de signo a signo de Jaimini, en el que los signos móviles ven a los fijos y viceversa, y los signos duales se ven entre sí). Devuelve una lista de índices de planetas. Requiere `planet`.
rudra	—	Rudra, como el más fuerte entre el señor de la octava casa desde el ascendente y el señor de la octava casa desde la séptima. Devuelve [índice de planeta, el signo con base cero que ocupa, los tres signos de trígono con base cero de ese signo]. Ten en cuenta que no coincide con `rudra_based_on_planet_positions`, que calcula el segundo señor de otra forma y, por tanto, puede devolver un planeta distinto.
rudra_based_on_planet_positions	—	Rudra, el planeta que Jaimini asocia con el giro destructivo de una carta; aquí, el más fuerte entre el señor del octavo signo desde el ascendente y el señor de la séptima casa. Devuelve una lista de tres elementos: [índice de planeta, el signo con base cero que ocupa, los tres signos de trígono con base cero de ese signo]. Se calcula de otra forma que `rudra`, y las dos claves pueden dar planetas distintos.
trikonas	—	Los trígonos de cada signo: doce filas, cada una con tres números de signo 1–12: el propio signo y el 5.º y el 9.º desde él. La fila 1 es [1, 5, 9]. Pura geometría: igual en todas las cartas.
trishoola_rasis	—	Los rasis Trishula, el tridente de tres signos que se usa para fechar el periodo más dañino de una carta: los trígonos del signo que ocupa Rudra. Devuelve tres índices de signo con base cero.
upachayas	—	Doce filas de cuatro números de signo 1–12. Tal como está implementado, cada fila da el propio signo y el 4.º, 8.º y 9.º desde él (la fila 1 es [1, 4, 8, 9]), en lugar del 3.º, 6.º, 10.º y 11.º que forman el conjunto upachaya clásico.

Ejemplo de solicitud

curl -X POST https://api.occultapi.com/api/astro/house_hora/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["trikonas"],"raasi":2,"planet":"Mars","node":"mean","date_time":"2025-02-12T09:35:49.036Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Respuesta

{
  "data": {
    "trikonas": [
      [
        1,
        5,
        9
      ],
      [
        2,
        6,
        10
      ],
      [
        3,
        7,
        11
      ],
      [
        4,
        8,
        12
      ],
      [
        5,
        9,
        1
      ],
      [
        6,
        10,
        2
      ],
      [
        7,
        11,
        3
      ],
      [
        8,
        12,
        4
      ],
      [
        9,
        1,
        5
      ],
      [
        10,
        2,
        6
      ],
      [
        11,
        3,
        7
      ],
      [
        12,
        4,
        8
      ]
    ]
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data, cada uno bajo la clave que pediste.

Errores

Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.