True Sky

Generate personalized horoscope data organized by time periods using phase-based planetary cycle astrology with professional Western tropical, Vedic sidereal, or other astrological calculation systems. Returns raw planetary cycle data (no interpretations or descriptions).

Use this when the user wants a custom horoscope, individual forecast, or natal-based horoscope (not generic sun-sign horoscopes).

IMPORTANT: This tool generates PERSONALIZED horoscopes based on the user's birth chart. You MUST have the user's actual birth date, time, and location. DO NOT use placeholder birth data. If the user asks for "my horoscope" or "give me a horoscope" and hasn't provided their birth details, ask for them first.

SCOPE SELECTION:

• daily: For today only (1 day)
• weekly: For 2-7 days ("5 day horoscope", "weekend", "this week", etc.)
• monthly: For 1-4 weeks or 1-2 months ("2 week horoscope", "next month", "6 weeks", etc.)
• yearly: For 3+ months or a full year ("3 month horoscope", "next 6 months", "this year", etc.)

NOTE: Use the scope that best fits the timeframe - don't call the tool multiple times. The tool returns 7 days for weekly, 4 weeks for monthly, 12 months for yearly.

RETURNS RAW PLANETARY CYCLE DATA: Each period contains an array of cycles sorted by proximity to conjunction (0°). Each cycle includes:

• transitingPlanet: The transiting planet name (e.g., 'Moon', 'Sun', 'Mars')
• natalPlanet: The natal planet or angle being aspected (e.g., 'Sun', 'Moon', 'Ascendant')
• separation: Degree separation from 0-360° (natal planet is reference point at 0°)
• transitingLongitude: Absolute zodiac position of transiting planet
• natalLongitude: Absolute zodiac position of natal planet

TRANSITING PLANETS BY SCOPE:

• Daily/Weekly: Moon, Sun, Mercury, Venus, Mars (fast-moving)
• Monthly: Sun, Mercury, Venus, Mars (medium-moving)
• Yearly: Jupiter, Saturn, Uranus, Neptune, Pluto (slow outer planets)

SORT ORDER: Cycles are sorted by closest to 0° conjunction with wrap-around (355° appears before 6° since both are close to 0°/360°).

WRITING GUIDELINES:

1. WRITE SUBSTANTIAL DESCRIPTIONS: Each cycle needs 3-5 sentences minimum. Cover what's happening internally, how it shows up in daily life, specific actions to take, and timing. Be concrete and detailed - short summaries are inadequate.

2. PRIORITIZE BY SEPARATION: Focus descriptions on cycles with lower separations (closer to 0°, 90°, 180°, 270°). Tighter aspects are more significant. The sort order helps you identify the most important cycles first.

3. INTERPRET THE SEPARATION VALUES (CONJUNCTION CYCLES ONLY): This tool tracks where planets are in their conjunction cycle (0-360°), NOT traditional aspects. Do not call these "squares," "trines," "sextiles," or "oppositions" - they are phases of the conjunction cycle:

• 0-10° or 350-360°: Beginning/completing conjunction cycle (merging, new beginning)
• 80-100°: Quarter-phase of conjunction cycle (tension, challenge, action needed)
• 170-190°: Peak/midpoint of conjunction cycle (awareness, polarity, balance)
• 260-280°: Three-quarter phase of conjunction cycle (crisis of action)
• Other degrees: Minor influences, less emphasis

4. CREATE MEANINGFUL DESCRIPTIONS: Use the planet combination to craft interpretations:

• Transiting planet = the energy/influence arriving
• Natal planet = the life area being activated
• Separation = the phase of the conjunction cycle

Example: {transitingPlanet: 'Mars', natalPlanet: 'Venus', separation: 2.5} ✓ GOOD: "Mars is joining forces with your natal Venus (2.5° separation), igniting passion and decisive action in relationships and creative pursuits. This is a powerful time to pursue what you desire with confidence. The energy is fresh and initiating, perfect for starting new creative projects or making romantic moves. Act on your desires now while this cycle is beginning."

✗ BAD: "Mars is joining forces with your natal Venus, igniting passion." (Too short - needs 3-5 sentences)

5. ORGANIZE THOUGHTFULLY: Group related cycles by life themes. Create clear section headers that indicate what area of life is being addressed.

