{"uid":"cap_T3cP-86cMbxejEVCeV5XO","slug":"orrery-astrology-interpretation-api-db2cddce","name":"Orrery Astrology Interpretation API","description":"Astrology for robots.","url":"https://paradox-box-production.up.railway.app/v1/interpret","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 Interpret Route V1 Interpret Post","additionalProperties":true},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.3","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.3/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.3","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.3","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yFy8mxXh_BzwQEjmp-9Bo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.3","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 interpretation for a given birth date, time, and location, returning planetary positions, house placements, and framework-based readings.","exampleAgentPrompt":"Can you generate an astrological chart interpretation for someone born on June 14, 1988 at 3:22 AM in Chicago, Illinois using the standard four-way spread?","exampleUseCases":[{"title":"Natal chart for personal birth data","prompt":"Interpret the birth chart for someone born on March 21, 1990 at 7:45 PM in London, UK — I want planetary positions and house placements using the default spread."},{"title":"Astrology reading with unknown birth time","prompt":"Can you run an astrological interpretation for someone born on September 3, 1975 in Tokyo, Japan? We don't know the exact birth time, so flag the houses as unreliable."},{"title":"Coordinates-based chart for historical figure","prompt":"Generate an astrological reading for August 26, 1910 at 12:00 noon at coordinates 45.4654, 9.1859 — use the standard framework and give me the full spread."}],"resultDescription":"Returns a structured astrological interpretation object containing planetary positions, house cusps, aspects, and framework-specific readings (e.g. four-way spread). When birth time is unknown, house and angle data are flagged as unreliable. The response is machine-readable JSON with additionalProperties allowed for framework-specific extensions.","failureModes":["Invalid or unrecognizable place name causes geocoding failure","Malformed date-time string causes parsing error","Unknown framework ID returns error or falls back to default","Missing required fields (when or where) returns 422 validation error","Payment not included or insufficient returns 402 Payment Required","Ambiguous location string may resolve to wrong coordinates"],"whenToPreferThis":"Choose this endpoint when you need a programmatic, machine-readable astrological chart interpretation given a birth date, time, and location. It is particularly suited for AI agent pipelines that need structured astrology data rather than a human-formatted horoscope. Prefer it over generic astrology APIs when you want framework-based spread interpretations and reliable geocoding from place names.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:39:59.963Z","isFirstParty":false}