{"id":"finance/events","method":"POST","url":"https://astro-agent.dev/v1/finance/events","price_usd":"0.25","tier":"premium","title":"Eclipse & Mercury retrograde calendar (market timing)","summary":"Eclipse and Mercury retrograde calendar: every solar and lunar eclipse, station (retrograde/direct), ingress, new and full moon, aspect, parallel and out-of-bounds between two dates (1800-2200), to the minute.","description":"A reproducible calendar of celestial events for backtests and alerts, historical or future: sign ingresses, retrograde/direct stations, new/full/quarter moons, solar eclipses (total, annular, hybrid, partial, with gamma) and lunar eclipses (with magnitudes), aspects between planets, declination parallels / contra-parallels and out-of-bounds crossings. Up to 366 days per call, geocentric or heliocentric, tropical or sidereal, Moon optional. Each event has exact_utc, a unix 'timestamp' to join on candle times and a stable 'key' for de-duplication across pages.","input_schema":{"type":"object","required":["start","end"],"properties":{"start":{"type":"string","description":"First UTC date, YYYY-MM-DD, 1800..2199. Example: '2024-01-01'."},"end":{"type":"string","description":"Last UTC date, YYYY-MM-DD, at most 366 days after start (inclusive)."},"perspective":{"type":"string","enum":["geocentric","heliocentric"],"default":"geocentric","description":"Heliocentric gives ingresses and aspects only (no stations, lunations, eclipses)."},"include":{"type":"array","items":{"type":"string","enum":["ingress","station","lunation","eclipse","aspect","declination","out_of_bounds"]},"description":"Event types to return. Default: all that apply to the perspective."},"bodies":{"type":"array","items":{"type":"string","enum":["sun","mercury","venus","earth","mars","jupiter","saturn","uranus","neptune","pluto"]},"description":"Planets searched. Default: Sun..Pluto (geo), Mercury..Pluto with Earth (helio)."},"include_moon":{"type":"boolean","default":false,"description":"Also the Moon's ingresses, aspects, parallels and out-of-bounds (geocentric; many events)."},"aspects":{"description":"Aspects timed between planets. Default: the 5 majors.","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["conjunction","opposition","trine","square","sextile","quincunx","semisextile","semisquare","sesquiquadrate","quintile","biquintile"]}}]},"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."}}}}},"example_request":{"start":"2024-01-01","end":"2024-12-31","include":["station","eclipse","ingress"],"bodies":["mercury","jupiter","saturn"]},"example_response":{"endpoint":"finance/events","result":{"settings":{"start":"2024-01-01","end":"2024-12-31","perspective":"geocentric","zodiac":"tropical","types":["ingress","station","eclipse"],"bodies":["mercury","jupiter","saturn"],"include_moon":false,"aspects":{"conjunction":0.0,"opposition":180.0,"trine":120.0,"square":90.0,"sextile":60.0},"frame":"geocentric apparent, true ecliptic and equinox of date; declinations on the true equator of date","precision":"event times +/- 1 minute (UTC); stations and slow declination crossings are flat, so their minute is the least sharp","eclipses":"solar: shadow-axis geometry from DE440, types by Meeus ch. 54 (gamma, umbral radius u); lunar: Skyfield eclipselib (Danjon-enlarged shadow); time = greatest eclipse","timestamp":"unix seconds of exact_utc (UTC minute), to join on candle open times"},"events":[{"type":"station","body":"mercury","turns":"direct","longitude":262.181091,"position":"22°10'52\" Sagittarius","exact_utc":"2024-01-02T03:08Z","timestamp":1704164880,"key":"station:mercury:direct:2024-01-02T03:08Z"},{"type":"ingress","body":"mercury","into":"Capricorn","from":"Sagittarius","retrograde":false,"exact_utc":"2024-01-14T02:49Z","timestamp":1705200540,"key":"ingress:mercury:Capricorn:2024-01-14T02:49Z"},{"type":"ingress","body":"mercury","into":"Aquarius","from":"Capricorn","retrograde":false,"exact_utc":"2024-02-05T05:10Z","timestamp":1707109800,"key":"ingress:mercury:Aquarius:2024-02-05T05:10Z"}],"counts":{"ingress":15,"station":10,"eclipse":4}},"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":"c3f20fee5ac6ababa1e0d749f4c94ebcc4d82aa4027a97d3638b38365a2d29ff","result_sha256":"d2f1fd36115745e9f4168b194aaa37368701fe2b92cd8edb13a6cc191da25997","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; always paid. POST without payment to receive the 402 challenge.","catalog":"https://astro-agent.dev/v1/catalog"}