Персональный ежедневный гороскоп

Формирует уникальный прогноз по натальной карте. V3 добавляет контекст timeline-backed, тайминг exact-hit, доминирующие ежемесячные темы и дополнительные блоки атомарной интерпретации в верхних транзитах.

Демо-приложение «Гороскоп»

Приложение open-source Next.js, созданное с использованием этой конечной точки, показывает ежедневные личные гороскопы в чистом пользовательском интерфейсе.

Живая демонстрация Исходный код

POST/api/v3/horoscope/daily/personal

ℹ️ Хронология версии 3: использует временную шкалу транзитов и механизмы анализа транзитов, а затем превращает их в ежедневный ответ гороскопа с точными совпадениями, активными окнами, следующей сменой, доминирующими темами и дополнительными блоками интерпретации для транзитов top-ranked.

Обзор конечных точек

Принимает полную информацию о рождении и возвращает более богатый ежедневный слой, созданный на основе окон временной шкалы и информации о транзите. Местоположение может быть определено как по городу, так и по прямым координатам. Это лучший выбор, если вам нужны тайминги exact-hit, активные окна, ежемесячный контекст или блоки объяснений в верхних транзитах.

Правило местоположения: для всех версий нужно отправить либо birth.city, либо оба поля birth.lat и birth.lng. Город не требуется, если координаты уже известны.

Параметры тела

Parameter	Type	Required	Description
birth	object	Yes	Объект сведений о рождении. Местоположение может быть указано либо в виде города, либо в виде координат широты и долготы.
date	string	No	Плановая дата (YYYY-MM-DD). По умолчанию: сегодня
tz_str	string	No	Строка часового пояса. По умолчанию: AUTO
include_interpretation_blocks	boolean	No	Только В3. Добавляет дополнительные атомарные блоки интерпретации к верхним транзитам.
birth.year	integer	Yes	Год рождения
birth.month	integer	Yes	Месяц рождения (1-12)
birth.day	integer	Yes	День рождения
birth.hour	integer	Yes	Час рождения (0-23)
birth.minute	integer	Yes	Минута рождения
birth.city	string	No	Необязательное название города для auto-geolocation. Требуется только в том случае, если широта/долгота не указаны.
birth.lat	float	No	Широта рождения. Требуется вместе с lng, если город опущен.
birth.lng	float	No	Долгота рождения. Требуется вместе с широтой, если город опущен.
birth.tz_str	string	No	Название часового пояса IANA, например Europe/London
birth.time_known	boolean	No	Установите false, если время рождения неизвестно.

Пример запроса

curl -X POST "https://api.freeastroapi.com/api/v3/horoscope/daily/personal" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
    "birth": {
      "year": 1990,
      "month": 5,
      "day": 15,
      "hour": 10,
      "minute": 0,
      "city": "London, UK",
      "lat": 51.5074,
      "lng": -0.1278,
      "tz_str": "Europe/London",
      "time_known": true
    },
    "date": "2026-04-20",
    "include_interpretation_blocks": true
}'

Пример ответа

Реальный пример производства из /api/v3/horoscope/daily/personal, обрезано для удобства чтения.