6. BE SPECIFIC AND ACTIONABLE: Give concrete guidance on how to work with the energy. Include what to do, when, and why it matters.

7. DON'T OVERLOAD: You don't need to describe every cycle. Focus on the tightest aspects (lowest separations) and most relevant combinations for the person's life.

DO NOT: Mention "square," "trine," "sextile," or "opposition." Write descriptions of 3-5 sentences minimum.

ADDITIONAL REQUIREMENTS:

• DISTINGUISH CYCLE START vs END: 0-10° is a NEW CYCLE STARTING (fresh beginning, seeding). 350-360° is CYCLE COMPLETING (ending, harvest, closure). These have different meanings - describe them accordingly.
• END EACH PERIOD WITH "BEST FOR:" SECTION: After describing all the cycles for a period, add a final paragraph that starts with "Best for:" or "Best:" followed by a concise summary of the best activities/focus areas for that day/week/month based on the cycles described.

KEY FEATURES:

VEDIC ASTROLOGY: Supports Lahiri ayanamsa (standard for Vedic astrology, Hindu astrology, Jyotish, Indian astrology) plus 10 other sidereal systems including Fagan/Bradley (Western sidereal tradition) and True Sidereal (Midpoint). Use zodiacSystem parameter for sidereal horoscopes, Vedic forecasts, or Hindu horoscope predictions.

HOUSE SYSTEMS: 7 house division methods

• Placidus (modern Western standard), Whole Sign (ancient Hellenistic astrology, traditional astrology, also used in Vedic astrology/Jyotish), Koch (birthplace-sensitive, European tradition), Equal (simple 30° divisions), Porphyrius (semi-arc system), Regiomontanus (medieval astrology, Renaissance astrology), Campanus (spatial divisions). Each system affects life area interpretations.

COORDINATE SYSTEMS: Geocentric (Earth-centered perspective, standard astrology) or Topocentric (location-specific calculations, advanced local space astrology, geographic astrology). Topocentric accounts for observer's actual position on Earth's surface.

COMMON QUERIES: "personalized horoscope", "my horoscope this week", "individual forecast", "daily forecast", "monthly forecast", "yearly forecast", "custom horoscope based on birth chart", "planetary cycles", "Vedic horoscope", "sidereal horoscope", "birth chart forecast"

Generate comprehensive natal chart reading data with complete planetary positions, houses, and aspects using professional Western tropical, Vedic sidereal, or other astrological calculation systems for interpretive guidance emphasizing karmic astrology, life path, and soul purpose through lunar nodes. Returns raw data (no interpretations or descriptions).

Use this tool whenever the user requests a reading, interpretation, or analysis of their natal/birth chart. Common trigger words: reading, interpret, analyze, explain chart, tell me about my chart, natal reading, birth chart reading, life purpose, soul journey.

IMPORTANT: This tool requires the user's birth date, time, and location. If you don't have this information, ask the user for it before calling this tool.

RETURNS: Complete natal chart data including:

• All planetary positions (Sun through Pluto, Chiron, nodes) with signs and houses
• Angles (Ascendant, Midheaven, IC, Descendant)
• House cusps (1-12)
• Aspects between planets
• North Node and South Node positions (HIGHLIGHTED for maximum interpretive depth)

USE THIS TOOL FOR:

• Natal chart readings ("Read my birth chart", "What's my natal chart?", "Birth chart interpretation")
• Personality analysis ("Tell me about myself astrologically", "What does my chart say about me?")
• Life path and soul purpose ("What's my life purpose?", "North Node meaning", "Soul journey")
• General birth chart questions ("Explain my chart", "What are my placements?", "Chart analysis")

READING STRUCTURE (REQUIRED):

1. NORTH NODE & SOUTH NODE SECTION (40-50% of reading):

• MANDATORY SYNTAX: Write "[Node] in [House Number] House in [Sign]"
• Start each node interpretation with the HOUSE NUMBER first
• CORRECT: "North Node in 10th House in Aries" or "North Node in 10th House (career, public life) in Aries (bold action)"
• WRONG: "North Node in Aries (10th House)" or "North Node in Cancer (1st House)"
• NEVER write the sign before the house
• Describe what LIFE AREA the node occupies, then HOW the sign colors it
• Discuss node aspects to other planets (MAJOR karmic indicators)
• Make this section DETAILED and ACTIONABLE

