{"id":"western/aspects","method":"POST","url":"https://astro-agents-api.vercel.app/v1/western/aspects","price_usd":"0.02","tier":"call","title":"Aspects","summary":"Aspects (with orb, exactness, applying/separating) for a moment, or for any longitudes you supply.","description":"Either give a moment (datetime, optional place) and get the aspects among all planets, or give 'longitudes' {name: degrees} and get the pure geometry. Orbs are explicit and overridable.","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)."},"longitudes":{"type":"object","description":"Optional {name: degrees} or {name: {longitude, speed}}; when given, no ephemeris is used.","additionalProperties":true},"options":{"type":"object","properties":{"house_system":{"type":"string","enum":["alcabitius","campanus","equal","koch","meridian","morinus","placidus","porphyry","regiomontanus","topocentric","whole_sign"],"default":"placidus"},"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical"},"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}}}},"required":[]},"example_request":{"longitudes":{"sun":54.4,"moon":297.4,"saturn":295.2,"venus":12.8}},"example_response":{"endpoint":"western/aspects","result":{"settings":{"aspects":{"types":["conjunction","opposition","trine"],"orbs":{"conjunction":8.0,"opposition":8.0,"trine":7.0,"square":7.0,"sextile":5.0},"luminary_orb_bonus":2.0},"source":"longitudes"},"aspects":[{"point_a":"sun","point_b":"saturn","aspect":"trine","angle":120.0,"orb":0.8,"orb_allowed":9.0,"exactness_pct":91.1},{"point_a":"moon","point_b":"saturn","aspect":"conjunction","angle":0.0,"orb":2.2,"orb_allowed":10.0,"exactness_pct":78.0},{"point_a":"sun","point_b":"moon","aspect":"trine","angle":120.0,"orb":3.0,"orb_allowed":9.0,"exactness_pct":66.7}]},"meta":{"engine":"astro-agents/1.0.1","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":"2cdc593e3cfb8d86604f58a0e70b0ded76974a0e25a362e32797bc132b3e61cf","result_sha256":"d9b6880d14220f7cafea3de8822c09202288b87349b8cd71f67e169591ad39f0","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.0.1; lists shortened to 3 items"},"payment":"x402 or MPP; first calls free. POST without payment to receive the 402 challenge.","catalog":"https://astro-agents-api.vercel.app/v1/catalog"}