AstrologyApp.net

How many of the user's charts are connected (Full Map) and how many are not, with the link to activate the others. Use when the user asks what they can do or why a chart is missing.

get_access_status

Scans every day in a range (max 90 days) and ranks them for a goal using transit-to-natal aspects, Moon phase and retrogrades. Returns the 5 best and 3 worst days with the contributing factors, so you can explain why. Needs the Full Map on that chart. Present the dates as an astrologer would: the aspects behind each day, in plain words, with the Moon's sign and phase as the day's mood.

find_best_days

Creates a new birth chart in the user's account (for the user or for another person) and returns its chart_id. Needs the birth date, the birth time if known, and a place_id from search_birth_city. For another person, confirm with the user that they have that person's permission and pass third_party_consent=true. The new chart is only connected to the conversation after the user activates its Full Map; the result includes the link.

create_chart

Lists the user's charts that are connected to the conversation (the ones with the Full Map). Call this first to know which chart_id to use. Charts without the Full Map are not listed; the response says how many exist and where to activate them.

list_charts

Exact New Moon, First Quarter, Full Moon and Last Quarter times in a range (max 90 days), plus the Moon's sign, phase, illumination and natal house for each day. Needs the Full Map on that chart. Use the natal house of each New and Full Moon to say which area of the user's life each lunation highlights.

get_moon_calendar

Full natal chart data for one chart: planets with sign, degree, house and retrograde flag, houses, angles, aspects with orb and strength, element and quality balance, plus interpretation guidelines. Only for connected charts (with the Full Map). Interpret it as the user's astrologer: start from the Sun, Moon and Ascendant, then the tightest aspects and angular planets, and weave them into one portrait instead of listing positions.

get_natal_chart

Finds a birth city and returns place_id candidates for create_chart. Show the top candidates to the user and confirm the right one before creating a chart.

search_birth_city

Curated major sky events (eclipses, retrogrades, ingresses, big aspects) active or upcoming around a date, with the natal house each one touches. Needs the Full Map on that chart. Explain each relevant event through the natal house it activates and whether it aspects a personal planet; skip events that touch nothing personal.

get_sky_events

Transiting planets for one calendar day and their aspects to the natal chart (orb <= 3), with the natal house each transit falls in. Needs the Full Map on that chart. Use it for 'today', 'right now' or a specific date; explain the two or three transits with the tightest orbs and what area of life (house) they touch.

get_sky_for_date

Solar return chart for the birthday in a given year, computed at the birthplace: ascendant, midheaven, planets with solar-return and natal houses, aspects. The solar year runs birthday to birthday. Needs the Full Map on that chart. Read the solar-return Ascendant, the house of the Sun and the tightest aspects as the year's storyline, and relate them to the natal chart.

get_solar_return