2. SUN, MOON, RISING (30% of reading):

• MANDATORY SYNTAX: "[Planet] in [House Number] House in [Sign]"
• CORRECT: "Sun in 8th House in Aquarius" or "Moon in 3rd House (communication, learning) in Leo (dramatic, expressive)"
• WRONG: "Sun in Aquarius (8th House)"
• NEVER put sign before house
• Rising/Ascendant: Sign only (this defines the 1st house, no number needed)

3. OTHER PLANETS (20% of reading):

• MANDATORY SYNTAX: "[Planet] in [House Number] House in [Sign]"
• Mercury, Venus, Mars, Jupiter, Saturn - always mention house number BEFORE sign
• CORRECT: "Venus in 9th House in Pisces"
• WRONG: "Venus in Pisces (9th House)"

4. SYNTHESIS:

• How the nodes integrate with the rest of the chart
• Overall life themes and karmic patterns

ABSOLUTE MANDATORY FORMATTING RULE: HOUSE NUMBERS MUST COME BEFORE SIGNS IN EVERY SENTENCE

The ONLY acceptable formats:

• "[Planet/Node] in [X] House in [Sign]"
• "[Planet/Node] in [X] House ([house meaning]) in [Sign] ([sign quality])"

FORBIDDEN formats (NEVER use these):

• "[Planet/Node] in [Sign] ([X] House)" ← WRONG - sign appears before house
• "[Planet/Node] in [Sign] (House X)" ← WRONG - sign appears before house
• "[Planet/Node] in [Sign], [X] House" ← WRONG - sign appears before house

If you write the SIGN name before the HOUSE number in ANY sentence, you have violated this rule.

IMPORTANT: The North Node and South Node are the CENTERPIECE of this reading. Dedicate substantial interpretive depth to the nodal axis - this is what differentiates this tool from get_natal_chart_data.

IMPORTANT DISTINCTION:

• get_natal_chart_data: Returns RAW DATA ONLY (no interpretations)
• generate_natal_chart_reading: Returns data FOR INTERPRETATION (AI provides NODE-CENTERED, HOUSE-FIRST guidance)

LOCATION HANDLING: If birth location is ambiguous, returns multipleLocations:true with options. Always spell out locations fully (no abbreviations).

IMPORTANT: Free users get 100 calculations per day. After 100 calculations, inform the user they can continue tomorrow.

KEY FEATURES:

VEDIC ASTROLOGY: Supports Lahiri ayanamsa (standard for Vedic astrology, Hindu astrology, Jyotish, Indian astrology) plus 10 other sidereal systems including Fagan/Bradley (Western sidereal tradition) and True Sidereal (Midpoint). Use zodiacSystem parameter for sidereal birth chart readings, Vedic chart interpretations, or Hindu horoscope analysis (Kundli reading, Jyotish reading).

ASTEROID ASTROLOGY: Includes asteroid belt and minor planet calculations including Vesta (devotion, service), Pallas (wisdom, strategy), Juno (partnership, commitment), Black Moon Lilith (shadow self, repressed desires), Ceres (nurturing, motherhood), and Part of Fortune (luck point, prosperity). Perfect for asteroid astrology birth chart readings, modern psychological astrology interpretations, and evolutionary astrology.

HOUSE SYSTEMS: 7 house division methods

• Placidus (modern Western standard), Whole Sign (ancient Hellenistic astrology, traditional astrology, also used in Vedic astrology/Jyotish), Koch (birthplace-sensitive, European tradition), Equal (simple 30° divisions), Porphyrius (semi-arc system), Regiomontanus (medieval astrology, Renaissance astrology), Campanus (spatial divisions). Each system offers different perspectives on life areas and soul purpose.

COORDINATE SYSTEMS: Geocentric (Earth-centered perspective, standard astrology) or Topocentric (location-specific calculations, advanced local space astrology, geographic astrology). Topocentric accounts for observer's actual position on Earth's surface for precise chart readings.

COMMON QUERIES: "natal chart reading", "birth chart interpretation", "read my chart", "chart analysis", "what does my chart mean", "interpret my birth chart", "life purpose astrology", "soul journey", "karmic astrology reading", "North Node interpretation", "evolutionary astrology", "birth chart delineation", "Vedic chart reading", "Kundli interpretation", "asteroid birth chart"

