{"id":"western/synastry","method":"POST","url":"https://astro-agents-api.vercel.app/v1/western/synastry","price_usd":"0.12","tier":"premium","title":"Synastry","summary":"Relationship comparison: cross-aspects, house overlays both ways, composite midpoints.","description":"Two natal charts compared: every cross-aspect with orbs, where each person's planets fall in the other's houses, harmonious/challenging counts, and composite (midpoint) positions and angles.","input_schema":{"type":"object","required":["person_a","person_b"],"properties":{"person_a":{"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)."}},"required":["latitude","longitude"]},"person_b":{"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)."}},"required":["latitude","longitude"]},"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}}}}},"example_request":{"person_a":{"datetime":"1990-05-15T14:30","latitude":48.8566,"longitude":2.3522},"person_b":{"datetime":"1992-08-03T09:15","latitude":45.764,"longitude":4.8357}},"example_response":{"endpoint":"western/synastry","result":{"person_a":{"subject":{"time":{"local_input":"1990-05-15T14:30","time_basis":"civil","timezone":"Europe/Paris","timezone_source":"resolved_from_coordinates","utc_offset":"+02:00","is_dst":true,"utc":"1990-05-15T12:30:00Z","julian_day_ut":2448027.020834,"julian_day_tt":2448027.021495,"delta_t_seconds":57.14,"time_known":true,"local_mean_time":"1990-05-15T12:39:24","true_solar_time":"1990-05-15T12:43:06","equation_of_time_minutes":3.7054},"location":{"latitude":48.8566,"longitude":2.3522}},"points":[{"point":"sun","name":"Sun","longitude":54.416197,"sign":"Taurus","sign_index":1,"degree_in_sign":24.416197,"position":"24°24'58\" Taurus","element":"earth","modality":"fixed","latitude":-1.9e-05,"speed_longitude":0.964154,"retrograde":false,"distance_au":1.010905,"house":9},{"point":"moon","name":"Moon","longitude":297.419463,"sign":"Capricorn","sign_index":9,"degree_in_sign":27.419463,"position":"27°25'10\" Capricorn","element":"earth","modality":"cardinal","latitude":-1.124087,"speed_longitude":12.360083,"retrograde":false,"distance_au":0.002643,"house":5},{"point":"mercury","name":"Mercury","longitude":38.009973,"sign":"Taurus","sign_index":1,"degree_in_sign":8.009973,"position":"8°00'36\" Taurus","element":"earth","modality":"fixed","latitude":-2.523528,"speed_longitude":-0.118848,"retrograde":true,"distance_au":0.602159,"house":9}],"angles":{"ascendant":{"longitude":160.24557,"sign":"Virgo","sign_index":5,"degree_in_sign":10.24557,"position":"10°14'44\" Virgo","element":"earth","modality":"mutable"},"midheaven":{"longitude":64.783203,"sign":"Gemini","sign_index":2,"degree_in_sign":4.783203,"position":"4°47'00\" Gemini","element":"air","modality":"mutable"},"descendant":{"longitude":340.24557,"sign":"Pisces","sign_index":11,"degree_in_sign":10.24557,"position":"10°14'44\" Pisces","element":"water","modality":"mutable"},"imum_coeli":{"longitude":244.783203,"sign":"Sagittarius","sign_index":8,"degree_in_sign":4.783203,"position":"4°47'00\" Sagittarius","element":"fire","modality":"mutable"}}},"person_b":{"subject":{"time":{"local_input":"1992-08-03T09:15","time_basis":"civil","timezone":"Europe/Paris","timezone_source":"resolved_from_coordinates","utc_offset":"+02:00","is_dst":true,"utc":"1992-08-03T07:15:00Z","julian_day_ut":2448837.802088,"julian_day_tt":2448837.802768,"delta_t_seconds":58.788,"time_known":true,"local_mean_time":"1992-08-03T07:34:20","true_solar_time":"1992-08-03T07:28:12","equation_of_time_minutes":-6.1364},"location":{"latitude":45.764,"longitude":4.8357}},"points":[{"point":"sun","name":"Sun","longitude":131.200205,"sign":"Leo","sign_index":4,"degree_in_sign":11.200205,"position":"11°12'01\" Leo","element":"fire","modality":"fixed","latitude":-5.9e-05,"speed_longitude":0.957455,"retrograde":false,"distance_au":1.014645,"house":11},{"point":"moon","name":"Moon","longitude":193.764851,"sign":"Libra","sign_index":6,"degree_in_sign":13.764851,"position":"13°45'53\" Libra","element":"air","modality":"cardinal","latitude":-5.01898,"speed_longitude":14.171772,"retrograde":false,"distance_au":0.002477,"house":2},{"point":"mercury","name":"Mercury","longitude":130.450348,"sign":"Leo","sign_index":4,"degree_in_sign":10.450348,"position":"10°27'01\" Leo","element":"fire","modality":"fixed","latitude":-4.877185,"speed_longitude":-0.74787,"retrograde":true,"distance_au":0.599715,"house":11}],"angles":{"ascendant":{"longitude":161.713528,"sign":"Virgo","sign_index":5,"degree_in_sign":11.713528,"position":"11°42'49\" Virgo","element":"earth","modality":"mutable"},"midheaven":{"longitude":67.507493,"sign":"Gemini","sign_index":2,"degree_in_sign":7.507493,"position":"7°30'27\" Gemini","element":"air","modality":"mutable"},"descendant":{"longitude":341.713528,"sign":"Pisces","sign_index":11,"degree_in_sign":11.713528,"position":"11°42'49\" Pisces","element":"water","modality":"mutable"},"imum_coeli":{"longitude":247.507493,"sign":"Sagittarius","sign_index":8,"degree_in_sign":7.507493,"position":"7°30'27\" Sagittarius","element":"fire","modality":"mutable"}}},"settings":{"zodiac":"tropical","house_system":"placidus","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}},"cross_aspects":[{"point_a":"a:true_node","point_b":"b:mercury","aspect":"opposition","angle":180.0,"orb":0.192882,"orb_allowed":8.0,"exactness_pct":97.6},{"point_a":"a:midheaven","point_b":"b:mars","aspect":"conjunction","angle":0.0,"orb":0.287077,"orb_allowed":8.0,"exactness_pct":96.4},{"point_a":"a:mean_lilith","point_b":"b:mean_lilith","aspect":"square","angle":90.0,"orb":0.325766,"orb_allowed":7.0,"exactness_pct":95.3}],"aspect_counts":{"harmonious":27,"challenging":28,"conjunctions":11},"house_overlays":{"a_points_in_b_houses":[{"point":"sun","position":"24°24'58\" Taurus","house":9},{"point":"moon","position":"27°25'10\" Capricorn","house":5},{"point":"mercury","position":"8°00'36\" Taurus","house":9}],"b_points_in_a_houses":[{"point":"sun","position":"11°12'01\" Leo","house":11},{"point":"moon","position":"13°45'53\" Libra","house":2},{"point":"mercury","position":"10°27'01\" Leo","house":11}]},"composite_midpoints":{"points":[{"point":"sun","longitude":92.808201,"sign":"Cancer","sign_index":3,"degree_in_sign":2.808201,"position":"2°48'30\" Cancer","element":"water","modality":"cardinal"},{"point":"moon","longitude":245.592157,"sign":"Sagittarius","sign_index":8,"degree_in_sign":5.592157,"position":"5°35'32\" Sagittarius","element":"fire","modality":"mutable"},{"point":"mercury","longitude":84.23016,"sign":"Gemini","sign_index":2,"degree_in_sign":24.23016,"position":"24°13'49\" Gemini","element":"air","modality":"mutable"}],"angles":{"ascendant":{"longitude":160.979549,"sign":"Virgo","sign_index":5,"degree_in_sign":10.979549,"position":"10°58'46\" Virgo","element":"earth","modality":"mutable"},"midheaven":{"longitude":66.145348,"sign":"Gemini","sign_index":2,"degree_in_sign":6.145348,"position":"6°08'43\" Gemini","element":"air","modality":"mutable"}},"method":"shorter-arc midpoints of each pair of positions"}},"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":"8a915595782b77a68c6846741bda67321452b71797d9ed101f1d901745b1ae84","result_sha256":"d73954df219854b1f2ad98476b58986d82ee19cfffc91b8adaea011df6eb4f01","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"}