Назад к документации
Западные транзиты
Западные транзиты
POST
/api/v1/transits/calculateРассчитайте транзиты планет на конкретную дату и сравните их с натальной картой. Возвращает текущие положения планет и аспекты, образовавшиеся между транзитными и натальными планетами.
По умолчанию ответ включает блоки интерпретации и набор транзитных тел.Солнце, Луна, Меркурий, Венера, Марс, Юпитер, Сатурн, Уран, Нептун, Плутон, true_node, Хирон, Лилит. Отключить интерпретацию с помощью "interpretation": {"enable": false}.
Неизвестное время рождения поддерживается через natal.time_known=false. В этом режиме натальная сторона ведет себя как натальный эндпоинт: дома и углы опускаются, а расположение домов натальных планет не возвращается.
Полный URL
https://api.freeastroapi.com/api/v1/transits/calculateКак работают транзитные расчеты
Транзиты сравнивают текущее небо (или любая указанная дата) с человеком натальная карта.
- •(Т) указывает на транзитную планету (текущее положение)
- •(Н) указывает на натальную планету (позицию рождения)
- •Аспекты между планетами (T) и (N) раскрывают темы текущей жизни.
Параметры запроса
| Parameter | Type | Required | Description |
|---|---|---|---|
| natal.name | string | Нет | Имя человека (по умолчанию: Пользователь) |
| natal.year | integer | Да | Натальный год рождения |
| natal.month | integer | Да | Натальный месяц рождения (1-12) |
| natal.day | integer | Да | Натальный день рождения |
| natal.time_known | boolean | Нет | По умолчанию: true. Установите false для неизвестного времени рождения. В безвременном режиме натальные дома и углы опускаются. |
| natal.hour | integer | Нет | Натальный час рождения (0-23). Требуется, если natal.time_known=true. Структурно игнорируется, если natal.time_known=false. |
| natal.minute | integer | Нет | Натальная минута рождения. Требуется, если natal.time_known=true. Структурно игнорируется, если natal.time_known=false. |
| natal.lat | float | Да | Натальная широта рождения |
| natal.lng | float | Да | Натальная долгота рождения |
| current_city | string | Да | Название города текущего местоположения |
| current_lat | float | Нет | Широта текущего местоположения (необязательно, если указан город) |
| current_lng | float | Нет | Долгота текущего местоположения (необязательно, если указан город) |
| transit_date | string | Нет | Дата транзита в формате ISO (по умолчанию: сейчас) |
| tz_str | string | Нет | Часовой пояс для транзитного местоположения (по умолчанию: AUTO) |
| orb_settings | object | Нет | Дополнительные настройки орбисов для каждого аспекта, например. { conjunction: 8, trine: 6 } |
| interpretation | object | Нет | Интерпретации включены по умолчанию. Передайте {enable: false}, чтобы отключить блоки интерпретации. |
📅 Формат даты транзита
Используйте формат ISO 8601: YYYY-MM-DDTHH:MM
Examples:
2025-01-15T12:00 - 15 января 2025 г., полдень.
2025-06-21T00:00 - 21 июня 2025 г., полночь.
Пример кода
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
}
}'Данные ответа
{
"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": "..."
}
]
}
}
}