Calculate precise composite chart data creating a single merged chart from midpoint positions of two birth charts using professional Western tropical, Vedic sidereal, or other astrological calculation systems with the midpoint composite method. Returns raw data only (no interpretations or descriptions).

Use this when the user wants a composite chart, relationship chart, couple's chart, or to know how two people function as a single unit.

IMPORTANT: This tool requires birth date, time, and location for BOTH people. If you don't have this information for either person, ask the user for it before calling this tool.

RETURNS: Raw data only (no interpretations or descriptions). Each composite chart includes:

• Person 1 & 2 metadata: Birth information for both people
• Composite planets: Midpoint positions between corresponding planets from both charts, with signs and aspects
• Composite aspects: All aspects between composite planets with orb distances

USE THIS TOOL FOR:

• Composite charts ("What's our composite chart?", "Show me the relationship chart")
• Composite planet positions ("Where is the composite Sun?", "What sign is the composite Venus?")
• Relationship dynamics ("How do we function as a couple?", "What's our composite Moon?")

COMPOSITE vs SYNASTRY:

• Synastry: Compares two separate charts (Person A's planets to Person B's planets)
• Composite: Creates ONE new chart from midpoints (Person A + Person B = Composite)

LOCATION HANDLING: If either birth location is ambiguous (e.g., multiple cities with same name), returns multipleLocations:true with a list of options for the user to choose from. Always spell out locations fully (no abbreviations).

DEFAULT PLANETS: Includes all major planets, lunar nodes, Chiron, and Ceres (16 points total per person). Can customize to include additional asteroids or exclude planets.

DEFAULT ASPECTS: Calculates all 7 major aspects (Conjunction, Opposition, Trine, Square, Sextile, Semisextile, Quincunx) with standard orbs. Can customize orb sizes.

IMPORTANT: Free users get 100 calculations per day. After 100 calculations, inform the user they can continue tomorrow.

KEY FEATURES:

VEDIC ASTROLOGY: Supports Lahiri ayanamsa (standard for Vedic astrology, Hindu astrology, Jyotish, Indian astrology) plus 10 other sidereal systems including Fagan/Bradley (Western sidereal tradition) and True Sidereal (Midpoint). Use zodiacSystem parameter for sidereal composite charts, Vedic relationship analysis, or Hindu horoscope compatibility.

ASTEROID ASTROLOGY: Optional asteroid belt and minor planet calculations including Vesta (devotion, service), Pallas (wisdom, strategy), Juno (partnership, commitment), Black Moon Lilith (shadow self, repressed desires), Ceres (nurturing, motherhood), and Part of Fortune (luck point, prosperity). Perfect for asteroid astrology composite charts and modern psychological astrology approaches to relationships.

HOUSE SYSTEMS: 7 house division methods

• Placidus (modern Western standard), Whole Sign (ancient Hellenistic astrology, traditional astrology, also used in Vedic astrology/Jyotish), Koch (birthplace-sensitive, European tradition), Equal (simple 30° divisions), Porphyrius (semi-arc system), Regiomontanus (medieval astrology, Renaissance astrology), Campanus (spatial divisions). Each system offers different perspectives on relationship dynamics.

COORDINATE SYSTEMS: Geocentric (Earth-centered perspective, standard astrology) or Topocentric (location-specific calculations, advanced local space astrology, geographic astrology). Topocentric accounts for observer's actual position on Earth's surface.

COMMON QUERIES: "composite chart calculator", "relationship chart", "composite astrology", "midpoint composite", "couple chart", "relationship horoscope", "combined chart", "partnership astrology", "composite vs synastry", "Vedic composite", "asteroid composite"

Calculate precise natal birth chart data with planetary positions, house cusps, and aspects using professional Western tropical, Vedic sidereal, or other astrological systems. Returns raw data only (no interpretations or descriptions).

Use this when the user wants raw data, specific planetary positions, birth chart calculations, natal chart data, horoscope positions, or asks about their zodiac placements.

IMPORTANT: This tool requires the user's birth date, time, and location. If you don't have this information, ask the user for it before calling this tool.

RETURNS: Raw data only (no interpretations or descriptions). Each natal chart includes:

• Planetary positions: Exact degree, sign, and house placement for each planet
• Aspects: All aspects between planets with orb distances and applying/separating status
• House cusps: Exact degree and sign of each house cusp
• Angles: Ascendant, Midheaven, Descendant, Imum Coeli positions
• Chart metadata: Birth location coordinates, timezone, UTC offset

