{"id":"western/positions","method":"POST","url":"https://astro-agent.dev/v1/western/positions","price_usd":"0.01","tier":"call","title":"Planetary positions for any date (ephemeris)","summary":"Planetary positions for any date and time (ephemeris): tropical or sidereal longitude, latitude, speed and retrograde flag of the Sun, Moon, Mercury..Pluto, nodes and Lilith.","description":"Geocentric apparent positions from NASA/JPL DE440 for any moment 1800-2200, with sign, degree, element, modality, daily speed and retrograde status. Location is optional (only used to interpret a local time). Options: perspective 'heliocentric' (seen from the Sun) and coordinates 'equatorial' (right ascension, declination, out-of-bounds).","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local civil 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)."},"options":{"type":"object","description":"Optional calculation settings; every default is the common Western convention.","properties":{"house_system":{"type":"string","enum":["alcabitius","campanus","equal","koch","meridian","morinus","placidus","porphyry","regiomontanus","topocentric","whole_sign"],"default":"placidus","description":"House system for cusps and planet houses, e.g. 'placidus' (default) or 'whole_sign'."},"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical","description":"'tropical' (Western, 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."},"points":{"description":"'all' or a list from ['sun', 'moon', 'mercury', 'venus', 'mars', 'jupiter', 'saturn', 'uranus', 'neptune', 'pluto', 'mean_node', 'true_node', 'mean_lilith']. Default: 10 planets + true node + mean Lilith.","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["sun","moon","mercury","venus","mars","jupiter","saturn","uranus","neptune","pluto","mean_node","true_node","mean_lilith"]}}]},"aspects":{"description":"'all' or a list from ['conjunction', 'opposition', 'trine', 'square', 'sextile', 'quincunx', 'semisextile', 'semisquare', 'sesquiquadrate', 'quintile', 'biquintile']. 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"]}}]},"orbs":{"type":"object","additionalProperties":{"type":"number","minimum":0,"maximum":15},"description":"Override orbs per aspect, degrees."},"luminary_orb_bonus":{"type":"number","minimum":0,"maximum":5,"default":2,"description":"Extra orb in degrees for aspects involving the Sun or the Moon. Example: 2."},"perspective":{"type":"string","enum":["geocentric","heliocentric"],"default":"geocentric","description":"'geocentric' (default) or 'heliocentric' (geometric, seen from the Sun: Earth instead of Sun and Moon, no lunar points)."},"coordinates":{"type":"string","enum":["ecliptic","equatorial"],"default":"ecliptic","description":"'ecliptic' (default: longitude/latitude) or 'equatorial': also each point's right ascension, declination, their daily speeds and an out-of-bounds flag."}}}},"required":[]},"example_request":{"datetime":"2026-10-01T12:00:00Z"},"example_response":{"endpoint":"western/positions","result":{"subject":{"time":{"local_input":"2026-10-01T12:00:00Z","time_basis":"civil","timezone":null,"timezone_source":"offset_in_datetime","utc_offset":"+00:00","is_dst":null,"utc":"2026-10-01T12:00:00Z","julian_day_ut":2461315.000001,"julian_day_tt":2461315.000801,"delta_t_seconds":69.091,"time_known":true}},"settings":{"zodiac":"tropical"},"points":[{"point":"sun","name":"Sun","longitude":188.33017,"sign":"Libra","sign_index":6,"degree_in_sign":8.33017,"position":"8°19'49\" Libra","element":"air","modality":"cardinal","latitude":0.000187,"speed_longitude":0.982927,"retrograde":false,"distance_au":1.001186},{"point":"moon","name":"Moon","longitude":71.048302,"sign":"Gemini","sign_index":2,"degree_in_sign":11.048302,"position":"11°02'54\" Gemini","element":"air","modality":"mutable","latitude":5.056642,"speed_longitude":14.283559,"retrograde":false,"distance_au":0.002469},{"point":"mercury","name":"Mercury","longitude":211.339088,"sign":"Scorpio","sign_index":7,"degree_in_sign":1.339088,"position":"1°20'21\" Scorpio","element":"water","modality":"fixed","latitude":-1.80707,"speed_longitude":1.313986,"retrograde":false,"distance_au":1.169303}]},"meta":{"engine":"astro-agents/1.10.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":"34b719359ced9d2d01130742d40810c8dcebdc0abf6c11e22e9161b55c3cd5f6","result_sha256":"269109e17efc86d60897373ac8244ecff90f9c71f9dd1836d848fddba92fcae1","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.10.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"}