Tránsitos (occidental)
Tránsitos (occidental)
/api/v1/transits/calculateCalcula los tránsitos planetarios para una fecha concreta y compáralos con una carta natal. La respuesta devuelve las posiciones planetarias actuales y los aspectos formados entre los planetas en tránsito y los planetas natales.
Por defecto, la respuesta incluye los bloques de interpretación y el set de cuerpos en tránsitosun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, true_node, chiron, lilith. Desactiva las interpretaciones con "interpretation": {"enable": false}.
Los nacimientos sin hora están admitidos mediante natal.time_known=false. En este modo, el lado natal se comporta como el endpoint Natal: se omiten las casas y ángulos, y no se devuelven las posiciones de casas de los planetas natales.
URL completa
https://api.freeastroapi.com/api/v1/transits/calculateCómo funcionan los cálculos de tránsitos
Los tránsitos comparan el cielo actual (o cualquier fecha indicada) con la carta natal de una persona.
- •(T) indica un planeta en tránsito (posición actual)
- •(N) indica un planeta natal (posición de nacimiento)
- •Los aspectos entre planetas (T) y (N) revelan los temas vitales actuales
Parámetros de solicitud
| Parámetro | Type | Requerido | Description |
|---|---|---|---|
| natal.name | string | No | Nombre de la persona (por defecto: User) |
| natal.year | integer | Sí | Año de nacimiento natal |
| natal.month | integer | Sí | Mes de nacimiento natal (1-12) |
| natal.day | integer | Sí | Día de nacimiento natal |
| natal.time_known | boolean | No | Por defecto: true. Usa false cuando la hora de nacimiento es desconocida. En modo sin hora, las casas y ángulos natales se omiten. |
| natal.hour | integer | No | Hora de nacimiento natal (0-23). Requerida cuando natal.time_known=true. Se ignora estructuralmente cuando natal.time_known=false. |
| natal.minute | integer | No | Minuto de nacimiento natal. Requerido cuando natal.time_known=true. Se ignora estructuralmente cuando natal.time_known=false. |
| natal.lat | float | Sí | Latitud de nacimiento natal |
| natal.lng | float | Sí | Longitud de nacimiento natal |
| current_city | string | Sí | Nombre de la ciudad actual |
| current_lat | float | No | Latitud actual (opcional si se proporciona city) |
| current_lng | float | No | Longitud actual (opcional si se proporciona city) |
| transit_date | string | No | Fecha de tránsito en formato ISO (por defecto: ahora) |
| tz_str | string | No | Zona horaria del lugar de tránsito (por defecto: AUTO) |
| orb_settings | object | No | Overrides opcionales de orbe por aspecto, por ej. { Conjunction: 8, Trine: 6 } |
| interpretation | object | No | Las interpretaciones están activadas por defecto. Usa { enable: false } para desactivar los bloques de interpretación. |
📅 Formato de fecha de tránsito
Usa el formato ISO 8601: YYYY-MM-DDTHH:MM
Ejemplos:
2025-01-15T12:00 - 15 de enero de 2025 al mediodía
2025-06-21T00:00 - 21 de junio de 2025 a medianoche
Ejemplos de código
curl -X POST "https://api.freeastroapi.com/api/v1/transits/calculate" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"natal": {
"name": "John Doe",
"city": "New York",
"year": 1990,
"month": 5,
"day": 15,
"time_known": false,
"hour": 10,
"minute": 30,
"lat": 40.7128,
"lng": -74.006,
"tz_str": "AUTO"
},
"transit_date": "2025-01-15T12:00",
"current_city": "Paris",
"current_lat": 48.8566,
"current_lng": 2.3522,
"tz_str": "AUTO",
"orb_settings": {
"Conjunction": 8.0,
"Opposition": 8.0,
"Trine": 6.0,
"Square": 6.0,
"Sextile": 4.0
}
}'Datos de respuesta
{
"transit_date": "2025-01-15",
"transit_time": "12:00:00",
"mode": "transit_to_natal",
"location": {
"city": "Paris",
"lat": 48.8566,
"lng": 2.3522,
"timezone": "Europe/Paris"
},
"natal_planets": [
{
"id": "sun",
"name": "Sun",
"sign": "Tau",
"pos": 24.72,
"abs_pos": 54.72,
"house": 9
}
// ...
],
"transit_planets": [
{
"id": "sun",
"name": "Sun",
"sign": "Cap",
"pos": 25.12,
"abs_pos": 295.12,
"house": 5,
"retrograde": false
}
// ...
],
// Default set includes: sun, moon, mercury, venus, mars, jupiter,
// saturn, uranus, neptune, pluto, true_node, chiron, lilith
"aspects": [
{
"p1": "Sun (N)",
"p2": "Sun (T)",
"between": { "natal": "sun", "transit": "sun" },
"type": "Trine",
"orb": 0.4,
"deg": 120.0,
"is_major": true,
"is_applying": true
}
// ...
],
"aspects_summary": {
"total": 18,
"major": 12,
"minor": 6,
"applying": 8,
"separating": 10,
"by_type": { "Trine": 4, "Square": 3 }
},
"interpretation": {
"metadata": { "found_count": 12, "missing_keys": [] },
"sections": {
"core_self": [
{
"key": "aspect.sun.trine.sun",
"title": "Sun Trine Sun (Transit)",
"body": "A period of vital harmony where your current path aligns perfectly with your core essence..."
}
]
// ... mind, love_relating, work_path, etc.
},
"index": {
"aspects": [
{
"p1": "sun",
"p2": "sun",
"type": "trine",
"title": "Sun Trine Sun (Transit)",
"content": "..."
}
]
}
}
}