USE THIS TOOL FOR:

• Specific position queries ("Where is my Venus?", "What degree is my Sun?")
• Natal planet positions ("What sign is my Mars in?", "What house is my Moon?")
• Birth chart aspects ("Do I have any squares?", "What aspects does my Sun make?")
• Raw technical data without interpretation

Any request for interpretation, analysis, or guidance - use generate_natal_chart_reading instead

LOCATION HANDLING: If birth location is ambiguous (e.g., multiple cities with same name), returns multipleLocations:true with a list of options for the user to choose from. Always spell out locations fully (no abbreviations).

DEFAULT PLANETS: Includes all major planets, lunar nodes, Chiron, main angles, and Ceres (16 points total). Can customize to include additional asteroids or exclude planets.

DEFAULT ASPECTS: Calculates all 7 major aspects (Conjunction, Opposition, Trine, Square, Sextile, Semisextile, Quincunx) with standard orbs. Can customize orb sizes.

IMPORTANT: Free users get 100 calculations per day. After 100 calculations, inform the user they can continue tomorrow.

KEY FEATURES:

VEDIC ASTROLOGY: Supports Lahiri ayanamsa (standard for Vedic astrology, Hindu astrology, Jyotish, Indian astrology) plus 10 other sidereal systems including Fagan/Bradley (Western sidereal tradition) and True Sidereal (Midpoint). Use zodiacSystem parameter for sidereal birth charts, Vedic natal charts, or Hindu horoscope calculations. NOTE: For authentic Vedic/Jyotish charts, use zodiacSystem=Lahiri AND houseSystem=Whole Sign (traditional Vedic house system).

ASTEROID ASTROLOGY: Optional asteroid belt and minor planet calculations including Vesta (devotion, service), Pallas (wisdom, strategy), Juno (partnership, commitment), Black Moon Lilith (shadow self, repressed desires), Ceres (nurturing, motherhood), and Part of Fortune (luck point, prosperity). Perfect for asteroid astrology enthusiasts and modern psychological astrology approaches.

HOUSE SYSTEMS: 7 house division methods

• Placidus (modern Western standard), Whole Sign (ancient Hellenistic astrology, traditional astrology, also used in Vedic astrology/Jyotish), Koch (birthplace-sensitive, European tradition), Equal (simple 30° divisions), Porphyrius (semi-arc system), Regiomontanus (medieval astrology, Renaissance astrology), Campanus (spatial divisions). Each system offers different perspectives on life areas and angular houses.

COORDINATE SYSTEMS: Geocentric (Earth-centered perspective, standard astrology) or Topocentric (location-specific calculations, advanced local space astrology, geographic astrology). Topocentric accounts for observer's actual position on Earth's surface.

COMMON QUERIES: "birth chart calculator", "natal chart calculator", "show my natal chart", "calculate my horoscope", "what sign is my Venus", "Vedic birth chart", "sidereal natal chart", "asteroid chart", "tropical astrology chart"

Calculate precise astrology return chart data (solar return or lunar return) calculating when Sun or Moon returns to exact natal position using professional Western tropical, Vedic sidereal, or other astrological calculation systems. Returns raw data only (no interpretations or descriptions).

Use this when the user wants their solar return chart, lunar return chart, birthday chart, solar revolution, annual chart, or astrology return forecast.

IMPORTANT: This tool requires the user's birth date, time, and location. If you don't have this information, ask the user for it before calling this tool.

RETURNS: Raw astrology data only (no interpretations or descriptions). Each return chart includes:

• Return info: Exact date/time of the return, return location, whether it's relocated
• Birth info: Original natal birth data for reference
• Planets: All planetary positions at the return moment with astrological signs, houses, and aspects
• Angles: Ascendant, MC, IC, Descendant positions
• Houses: All 12 astrological house cusps

USE THIS ASTROLOGY TOOL FOR:

• Solar returns ("What's my solar return for 2025?", "Show me my birthday chart", "My solar return astrology")
• Lunar returns ("Calculate my lunar return", "When is my next lunar return?", "Lunar return astrology")
• Relocated returns ("Solar return in Paris", "Birthday chart for New York", "Relocated astrology chart")
• Astrology forecasts ("My return chart", "What does my solar return show?")

