{"uid":"cap_WqAIuea2LGVwyDTwmpkp9","slug":"orrery-astrology-api-20d188de","name":"Orrery Astrology API","description":"Astrology for robots.","url":"https://paradox-box-production.up.railway.app/v1/preview","method":"POST","headers":{},"bodySchema":{"type":"object","required":["when","where"],"properties":{"when":{"type":"string","description":"Local date and time, e.g. '1988-06-14 03:22'."},"where":{"type":"string","description":"Place name to geocode, or [latitude, longitude] to skip geocoding."},"frameworks":{"type":"string","description":"Preset framework ids. Defaults to the standard four way spread. See GET /v1/systems for the full list."},"time_unknown":{"type":"boolean","description":"Set when the birth time is not known. Houses and angles are then unreliable and are reported as such."}}},"responseSchema":{"type":"object","title":"Response Preview V1 Preview Post","additionalProperties":true},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3mWR6p9neotOiyrtKPMxF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes an astrological chart (natal/preview spread) for a given birth or event date/time and location, returning planetary positions, houses, and framework-specific interpretations.","exampleAgentPrompt":"Can you calculate an astrological chart for someone born on June 14, 1988 at 3:22 AM in Chicago, Illinois using the standard four-way spread?","exampleUseCases":[{"title":"Birth chart for a new person","prompt":"Generate an astrological natal chart for someone born on March 22, 1995 at 7:45 PM in London, UK — I want the full four-way spread with houses and planetary positions."},{"title":"Chart with unknown birth time","prompt":"Can you pull an astrology chart for April 5, 1970 in Tokyo, Japan? We don't know the exact birth time, so flag the houses and angles as unreliable."},{"title":"Historical event astrological snapshot","prompt":"What did the sky look like astrologically on July 20, 1969 at 20:17 UTC at coordinates 0.6741° N, 23.4733° E? I want the planetary positions from the standard spread."}],"resultDescription":"Returns a JSON object containing the astrological chart data for the requested date, time, and location — including planetary positions, house cusps, angles, and interpretations according to the selected framework(s). When birth time is unknown, houses and angles are flagged as unreliable.","failureModes":["Missing required fields 'when' or 'where' returns a validation error","Unrecognizable place name that cannot be geocoded returns a geocoding failure","Invalid datetime format for 'when' returns a parse error","Unknown framework ID returns an error or falls back to default spread","Payment not received (x402) results in 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need programmatic, machine-readable astrological chart data (planetary positions, houses, angles) for a specific date/time and location — especially when integrating astrology into an AI pipeline, personalization feature, or automated report. Prefer this over generic astronomy APIs when astrological frameworks and interpretations (not just raw ephemeris data) are needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:33:56.186Z","isFirstParty":false}