{"uid":"cap_OKWOp4q-c7X5qe22LyQbz","slug":"astro-agents-western-transits-api-20b2f220","name":"Astro Agents Western Transits API","description":"Transits: Transits to a natal chart at a moment, and exact hit times over a window of up to a year.","url":"https://astro-agent.dev/v1/western/transits?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":["natal"],"properties":{"natal":{"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"}}},"window":{"type":"object","properties":{"end":{"type":"string"},"start":{"type":"string"},"include_moon":{"type":"boolean"}}},"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}}},"transit":{"type":"object","properties":{"datetime":{"type":"string"},"timezone":{"type":"string"},"time_basis":{"enum":["civil","utc","lmt","true_solar"],"type":"string","default":"civil"}}}}},"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.3","llm_used":false,"ephemeris":"NASA/JPL DE440 (1800-01-01..2200-01-01)","deterministic":true,"result_sha256":"7e7a7b2568e4629efff09bbaa2b3757bb2da232061273d5aa32beb896236d9f0"},"endpoint":"western/transits","result_excerpt":{"window":{"hits":[{"aspect":"square","exact_utc":"2026-10-02T08:49Z","natal_point":"uranus","transit_point":"sun","transit_retrograde":false},{"aspect":"square","exact_utc":"2026-10-02T17:40Z","natal_point":"jupiter","transit_point":"sun","transit_retrograde":false}],"count":95}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","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.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DYYVCqTEPpkZ3Eq6Xtx4G","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates precise Western astrology transit hits for a natal chart over a specified time window using JPL DE440 ephemeris","exampleAgentPrompt":"What planetary transits will hit my natal chart between January 1 and December 31 2026? I was born on March 15 1985 at 2:30pm civil time in New York City (latitude 40.7128, longitude -74.0060). Show me conjunctions, squares, and oppositions to all natal planets using the Placidus house system and tropical zodiac.","exampleUseCases":[{"title":"Year-ahead transit forecast for personal planning","prompt":"Calculate all major transits to my natal chart for all of 2026 — I was born on June 22 1990 at 8:15am civil time in London (latitude 51.5074, longitude -0.1278). Use Placidus, tropical zodiac, and include conjunctions, oppositions, trines, and squares to all planets."},{"title":"Vedic sidereal transit analysis with Lahiri ayanamsa","prompt":"Using sidereal zodiac with Lahiri ayanamsa, find all transits to my natal chart from November 1 to December 31 2025. My birth details are October 3 1988 at 11:45pm civil time, latitude 28.6139, longitude 77.2090 in New Delhi."},{"title":"Exact timing of Saturn transit over natal moon","prompt":"Find the exact UTC times when Saturn forms a conjunction or square aspect to my natal moon between January 1 2025 and December 31 2027. I was born on September 9 1992 at 3:00pm civil time, latitude 34.0522, longitude -118.2437 in Los Angeles. Use Placidus house system and tropical zodiac."}],"resultDescription":"Returns a list of transit hits within the requested time window, each containing the natal point affected, the transiting planet, the aspect type (e.g. conjunction, square), the exact UTC datetime of the transit's perfection, and whether the transiting planet is retrograde. Also includes a total count of hits and a SHA-256 hash of the result for reproducibility verification, plus ephemeris and engine metadata.","failureModes":["Missing required natal latitude or longitude returns validation error","Invalid datetime format causes parsing failure","Requesting a transit window outside the ephemeris range 1800–2200 returns out-of-range error","Unsupported aspect or point enum value causes schema validation failure","Ambiguous local time without timezone or time_basis specified may produce incorrect results","Payment not included or insufficient USDC causes 402 payment required response"],"whenToPreferThis":"Choose this endpoint when you need deterministic, reproducible Western astrology transit calculations backed by the NASA/JPL DE440 ephemeris rather than LLM-generated or approximated astrology output. Ideal when you need exact UTC timing of planetary aspect perfections, SHA-256 verifiable results, support for multiple house systems (Placidus, Whole Sign, Koch, etc.), tropical or sidereal zodiac options, and fine-grained control over aspect types and orbs. Prefer this over general astrology chatbots when accuracy, auditability, and reproducibility are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:42:09.209Z","isFirstParty":false,"canonicalSlug":"astro-agents-western-transits-api-20b2f220"}