RETURN TYPES SUPPORTED (ASTROLOGY):

• Solar: Sun returns to natal position (once per year, around birthday) - most common astrology return chart
• Lunar: Moon returns to natal position (once per ~27 days, 13 lunar returns per year) - monthly astrology return chart

RELOCATED ASTROLOGY RETURNS:

• If returnLocation differs from birthLocation, calculates a "relocated" return
• Relocated returns show how the return energy manifests in a different location in astrology
• Use birth location if user doesn't specify a return location

LOCATION HANDLING: If either location is ambiguous, returns multipleLocations:true with options. Always spell out locations fully (no abbreviations).

DEFAULT PLANETS: Includes all major planets, lunar nodes, Chiron, and Ceres for complete astrology analysis. Can customize to include additional asteroids.

DEFAULT ASPECTS: Calculates all 7 major astrological aspects with standard orbs. Can customize orb sizes.

IMPORTANT: Free users get 100 calculations per day. After 100 calculations, inform the user they can continue tomorrow.

KEY FEATURES:

RELOCATION ASTROLOGY: Supports relocation astrology, locational astrology, relocated returns, and astromapping returns. Perfect for people who travel or relocate for their birthday, or want to see how a solar return manifests in different geographic locations.

VEDIC ASTROLOGY: Supports Lahiri ayanamsa (standard for Vedic astrology, Hindu astrology, Jyotish, Indian astrology) plus 10 other sidereal systems including Fagan/Bradley (Western sidereal tradition) and True Sidereal (Midpoint). Use zodiacSystem parameter for sidereal solar returns, Vedic return charts, or Hindu horoscope annual forecasts (varshaphala).

ASTEROID ASTROLOGY: Optional asteroid belt and minor planet calculations including Vesta (devotion, service), Pallas (wisdom, strategy), Juno (partnership, commitment), Black Moon Lilith (shadow self, repressed desires), Ceres (nurturing, motherhood), and Part of Fortune (luck point, prosperity). Perfect for asteroid astrology solar returns and modern psychological astrology approaches to annual forecasts.

HOUSE SYSTEMS: 7 house division methods

• Placidus (modern Western standard), Whole Sign (ancient Hellenistic astrology, traditional astrology, also used in Vedic astrology/Jyotish), Koch (birthplace-sensitive, European tradition), Equal (simple 30° divisions), Porphyrius (semi-arc system), Regiomontanus (medieval astrology, Renaissance astrology), Campanus (spatial divisions). Each system affects the return chart's Ascendant and house cusps.

COORDINATE SYSTEMS: Geocentric (Earth-centered perspective, standard astrology) or Topocentric (location-specific calculations, advanced local space astrology, geographic astrology). Topocentric accounts for observer's actual position on Earth's surface.

COMMON QUERIES: "solar return calculator", "lunar return calculator", "birthday chart", "solar return astrology", "annual chart", "SR chart", "relocated solar return", "relocation astrology", "solar return forecast", "lunar return dates", "monthly lunar return", "Vedic solar return", "varshaphala calculator", "asteroid solar return"

Calculate precise synastry compatibility data comparing two birth charts with cross-aspects between Person 1's planets and Person 2's planets using professional Western tropical, Vedic sidereal, or other astrological calculation systems. Returns raw data only (no interpretations or descriptions).

Use this when the user wants relationship compatibility, synastry aspects, romantic compatibility, partnership astrology, or to know how two people's charts interact.

IMPORTANT: This tool requires birth date, time, and location for BOTH people. If you don't have this information for either person, ask the user for it before calling this tool.

RETURNS: Raw data only (no interpretations or descriptions). Each synastry report includes:

• Person 1 chart: Planetary positions with signs, houses, and retrograde status
• Person 2 chart: Planetary positions with signs, houses, and retrograde status
• Synastry aspects: All aspects between Person 1's planets and Person 2's planets with orb distances and applying/separating status

USE THIS TOOL FOR:

• Relationship compatibility ("Are we compatible?", "What's our synastry?")
• Synastry aspects ("Do our Suns trine?", "What aspects do our Moons make?")
• Partner chart comparisons ("How do our charts interact?", "What's the connection?")

LOCATION HANDLING: If either birth location is ambiguous (e.g., multiple cities with same name), returns multipleLocations:true with a list of options for the user to choose from. Always spell out locations fully (no abbreviations).

