{"uid":"cap_O2NdLJ3RLuloSXGqme329","slug":"astro-agents-western-synastry-api-5a2f98a4","name":"Astro Agents Western Synastry API","description":"Deterministic Western + Vedic astrology API for AI agents: JPL DE440 ephemeris, no LLM, reproducible SHA-256 hashes.","url":"https://astro-agents-api.vercel.app/v1/western/synastry?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["person_a","person_b"],"properties":{"options":{"type":"object","properties":{"orbs":{"type":"object","additionalProperties":{"type":"number","maximum":15,"minimum":0}},"points":{"oneOf":[{"enum":["all"],"type":"string"},{"type":"array","items":{"enum":["sun","moon","mercury","venus","mars","jupiter","saturn","uranus","neptune","pluto","mean_node","true_node","mean_lilith"],"type":"string"}}]},"zodiac":{"enum":["tropical","sidereal"],"type":"string","default":"tropical"},"aspects":{"oneOf":[{"enum":["all"],"type":"string"},{"type":"array","items":{"enum":["conjunction","opposition","trine","square","sextile","quincunx","semisextile","semisquare","sesquiquadrate","quintile","biquintile"],"type":"string"}}]},"ayanamsa":{"enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"type":"string","default":"lahiri"},"house_system":{"enum":["alcabitius","campanus","equal","koch","meridian","morinus","placidus","porphyry","regiomontanus","topocentric","whole_sign"],"type":"string","default":"placidus"},"luminary_orb_bonus":{"type":"number","default":2,"maximum":5,"minimum":0}}},"person_a":{"type":"object","required":["latitude","longitude"],"properties":{"date":{"type":"string"},"time":{"type":"string"},"datetime":{"type":"string"},"latitude":{"type":"number","maximum":90,"minimum":-90},"timezone":{"type":"string"},"longitude":{"type":"number","maximum":180,"minimum":-180},"time_basis":{"enum":["civil","utc","lmt","true_solar"],"type":"string","default":"civil"},"ambiguous_time":{"enum":["earlier","later"],"type":"string","default":"earlier"}}},"person_b":{"type":"object","required":["latitude","longitude"],"properties":{"date":{"type":"string"},"time":{"type":"string"},"datetime":{"type":"string"},"latitude":{"type":"number","maximum":90,"minimum":-90},"timezone":{"type":"string"},"longitude":{"type":"number","maximum":180,"minimum":-180},"time_basis":{"enum":["civil","utc","lmt","true_solar"],"type":"string","default":"civil"},"ambiguous_time":{"enum":["earlier","later"],"type":"string","default":"earlier"}}}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"meta":{"engine":"astro-agents/1.0.0","llm_used":false,"ephemeris":"NASA/JPL DE440 (1800-01-01..2200-01-01)","deterministic":true,"result_sha256":"d73954df219854b1f2ad98476b58986d82ee19cfffc91b8adaea011df6eb4f01"},"endpoint":"western/synastry","result_excerpt":{"aspect_counts":{"harmonious":27,"challenging":28,"conjunctions":11},"cross_aspects":[{"orb":0.192882,"angle":180,"aspect":"opposition","point_a":"a:true_node","point_b":"b:mercury","orb_allowed":8,"exactness_pct":97.6}]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.12","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.12/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.12","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.12","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ql1SXk0aheRi0viBix5by","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.12","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes deterministic Western astrological synastry (compatibility) between two people using the NASA/JPL DE440 ephemeris, returning cross-aspects, orbs, and aspect counts.","exampleAgentPrompt":"Can you run a Western synastry comparison between person A born on June 15, 1990 at 8:30am in New York City (40.71°N, 74.01°W) and person B born on March 22, 1988 at 11:45pm in London (51.51°N, 0.13°W), using Placidus houses and tropical zodiac, and tell me how many harmonious vs challenging aspects they share?","exampleUseCases":[{"title":"Romantic compatibility for a couple","prompt":"My partner and I want to know our astrological compatibility — she was born on April 3, 1992 at 7:15am in Paris (48.85°N, 2.35°E) and I was born on September 14, 1989 at 3:00pm in Chicago (41.88°N, 87.63°W). Can you run a Western synastry with Placidus houses and tropical zodiac and tell me our key cross-aspects?"},{"title":"Business partner chart compatibility","prompt":"I'm considering a business partnership and want to check our synastry — Person A was born January 10, 1985 at 9:00am in Tokyo (35.68°N, 139.69°E) and Person B on July 25, 1980 at 2:30pm in Sydney (33.87°S, 151.21°E). Use whole sign houses and tropical zodiac, and focus on conjunction, opposition, and trine aspects only."},{"title":"Friendship compatibility check","prompt":"Can you check the astrological synastry between me and my best friend? I was born on November 1, 1995 at 6:00am in Berlin (52.52°N, 13.41°E) and she was born on February 14, 1996 at 10:00pm in Madrid (40.42°N, 3.70°W). Use Placidus houses and tropical zodiac — I want to see if we have more harmonious or challenging aspects."}],"resultDescription":"Returns a JSON object containing cross-aspects between the two charts (each with aspect type, angle, orb, orb allowed, and exactness percentage), summary counts of harmonious, challenging, and conjunction aspects, plus metadata including ephemeris source, engine version, determinism flag, and a SHA-256 hash of the result for reproducibility verification.","failureModes":["Missing required latitude/longitude for either person returns validation error","Invalid or out-of-range date/time values cause parsing failure","Unsupported house system or ayanamsa enum value returns schema validation error","Orb values exceeding maximum of 15 degrees are rejected","Ambiguous local time without timezone or time_basis may yield incorrect planetary positions","Dates outside ephemeris range (1800–2200) will fail"],"whenToPreferThis":"Choose this endpoint when you need deterministic, reproducible astrological synastry calculations between two individuals using the NASA/JPL DE440 ephemeris with no LLM involvement — ideal for applications requiring auditable, hash-verifiable results. Prefer this over LLM-based astrology responses when precision, reproducibility, and Western tropical or sidereal methodology matter. Use when you need structured aspect data (orbs, exactness percentages, aspect types) rather than narrative interpretations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:40:55.746Z","isFirstParty":false,"canonicalSlug":"astro-agents-western-synastry-api-5a2f98a4"}