Technical Registry
The Complete Celestial Datasheet
Exhaustive listing of all engines, calculation points, and esoteric datasets available via our high-performance endpoints. Now featuring a global database of 138,000+ cities with native timezone resolution.
🌍
WesternPro Elite Engine
High-Precision Swiss EphemerisCore & Natal Calculation
- Planet Positions: Longitude, latitude, speed, and related data for major bodies including Chiron, Lilith, and lunar nodes (see
/api/v1/natal-chartresponse). - Natal wheel SVG:
POST /api/v1/chart/natal-svg(JSONchartorsplitChart→chartWheel+chartGrid; themeslavender/dark/minimal; raw SVG viaformat: "svg").POST /api/v1/chart/synastry-svg— two wheels.POST /api/v1/natal/llm-context— XML for LLM prompts. - Angles & Houses: Ascendant, MC, and full house cusps from Swiss Ephemeris.
- House Systems (Swiss Ephemeris): Placidus, Koch, Equal, Whole Sign, Regiomontanus, Campanus, Porphyry, and Alcabitius—shared Zod schema across natal, advanced, and Vedic house routes.
- Aspects: Major/minor including quintile (72°), biquintile (144°), and septile (~51.43°), plus conjunction through sesquiquadrate (per-type orbs).
- Aspect Patterns: Grand Trine, T-Square, Yod, Grand Cross, Mystic Rectangle, and Stellium (with i18n
patternKeyfor client labels in EN/PT/ES/HI).
Advanced Predictive Tech
- Solar Return:
POST /api/v1/solar-return— return chart for a target year. - Secondary Progressions:
POST /api/v1/progressions— day-for-a-year model with progressed positions. - Transits:
POST /api/v1/transits— natal vs transit sky for a chosen moment. - Annual Forecast (JSON):
POST /api/v1/annual-predictions— optionallang(en/pt/es/hi) for localized copy; month-by-month themes (rich PT sign-specific text; other langs use structured generic themes). - Solar Arc:
POST /api/v1/solar-arc— true solar arc (tropical Sun displacement birth→directed instant); directed longitudes + houses recomputed for the directed UT moment. - Rectification Assist:
POST /api/v1/rectification— scoring assist using life-event timestamps.
Relocational & Fixed Data
- Astrocartography:
POST /api/v1/astrocartography— planetary line mapping for relocation work. - Composite:
POST /api/v1/composite— midpoint relationship chart. - Synastry:
POST /api/v1/synastry— two charts compared. - Eclipses:
POST /api/v1/eclipses— eclipse set for a calendar year. - Fixed Stars & Arabic Parts: Returned in rich natal payloads—conjunctions to catalogued stars and calculated Arabic parts (e.g. Lot of Fortune).
🪷
VedicExpert Supreme (Jyotish)
Jyotish engines (see coordinate model in repo docs)Lunar & Period Systems
- 27 Nakshatras — full catalog i18n:
GET /api/v1/nakshatraswithlang(en/pt/es/hi) and optionalnamefilter returns localizedlord,deity,description,symbol,nature,guna,element,animal,tree,direction,caste,gender,dosha,favorableActivities,unfavorableActivities, andcompatibility(partner labels in the requested language).name/sanskritNameremain stable API keys.POST /api/v1/nakshatramirrors the same fields for any longitude (pluspadaand span). - Panchang (5 limbs): Tithi, Vara, Nakshatra, Yoga, Karana — Yoga uses the classical 27 divisions of the Sun–Moon sum (13°20′ each), including Vajra and Siddhi in canonical order through Vaidhriti. Tithi, weekday, and karana include localized presiding-deity labels; tithi/yoga/karana tables carry EN/PT/ES/HI copy for nature and elective hints.
- Vimshottari Dasha: Complete planetary period cycles (120 years) from Mahadasha to Antardasha and Pratyantardasha precision.
- Chara Dasha (Jaimini): Sign-based periods for timing major events.
- Jaimini Karakas: 7/8 Karaka systems (Atmakaraka, Amatyakaraka, Bhratrukaraka, etc.).
Strengths & Vargas
- 20 Divisional Charts (Vargas): D1 (Rasi), D2 (Hora), D3 (Drekkana), D4 (Chaturthamsa), D7 (Saptamsa), D9 (Navamsa), D10 (Dasamsa), D12, D16, D20, D24, D27, D30, D40, D45, D60 (Shashtiamsa).
- Shadbala System: Sixfold planetary strength calculation (Sthana, Dig, Kala, Chesta, Naisargika, Drik).
- Ashtakavarga System: Detailed Bindu (point) matrix for houses and planets.
- Planetary Yogas & Doshas: Detection of Raja Yogas, Mangal Dosha, Sade Sati phases, and Kaala Sarpa.
- Marital Matching Engine: Advanced Ashtakoot (8-point North Indian) and Dasakoota/Porutham (10-point South Indian) compatibility calculations based on precise lunar longitudes.
- Graha Yuddha & Avasthas: Deep state calculation defining planetary war scenarios and awake/asleep states.
- Argala & Drishti: Deep Vedic aspect mapping and planetary intervention blocking (Argala).
- Vargottama shortcut:
POST /api/v1/vedic/vargottamaandvedicChart.vargottamaonPOST /api/v1/vedic-complete—D1 vs D9 sign parity using the same divisional model asvarga-analysis(see APImethodologyfield).
Counsel & Remedies
- Remedial Measures: Systematic Gemstone prescriptions, Mantra repetitions, Yantra installation, specific Fasting rules, and ritual donations.
- Lal Kitab Engine: Simplified remedies based on planetary house placements.
- Nadi Astrology: Past life karma analysis and spiritual path guidance.
- Tajika (Solar Return): Muntha and Varsheshwar calculations for Vedic yearly forecasting.
- Muhurta (Elective): Identification of auspicious windows for Business, Marriage, Travel, and Construction.
- Prasna (Horary): Actionable answers to specific questions based on the exact time of inquiry.
- Tara Bala & Gochara: Deep transit analysis against the natal Moon and Nakshatra compatibility.
🐉
Chinese Wisdom Engine
Luni-solar & symbolic enginesZodiac & Destiny
- 12 Animals & Elements:
GET /api/v1/chinese/animals,POST /api/v1/chinese/zodiac(year animal + element + profile). - Compatibility:
POST /api/v1/chinese/compatibility— optional detailed narrative. - Horoscope Texts:
POST /api/v1/chinese/horoscope— daily / weekly / monthly / yearly by category. - Yin–Yang:
POST /api/v1/chinese/yin-yang— balance analysis from birth date. - Ba Zi (four pillars):
POST /api/v1/chinese/bazi— year/month/day/hour pillars using Li Chun and solar-term month segments (Swiss Ephemeris Sun longitude);timezoneOffsetMinutesshifts civil local time for the hour pillar. Pillar names returned as Han characters plus localized labels (EN/PT/ES/HI).
I Ching (Book of Changes)
- Daily hexagram:
GET /api/v1/chinese/iching— localized judgment and advice. - Coin consultation:
POST /api/v1/iching/consult— changing lines and full reading (also listed under Esoteric). - 64 hexagrams: Complete symbolic library in the engine backing both routes.
Environment & space
- Kua number:
POST /api/v1/chinese/kua— auspicious directions from birth year and gender. - Chinese numerology:
POST /api/v1/chinese/numerology— birth-date number mapping with localized meanings. - Flying Stars (annual profile):
GET /api/v1/chinese/feng-shuiandPOST /api/v1/chinese/feng-shui— dominant star, directions, colors, tips (localized). Optionalgrid=true/includeGridadds a 9-palace annual numeric grid (順飞 from the center star); monthly sector overlay is documented as approximate—see API description.
🔮
Esoteric Elite Suite
Oracular Data ModelsTarot & Runes
- Tarot (78 cards): Major & Minor Arcana with spreads (single, three-card, Celtic Cross, etc.):
POST /api/v1/tarot/draw - Elder Futhark (24 runes): Single or three-rune casts:
POST /api/v1/runes/draw - I Ching (coins):
POST /api/v1/iching/consult— also referenced under Chinese alongside the daily hexagram route.
Numerology & Palmistry
- Palmistry:
POST /api/v1/palmistry/interpret - Numerology (core):
POST /api/v1/numerology - Numerology (full):
POST /api/v1/numerology/complete— Pythagorean, Chaldean, Vedic, Lo Shu grid, compatibility. - Cabalistic:
POST /api/v1/numerology/cabalistic
📰
AstroText Commercial Suite
AI Localization (4 Langs)Western Zodiac Content
- Daily Horoscopes: Real-time, localized daily advice for all 12 sun signs based on planetary transits.
- Weekly & Monthly Forecasts: Extended trend analysis covering love, career, and spiritual growth.
- Dynamic AI Generation: Context-aware text generation guaranteeing unique daily insights.
Vedic Nakshatra Content
- Nakshatra Daily Guidance: Unique forecasts based on the 27 Nakshatras and current lunar transits.
- Long-Term Cycles: Weekly and monthly predictions integrating Vedic periods and themes.
- Deity-Aligned Advice: Professional, culturally resonant localization tailored to each Nakshatra's presiding deity.
Delivery & Localization
- Multi-Language Native: Fully polished output in English (EN), Portuguese (PT), Spanish (ES), and Hindi (HI).
- Content API: Plug-and-play endpoints
/api/v1/horoscope/:signand/api/v1/vedic-horoscope/:nakshatra. - Edge Caching: Millisecond delivery for requested texts via Redis clustering.
📄
Celestial Professional Reports
High-Fidelity PDF Monograph EnginePDF reports (Puppeteer)
- Natal monograph:
POST /api/v1/reports/natal-pdf— long-form birth analysis. - Daily cosmic snapshot:
POST /api/v1/reports/mini-horoscope— short PDF for the day. - Relationship resonance:
POST /api/v1/reports/matchmaking— two-person compatibility PDF. - Annual forecast PDF:
POST /api/v1/reports/annual-forecast-pdf— same symbolic engine family asPOST /api/v1/annual-predictions, withlangand 24h Redis cache.
Compatibility (JSON APIs)
- Western synastry:
POST /api/v1/synastryandPOST /api/v1/compatibility(Vedic-oriented compatibility on the Vedic routes). - Composite chart:
POST /api/v1/composite— midpoint relationship chart (JSON), separate from the matchmaking PDF above.
Universal Standards
- Global Native Localization: Native support for English (EN), Portuguese (PT), Spanish (ES), and Hindi (HI) with industry-standard terminology.
- Premium White-Label Ready: Professional, clean aesthetic optimized for direct delivery to clients or integration into your own app.
- Celestial Network Perk: Full access included for Mercury, Venus, and Saturn network participants.
🤖
Technical Sovereignty
Enterprise InfrastructureConnectivity & AI
- Universal Agent Native: Optimized celestial context for ChatGPT (via Actions), Claude, Perplexity, and Llama agents.
- HTTP natal context for LLMs:
POST /api/v1/natal/llm-contextreturns compact XML (JSON wrapper or rawapplication/xml)—no MCP required for server-side prompt assembly. - Fastify Framework: Built on the world's fastest Node.js framework for sub-10ms response times.
- Redis Caching: Cluster-ready caching for astronomical calculations that never repeat.
Data & Compliance
- Geo search & timezone:
GET|POST /api/v1/geo/search,POST /api/v1/geo/timezone— large offline city list with coordinates. - White-Label PDF Reports: Full engine to generate beautiful, customizable PDF reports for end-users.
- Zod Safety: 100% type-safe request/response validation with automatic OpenAPI documentation.
Global Reach
- Multi-Language Engine: Deep localization support for English, Portuguese, Spanish, and Hindi across all calculation outputs.
- HMAC & API Security: Enterprise-grade authentication and rate-limiting to protect your keys and bandwidth.
⚙️
Developer Experience (SDK/MCP)
OpenAPI v3.1 / MCP NativeModel Context Protocol
- Universal Discovery: Standard endpoint for tool discovery by any LLM agent or custom GPT.
- Agent Connectivity: Plug directly into Claude Desktop, Cursor, and Zed using the
/api/mcp/list_toolsendpoint. - OpenAI Actions Ready: Feed
/api/v1/openapi.jsoninto ChatGPT or other action runners. - MCP vs HTTP context: MCP
call_toolsuits agent loops;POST /api/v1/natal/llm-contextsuits backends that want a single XML blob for system prompts.
SDK Generation
- Full Definition: Every endpoint is typed and validated with Zod/OpenAPI.
- Client Generation: 100% compatible with
openapi-generator-clifor TS, Python, Go, and more. - Live Docs: Interactive Swagger UI at /docs.
Integration Assets
- OpenAPI JSON: /api/v1/openapi.json
- MCP Discovery: /api/mcp/list_tools