{"id":"western/sky","method":"POST","url":"https://astro-agent.dev/v1/western/sky","price_usd":"0.01","tier":"call","title":"Sky today: retrogrades, Moon phase, next events","summary":"The sky today (no birth data): planet positions, retrogrades and Moon phase now, plus the exact UTC times of the next ingresses, stations (Mercury retrograde), new and full moons and aspects.","description":"For agents and bots that follow the sky itself (market timing, daily content, alerts): positions with retrograde flags and the Moon's phase and illumination at a moment (default: now, UTC), then every sign ingress, retrograde/direct station, lunation (new, quarter, full) and major aspect between the planets over the next 1-90 days, each to the minute. Tropical or sidereal. Pass 'datetime' for a reproducible call.","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."},"days":{"type":"integer","minimum":1,"maximum":90,"default":30,"description":"How many days ahead to list events. Example: 30."},"options":{"type":"object","description":"Optional zodiac settings.","properties":{"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical","description":"'tropical' (default) or 'sidereal' (pair it with 'ayanamsa')."},"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri","description":"Only with zodiac=sidereal."}}}},"required":[],"description":"All optional: the moment (default now, UTC). A local time needs a timezone or coordinates."},"example_request":{"datetime":"2026-10-01T00:00Z","days":30},"example_response":{"endpoint":"western/sky","result":{"subject":{"time":{"local_input":"2026-10-01T00:00Z","time_basis":"civil","timezone":null,"timezone_source":"offset_in_datetime","utc_offset":"+00:00","is_dst":null,"utc":"2026-10-01T00:00:00Z","julian_day_ut":2461314.500001,"julian_day_tt":2461314.500801,"delta_t_seconds":69.091,"time_known":true}},"settings":{"zodiac":"tropical","days":30,"event_bodies":["sun","mercury","venus"],"aspects":{"conjunction":0.0,"opposition":180.0,"trine":120.0,"square":90.0,"sextile":60.0},"precision":"event times +/- 1 minute (UTC); sidereal ingresses of slow planets +/- a few minutes (ayanamsa interpolated across the window)"},"now":{"points":[{"point":"sun","name":"Sun","longitude":187.838755,"sign":"Libra","sign_index":6,"degree_in_sign":7.838755,"position":"7°50'20\" Libra","element":"air","modality":"cardinal","latitude":0.000189,"speed_longitude":0.982609,"retrograde":false,"distance_au":1.001326},{"point":"moon","name":"Moon","longitude":63.906575,"sign":"Gemini","sign_index":2,"degree_in_sign":3.906575,"position":"3°54'24\" Gemini","element":"air","modality":"mutable","latitude":5.149558,"speed_longitude":14.282884,"retrograde":false,"distance_au":0.00247},{"point":"mercury","name":"Mercury","longitude":210.679372,"sign":"Scorpio","sign_index":7,"degree_in_sign":0.679372,"position":"0°40'46\" Scorpio","element":"water","modality":"fixed","latitude":-1.747686,"speed_longitude":1.324494,"retrograde":false,"distance_au":1.175837}],"retrograde":["saturn","uranus","neptune"],"moon":{"elongation_deg":236.06782,"phase":"waning gibbous","illumination":0.77887,"waxing":false}},"events":[{"type":"aspect","bodies":["mercury","mars"],"aspect":"square","exact_utc":"2026-10-02T09:14Z"},{"type":"aspect","bodies":["mercury","pluto"],"aspect":"square","exact_utc":"2026-10-02T20:43Z"},{"type":"aspect","bodies":["mars","neptune"],"aspect":"trine","exact_utc":"2026-10-02T22:18Z"}],"counts":{"ingress":2,"station":3,"lunation":4,"aspect":14}},"meta":{"engine":"astro-agents/1.8.0","ephemeris":"NASA/JPL DE440 (1800-01-01..2200-01-01)","astronomy_library":"skyfield/1.55","frame":"geocentric apparent positions, true ecliptic and equinox of date (IAU 2006/2000A)","deterministic":true,"llm_used":false,"input_sha256":"04f06a1a5253ed754226a1d31ca7aa7b6ae017f859895f93c6dfd7e9fa865df8","result_sha256":"cf99aadfd6dd956e77a18036c26889937318593804e6010db4ab4d53b7c252b1","reproducibility":"result_sha256 = SHA-256 of the result serialized as JSON with sorted keys, no whitespace, UTF-8, floats rounded to 6 decimals. Same input + same engine version => same hash."},"example_note":"real output of engine 1.8.0; lists shortened to 3 items"},"payment":"x402 or MPP; 1 free call per client on the $0.01-0.02 routes, this one included. POST without payment to receive the 402 challenge.","catalog":"https://astro-agent.dev/v1/catalog"}