{"uid":"cap_Nwr4Aae0cQkk5KTSnODxv","slug":"astro-agents-western-positions-api-cef38fd3","name":"Astro Agents Western Positions API","description":"Planetary positions: Tropical (or sidereal) longitudes, latitudes, speeds and retrograde flags of Sun..Pluto, nodes, Lilith.","url":"https://astro-agent.dev/v1/western/positions?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":[],"properties":{"date":{"type":"string"},"time":{"type":"string"},"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}}},"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.3","llm_used":false,"ephemeris":"NASA/JPL DE440 (1800-01-01..2200-01-01)","deterministic":true,"result_sha256":"269109e17efc86d60897373ac8244ecff90f9c71f9dd1836d848fddba92fcae1"},"endpoint":"western/positions","result_excerpt":{"points":[{"point":"sun","position":"8°19'49\" Libra","retrograde":false,"speed_longitude":0.982927},{"point":"moon","position":"11°02'54\" Gemini","retrograde":false,"speed_longitude":14.283559}]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MMgpctz2bd-pKRmsySCpx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","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 planetary positions and aspects for a given date, time, and location using the NASA/JPL DE440 ephemeris","exampleAgentPrompt":"Calculate the Western astrology planetary positions for someone born on October 1, 1990 at 2:30pm civil time in New York City (latitude 40.7128, longitude -74.0060), using the Placidus house system and tropical zodiac — I want to see where the Sun, Moon, Mercury, Venus, and Mars were, plus any major aspects between them.","exampleUseCases":[{"title":"Natal chart planetary positions","prompt":"Get me the planetary positions for a birth chart: the person was born on March 15, 1985 at 7:45am civil time in London (latitude 51.5074, longitude -0.1278). Use the Placidus house system, tropical zodiac, and show me all planets including the mean node."},{"title":"Current sky snapshot for horoscope app","prompt":"What are the positions of all the planets right now on July 10, 2025 at 12:00pm UTC at latitude 34.0522 and longitude -118.2437? Use the whole sign house system and tropical zodiac, and include all major aspects."},{"title":"Vedic astrology sidereal positions","prompt":"Calculate the sidereal planetary positions for August 22, 1978 at 6:15pm civil time in Mumbai (latitude 19.0760, longitude 72.8777) using the Lahiri ayanamsa and whole sign house system — I need this for a Vedic astrology reading."}],"resultDescription":"Returns a JSON object containing: planetary positions with exact degree/minute/second and zodiac sign, retrograde status and speed for each planet, aspect relationships between planets, house cusp positions, and a SHA-256 hash of the result for reproducibility verification. Also includes metadata confirming no LLM was used and the ephemeris version.","failureModes":["Invalid or out-of-range latitude/longitude returns a validation error","Date outside the ephemeris range (1800-01-01 to 2200-01-01) returns an out-of-range error","Missing required body fields (date/time or datetime) returns a 400 bad request","Invalid timezone string returns a parsing error","Ambiguous DST times may require the ambiguous_time field to be set explicitly","Invalid ayanamsa value for sidereal zodiac returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need deterministic, reproducible astrological calculations backed by the authoritative NASA/JPL DE440 ephemeris rather than LLM-generated approximations. Ideal for applications requiring verifiable outputs (via SHA-256 hash), precise degree-level accuracy, support for both tropical and sidereal zodiac systems, and multiple house system options. Prefer this over AI-generated astrology responses whenever accuracy, auditability, or programmatic processing of chart data is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:41:32.621Z","isFirstParty":false,"canonicalSlug":"astro-agents-western-positions-api-cef38fd3"}