{"uid":"cap_m0RH8sK4kHsdWoGzlKw0T","slug":"astro-agents-western-transits-api-6018535a","name":"Astro Agents - Western Transits 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/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.0","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_vzYu_MoZa8pZ9GI_8Ilrp","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 planetary transit aspects to a natal chart over a specified time window using NASA/JPL DE440 ephemeris, returning exact aspect hits with UTC timestamps.","exampleAgentPrompt":"Look up all major planetary transits hitting my natal chart between January 1 and December 31 2026 — my birth location is 40.7128° N, 74.0060° W, born on March 15 1990 at 10:30 AM civil time in America/New_York timezone, using the Placidus house system and tropical zodiac, including conjunctions, oppositions, trines, and squares.","exampleUseCases":[{"title":"Annual transit forecast for personal chart","prompt":"Give me a full list of transit aspects hitting my natal chart throughout 2026 — I was born on June 21 1985 at 2:15 PM civil time in London (51.5074° N, 0.1278° W, Europe/London timezone). Use the Placidus house system, tropical zodiac, and include all major aspects like conjunctions, squares, trines, and oppositions."},{"title":"Saturn return timing for client report","prompt":"Find all Saturn transit aspects to my client's natal chart from July 2025 through December 2026 — birth data is January 4 1994 at 8:45 AM civil time, born at 34.0522° N, 118.2437° W (Los Angeles, America/Los_Angeles). Use whole sign houses and tropical zodiac, just conjunctions and oppositions, with a 6-degree orb."},{"title":"Vedic sidereal transit lookup with Lahiri ayanamsa","prompt":"Using sidereal zodiac with Lahiri ayanamsa, calculate all planetary transit hits to my natal chart from October 1 to October 31 2026 — my birth coordinates are 28.6139° N, 77.2090° E, born December 10 1988 at 6:00 AM civil time in Asia/Kolkata timezone. Use whole sign houses and include conjunctions, trines, and squares."}],"resultDescription":"Returns a JSON object containing a list of transit aspect hits within the requested window, each with the aspect type (e.g. square, trine), exact UTC datetime, the natal point being aspected, the transiting planet, and whether the transit planet is retrograde. Also includes a total count, engine metadata, ephemeris version, a deterministic flag, and a SHA-256 hash for result reproducibility verification.","failureModes":["Missing required natal latitude or longitude returns validation error","Invalid datetime format causes parsing failure","Window start date after end date returns empty or error response","Requested ayanamsa not in allowed enum returns schema validation error","Orb values outside 0-15 degree range rejected","Unsupported aspect type in array returns validation error","Very long time windows may return large payloads","Payment not included or insufficient USDC returns 402 error"],"whenToPreferThis":"Choose this endpoint when you need deterministic, reproducible planetary transit calculations grounded in the NASA/JPL DE440 ephemeris rather than LLM-generated or approximated astrology. Ideal when you require exact UTC timestamps for transit hits, verifiable SHA-256 hashes for audit trails, support for both tropical and sidereal zodiacs, multiple house systems, and fine-grained orb control. Prefer this over generic astrology chatbots or LLM-based astrological interpretation when precision and reproducibility matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:39:26.306Z","isFirstParty":false,"canonicalSlug":"astro-agents-western-transits-api-6018535a"}