{
  "meta": {
    "request_id": "req_869e5b4f",
    "generated_at": "2026-04-20T13:28:51.233830",
    "settings": {
      "date_resolved": "2026-04-20",
      "version": "v3",
      "include_interpretation_blocks": true
    },
    "engine": {
      "name": "DailyHoroscopeEngine",
      "version": "3.0.0"
    }
  },
  "data": {
    "sign": "taurus",
    "date": "2026-04-20",
    "scores": {
      "overall": 72,
      "love": 86,
      "career": 58,
      "money": 92,
      "health": 53
    },
    "content": {
      "theme": "Sensuality",
      "keywords": ["Stability", "Practicality", "Sensuality", "Focus", "Growth"]
    },
    "personal": {
      "transits_top": [
        {
          "label": "Venus Trine Natal Moon",
          "score": 99.8,
          "exact_at": "2026-04-20T13:42:39Z",
          "transit_planet": { "key": "venus", "label": "Venus" },
          "natal_planet": { "key": "moon", "label": "Moon" },
          "aspect": { "key": "trine", "label": "Trine" },
          "explanation": {
            "main": "Emotional life tends to feel steadier and more nourished, making it easier to give and receive care without overexplaining.",
            "supporting": [
              "Lean into simple rituals: shared meals, warm baths, tidying your space, or calling someone who feels like home.",
              "If feelings surface, name them gently; reassurance lands well and helps closeness grow naturally."
            ],
            "tags": ["emotional-ease", "comfort", "affection", "home", "relationship-support"]
          }
        },
        {
          "label": "Mars Conjunction Natal Midheaven",
          "score": 98.5,
          "exact_at": "2026-04-20T15:01:24Z",
          "transit_planet": { "key": "mars", "label": "Mars" },
          "natal_planet": { "key": "midheaven", "label": "Midheaven" },
          "aspect": { "key": "conjunction", "label": "Conjunction" }
        }
      ],
      "focus_areas": [
        "Background Themes",
        "Relationships & Bonds",
        "Action & Energy"
      ],
      "confidence_score": 95,
      "day_context": {
        "active_windows": [
          {
            "label": "Mars Sextile Natal Descendant",
            "start": "2026-04-04T21:39:22Z",
            "end": "2026-04-20T08:10:46Z",
            "exact_hits": ["2026-04-12T14:27:39Z"]
          },
          {
            "label": "Venus Conjunction Natal Sun",
            "start": "2026-04-12T22:07:30Z",
            "end": "2026-04-26T01:00:28Z",
            "exact_hits": ["2026-04-19T11:16:24Z"]
          }
        ],
        "exact_hits": [
          {
            "timestamp": "2026-04-20T13:42:39Z",
            "label": "Venus Trine Natal Moon"
          },
          {
            "timestamp": "2026-04-20T15:01:24Z",
            "label": "Mars Conjunction Natal Midheaven"
          },
          {
            "timestamp": "2026-04-20T18:26:43Z",
            "label": "Mercury Conjunction Natal Midheaven"
          }
        ],
        "next_shift": {
          "timestamp": "2026-04-20T13:42:39Z",
          "label": "Venus Trine Natal Moon exact",
          "type": "exact_hit"
        },
        "dominant_topics": [
          {
            "title": "Transit Stellium In Taurus",
            "category": "chart_pattern",
            "focus_type": "background_month_theme",
            "score": 0.769,
            "peak_datetime": "2026-04-22T12:00:00Z"
          }
        ],
        "supportive_vs_challenging": {
          "supportive": 12,
          "challenging": 12
        }
      },
      "insights_meta": {
        "source": "timeline_and_transit_insights",
        "timeline_enabled": true,
        "insights_enabled": true,
        "interpretation_blocks_enabled": true,
        "timeline_pass_count": 112,
        "generated_fact_count": 64,
        "range_start": "2026-04-01T00:00:00Z",
        "range_end": "2026-04-30T23:59:59Z"
      }
    }
  }
}

V3: ежедневный контекст на базе таймлайна

V3 сохраняет ежедневные результаты и лучшие транзиты, но обновляет конечную точку с помощью реального временного слоя. Он предназначен для клиентов, которым нужен более последовательный и понятный ежедневный личный гороскоп.

Тайминг exact-hit

day_context.exact_hits и next_shift выявляют точные внутридневные поворотные моменты, которые влияют на ежедневный рейтинг.

Активные окна

active_windows суммирует уже действующие транзиты к целевой дате, включая начало, окончание и временные метки exact-hit.

Доминирующие темы

dominant_topics выявляет более крупный месячный паттерн, стоящий за днем, например, стеллиум, окно поддержки, окно давления или кластер активации.

Дополнительные атомарные блоки

Установите include_interpretation_blocks=true, чтобы прикрепить реальные блоки интерпретации к personal.transits_top[*].explanation.