DEFAULT PLANETS: Includes all major planets, lunar nodes, Chiron, and Ceres (16 points total per person). Can customize to include additional asteroids or exclude planets.

DEFAULT ASPECTS: Calculates all 7 major aspects (Conjunction, Opposition, Trine, Square, Sextile, Semisextile, Quincunx) with standard orbs. Can customize orb sizes.

IMPORTANT: Free users get 100 calculations per day. After 100 calculations, inform the user they can continue tomorrow.

KEY FEATURES:

RELATIONSHIP TYPES: Perfect for romantic compatibility, business partnership astrology, friendship synastry, family relationship astrology, and parent-child chart comparison. Works for any two-person relationship dynamic.

ASPECT GRID: Shows all planetary combinations between the two charts including double-whammy aspects when they occur (mutual aspects between same planets, e.g., Person A's Venus conjunct Person B's Mars AND Person B's Venus conjunct Person A's Mars).

VEDIC ASTROLOGY: Supports Lahiri ayanamsa (standard for Vedic astrology, Hindu astrology, Jyotish, Indian astrology) plus 10 other sidereal systems including Fagan/Bradley (Western sidereal tradition) and True Sidereal (Midpoint). Use zodiacSystem parameter for sidereal synastry charts, Vedic relationship compatibility, or Hindu horoscope matching.

ASTEROID ASTROLOGY: Optional asteroid belt and minor planet calculations including Vesta (devotion, service), Pallas (wisdom, strategy), Juno (partnership, commitment), Black Moon Lilith (shadow self, repressed desires), Ceres (nurturing, motherhood), and Part of Fortune (luck point, prosperity). Perfect for asteroid astrology synastry and modern psychological astrology approaches to relationships.

HOUSE SYSTEMS: 7 house division methods

• Placidus (modern Western standard), Whole Sign (ancient Hellenistic astrology, traditional astrology, also used in Vedic astrology/Jyotish), Koch (birthplace-sensitive, European tradition), Equal (simple 30° divisions), Porphyrius (semi-arc system), Regiomontanus (medieval astrology, Renaissance astrology), Campanus (spatial divisions). Each system offers different perspectives on life areas and angular houses.

COORDINATE SYSTEMS: Geocentric (Earth-centered perspective, standard astrology) or Topocentric (location-specific calculations, advanced local space astrology, geographic astrology). Topocentric accounts for observer's actual position on Earth's surface.

COMMON QUERIES: "relationship compatibility", "synastry calculator", "are we compatible", "compatibility chart", "couple astrology", "relationship chart", "romantic compatibility", "love compatibility", "synastry report", "Vedic synastry", "asteroid synastry", "Juno synastry", "Lilith synastry"

Calculate precise transit timing data showing when transiting and progressed planets aspect natal planets, station retrograde/direct, and cross house cusps using professional Western tropical, Vedic sidereal, or other astrological calculation systems. Returns raw timing data only (no interpretations or descriptions).

Use this for questions about future or past astrological timing, forecasts, when aspects happen, planetary movements, retrogrades, upcoming transits, or historical transit analysis.

RETURNS: Raw data only (dates, times, planet positions, aspect types)

• NO interpretations or descriptions. Each event includes:
• Exact date/time when aspect becomes exact
• Which planets are involved (transiting/progressed and natal)
• Aspect type (Conjunction, Square, etc.) or event type (Station Retrograde, House Ingress)
• Whether planet is retrograde
• Start/exact/orb timing for each aspect

DATE RANGES: Specify any custom startDate and endDate (past or future). Can analyze up to 5 years (1825 days) in a single request.

RECOMMENDED TIME RANGES:

• Daily/Weekly forecasts: 1-14 days
• Monthly forecasts: 30-60 days
• Yearly forecasts: 365 days
• Long-term analysis: Up to 1825 days (5 years)

AUTOMATIC PLANET SELECTION (based on time range to avoid overwhelming data):

• Short term (1-14 days): All planets including Moon, Mercury, Venus, Mars
• Medium term (15-60 days): All planets except Moon
• Long term (60+ days): Only slow-moving outer planets (Jupiter, Saturn, Uranus, Neptune, Pluto)

