---
title: "Generate Personalized Transit Horoscope"
method: POST
path: "/api/integrations/llm/horoscope"
tags: ["LLM Integrations"]
---

# Generate Personalized Transit Horoscope

`POST /api/integrations/llm/horoscope`

## Request

- Base URL: `https://api.erux.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.erux.ai/api/integrations/llm/horoscope`
- Auth: none declared

**LLM Instructions**: 
Use this endpoint to generate a deterministic, highly accurate daily transit horoscope based on the user's natal chart.
The user's natal birth date ('birth_date') and natal birth city ('birth_city') are strictly required.
NEVER pass today's date into 'birth_date'.
You MUST parse the JSON response from this tool and present it to the user exactly as formatted, including the Call To Action (CTA) link.
DO NOT hallucinate astrological predictions. Rely strictly on the data returned by this endpoint.

## Headers

- `x-erux-api-key` string, nullable

## Request body

- HoroscopeLLMRequest: Input schema required to generate a highly personalized astrological transit horoscope. The user's historical natal birth date ('birth_date') and natal birth city ('birth_city') are strictly required. NEVER pass today's transit date or future dates as birth_date.
  - `birth_date` string, nullable: The user's exact natal birth date in YYYY-MM-DD format (e.g. '1990-07-12'). NEVER pass today's date or transit date here.
  - `birth_city` string, nullable: The user's natal birth city (e.g. 'London', 'Corpus Christi, Texas').
  - `birth_time` string, nullable: The user's exact birth time in 24-hr HH:MM format (e.g. '19:20'). If unknown or not provided, defaults to '12:00' (solar noon).
  - `time` string, nullable: Legacy alias for birth_time. If unknown, defaults to '12:00'.
  - `date` string, nullable: Legacy alias for birth_date or transit date.
  - `city` string, nullable: Legacy alias for birth_city.
  - `current_city` string, nullable: The user's current city if relocated from birth location (e.g. 'Dallas, TX'). Used for high-precision local transit calculation.
  - `target_city` string, nullable: Alias for current_city if user relocated (e.g. 'Dallas, TX').
  - `target_date` string, nullable: The transit/target date to forecast (YYYY-MM-DD). Defaults to today if omitted.
  - `user_prompt` string, nullable: The raw user prompt if available.
  - `platform` string: The platform invoking this tool ('chatgpt' or 'vertex').

## Response `200`

Successful Response

- object

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/erux/apis/erux-astrology-ephemeris-engine.md) · [All operations](https://skmtc.dev/erux/apis/erux-astrology-ephemeris-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/erux/apis/erux-astrology-ephemeris-engine/revisions/9dc718df71b0?raw)