Override automatic selection with transitingPlanets parameter when you need specific planets regardless of range (e.g., transitingPlanets: ["Mercury"] for year-long Mercury retrograde tracking, or ["Mercury", "Venus", "Mars"] for all inner planet stations over long periods).

TRANSIT TYPES AVAILABLE:

• Transiting to Natal (default): Current sky planets aspecting birth chart
• Progressed to Natal: Progressed planets aspecting birth chart
• Transiting to Transiting: Current planets aspecting each other
• Progressed to Progressed: Progressed planets aspecting each other
• Stations: Planets stationing retrograde or direct
• House Ingresses: Planets crossing house cusps

DEFAULT BEHAVIOR: Returns transits to natal planets, stations, and house ingresses.

LOCATION HANDLING: If birth location is ambiguous (e.g., multiple cities with same name), returns multipleLocations:true with a list of options for the user to choose from. Always spell out locations fully (no abbreviations).

IMPORTANT

• WHEN TO USE PLACEHOLDER BIRTH DATA: ONLY use placeholder birth data for queries about astronomical events that are NOT personalized to the user (e.g., "when does Mercury go retrograde?", "when is Saturn conjunct Neptune?", "when is the next New Moon?"). Use birthLocation="London, England, United Kingdom" (NOT Greenwich - not in database), birthDate="2000-01-01", birthTime="12:00", and set transitTypes to "Stations" or "Transiting to Transiting". DO NOT use placeholder data for personalized queries - if the user asks for "my horoscope", "my transits", or any forecast for themselves, you MUST ask for their birth date, time, and location first.

HOUSE INGRESS INTERPRETATION:

• retrograde=false: Planet ENTERING that house
• retrograde=true: Planet EXITING that house (moving backwards)

IMPORTANT: Free users get 100 calculations per day. After 100 calculations, inform the user they can continue tomorrow.

KEY FEATURES:

SECONDARY PROGRESSIONS: Calculates progressed chart using day-for-a-year method (symbolic directions). Includes Progressed-to-Natal aspects (progressed planets aspecting birth chart) and rare Progressed-to-Progressed aspects (inner progression dynamics, progressed planets aspecting each other). Most astrology apps don't offer progressed-to-progressed calculations.

HISTORICAL ANALYSIS: Works for PAST transits, not just forecasts. Analyze what transits were occurring during past events, retroactive transit analysis, or historical astrology research. Perfect for "what transits happened when..." queries.

RETROGRADE TRACKING: Identifies exact dates/times when planets station retrograde or direct. Answers queries about Mercury retrograde dates, Venus retrograde periods, Mars retrograde timing, Saturn retrograde, and all outer planet retrograde cycles.

MUNDANE ASTROLOGY: Transiting-to-Transiting option shows outer planet cycles, Jupiter-Saturn conjunctions, generational aspects, and world events astrology (planets aspecting each other in current sky, not tied to personal natal chart).

FLEXIBLE TIME RANGES: Analyze any period from single day to 5 years in one request. No need for multiple API calls for comprehensive transit reports.

VEDIC ASTROLOGY: Supports Lahiri ayanamsa (standard for Vedic astrology, Hindu astrology, Jyotish, Indian astrology) plus 10 other sidereal systems including Fagan/Bradley (Western sidereal tradition) and True Sidereal (Midpoint). Use zodiacSystem parameter for sidereal transit calculations, Vedic timing analysis, or Hindu horoscope timing.

HOUSE SYSTEMS: 7 house division methods

• Placidus (modern Western standard), Whole Sign (ancient Hellenistic astrology, traditional astrology, also used in Vedic astrology/Jyotish), Koch (birthplace-sensitive, European tradition), Equal (simple 30° divisions), Porphyrius (semi-arc system), Regiomontanus (medieval astrology, Renaissance astrology), Campanus (spatial divisions). Each system affects which house cusps planets cross.

COORDINATE SYSTEMS: Geocentric (Earth-centered perspective, standard astrology) or Topocentric (location-specific calculations, advanced local space astrology, geographic astrology). Topocentric accounts for observer's actual position on Earth's surface.

COMMON QUERIES: "transit calculator", "when does Mercury go retrograde", "upcoming transits", "planetary transits this month", "progressed chart calculator", "secondary progressions", "retrograde calendar", "past transits", "what transits am I having", "Vedic transit timing", "sidereal transits", "house ingress calculator"