Western Astrology API
Ship your astrology app this weekend. Not this quarter.
Production-ready Western astrology API + MCP for AI agents and developers. Natal birth charts, daily/weekly/monthly horoscopes, synastry compatibility scores, composite charts, solar and lunar returns, real-time transit aspects, and moon phases. 4 house systems (Placidus, Koch, Whole Sign, Equal) with accurate tropical ephemeris. 23+ endpoints optimized for horoscope platforms, astrology dating apps, AI chatbots, wellness products, and zodiac content engines. No astronomy expertise needed.
Want to ship faster? Clone a free starter app and go from zero to production in 30 minutes.
Need help getting started? Get free integration guidance from our team.
Key Features
Everything you need from our Western Astrology API, built for production:
Natal birth charts with 4 house systems (Placidus, Koch, Whole Sign, Equal), all major aspects, planetary dignities, and element/modality analysis
Synastry compatibility and composite charts with relationship scoring, aspect patterns, Venus-Mars connections, and partnership dynamics
Daily, weekly, and monthly horoscopes for all 12 zodiac signs with love, career, health, finance forecasts and lucky numbers
Solar returns, lunar returns, and planetary return charts for annual and monthly forecasting with customizable house systems
Real-time transit calculations and transit aspect analysis with current planetary positions, applying/separating aspects, and personalized forecasts
Moon phase tracking with current phase, upcoming phases calendar, and lunar cycle data for wellness, gardening, and ritual timing apps
All 23+ Endpoints
Click any endpoint to view detailed documentation, parameters, and response examples.
Get all zodiac signs - Complete zodiac signs list with dates and elements
Returns all 12 tropical zodiac signs (Aries, Taurus, Gemini, Cancer, Leo, Virgo, Libra, Scorpio, Sagittarius, Capricorn, Aquarius, Pisces) with essential information: name, symbol, element (fire, earth, air, water), date ranges, and short descriptions. Perfect for zodiac sign lists, horoscope widgets, birth chart calculators, astrology apps, star sign selectors, and zodiac reference tools. Use GET /signs/{identifier} for complete zodiac sign profiles with personality traits, compatibility, and detailed characteristics.
Get zodiac sign details - Complete astrology sign profile with personality traits
Retrieve comprehensive zodiac sign information for any astrological sign using lowercase ID (e.g., "aries") or case-insensitive name (e.g., "Aries", "ARIES"). Returns complete astrology profile including: element (fire, earth, air, water), modality (cardinal, fixed, mutable), ruling planet, birth date ranges, personality traits (positive, negative, keywords), zodiac sign descriptions, famous people with this sign, key strengths and qualities, sign motto, greatest gifts, challenges, and secret weapon. Perfect for horoscope readings, zodiac compatibility checks, birth chart interpretations, astrology blogs, star sign personality analysis, and zodiac meaning databases.
Get all planet meanings - Complete astrology planet interpretations list
Returns all 10 astrological planets (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto) with essential meanings: name, symbol, tagline, category (personal/social/generational), ruling sign, and short descriptions. Perfect for astrology reference apps, planet meaning widgets, birth chart interpretation tools, astrology learning platforms, planetary keywords reference, and zodiac planet guides. Use GET /planet-meanings/{identifier} for complete planet profiles with detailed interpretations, keywords, temperature, and dignities (rulership/detriment/exultation/fall).
Get planet meaning details - Complete astrology planet interpretation
Retrieve comprehensive planet interpretation for any astrological planet using lowercase ID (e.g., "sun", "moon") or case-insensitive name (e.g., "Sun", "MOON"). Returns complete astrology meaning including: symbol, tagline, category (personal/social/generational), temperature, orbital period, retrograde status, dignities (rulership/detriment/exultation/fall), positive and negative keywords, and short/long descriptions. Perfect for birth chart readings, planet meaning lookups, astrology education, natal chart interpretation, transit meanings, planetary symbolism reference, and keyword-based interpretations.
Generate natal chart - Birth chart calculator API with houses and aspects
Calculate complete Western astrology natal chart (birth chart) with tropical zodiac. Returns all 10 planetary positions (Sun through Pluto), 12 house cusps with customizable house systems (Placidus, Whole Sign, Equal, Koch), major and minor aspects, Ascendant, Midheaven, dominant elements and modalities. Perfect for astrology apps, birth chart generators, horoscope websites, and astrological consultation tools. Accurate ephemeris data from NASA JPL.
Get planetary positions - Ephemeris calculator for all planets
Calculate accurate tropical zodiac positions for all 10 planets (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto) for any date, time, and location. Returns longitude, latitude, zodiac sign, degree within sign, daily motion speed, and retrograde status. Perfect for transit tracking, ephemeris tables, astrology apps, and planetary position widgets. NASA JPL ephemeris accuracy.
Get current moon phase - Lunar phase calculator with zodiac sign
Get current moon phase with illumination percentage, lunar age (days since new moon), zodiac sign, and distance from Earth. Returns phase name (New Moon, Waxing Crescent Moon, First Quarter Moon, Waxing Gibbous Moon, Full Moon, Waning Gibbous Moon, Last Quarter Moon, Waning Crescent Moon) plus exact lunar position. Perfect for moon tracking apps, lunar calendars, astrology widgets, and gardening by moon phase tools.
Get upcoming moon phases - Next new moon, full moon, quarters
Get upcoming moon phase transitions (New Moon, First Quarter, Full Moon, Last Quarter) for the next weeks/months. Returns dates and phase names for each lunar quarter. Perfect for lunar event calendars, moon phase widgets, and astrology planning tools.
Get lunar calendar - Moon phases for entire month
Get complete lunar calendar showing moon phase and illumination for every day of a specific month. Perfect for creating moon phase calendars, lunar planners, and astrology event schedules.
Calculate synastry - Relationship compatibility analysis API
Calculate complete synastry (relationship compatibility) between two natal charts using Western tropical astrology. Analyzes inter-chart aspects between all planets to determine romantic, friendship, and karmic compatibility. Returns compatibility score (0-100), detailed inter-aspects with strength ratings, harmonious vs challenging aspect counts, and relationship dynamics analysis. Perfect for dating apps, matrimonial sites, relationship counseling tools, and astrology compatibility features. Based on professional astrological techniques.
Calculate house cusps - House system calculator with comparison
Calculate astrological house cusps using Placidus, Whole Sign, Equal, or Koch house systems. Returns all 12 house cusps with zodiac signs, degrees, Ascendant, and Midheaven. Use "all" parameter to compare all 4 house systems side-by-side. Perfect for astrology charts, house cusp tables, and educational tools showing house system differences. Includes accurate Ascendant and MC calculations.
Calculate planetary aspects - Aspect finder for any date and time
Calculate all major and minor aspects between planets for any date and time. Finds conjunctions (0°), oppositions (180°), trines (120°), squares (90°), sextiles (60°), and minor aspects. Returns aspect type, exact angle, orb, applying/separating status, and strength (0-100). Filter by specific planets or aspect types. Perfect for aspect tables, transit analysis, and aspect pattern detection. Uses standard Western astrology orbs.
Calculate planetary transits - Current transits with natal chart comparison
Calculate current or future planetary transits (positions of all planets now). Optionally compare transits to natal chart to find transit-to-natal aspects. Returns all 10 planet positions with signs, degrees, and speeds. When natal chart provided, includes transit aspects (transiting Sun conjunct natal Mars, etc.) with orbs and applying/separating status. Perfect for daily transit forecasts, aspect alerts, and personalized transit reports.
Transit Aspects - Detailed transit-to-natal aspect analysis with interpretations
Calculate all transit-to-natal aspects with detailed interpretations, strength ratings, and timing guidance. Compares current (or future) planetary positions against your natal chart to identify active transits. Returns aspect type, orb, applying/separating status, narrative interpretation, impact rating, and practical guidance for each transit. Supports planet and aspect-type filtering. More detailed than the /transits endpoint — includes AI-friendly interpretation fields. Transit aspects API, transit-to-natal analysis, predictive astrology, personalized transit forecast.
Solar Return Chart - Annual birthday forecast with relocated chart
Generate a solar return chart for any year — the foundational technique for annual astrological forecasting. The chart is cast for the exact moment the transiting Sun returns to its natal ecliptic longitude (your astrological birthday). Returns full tropical zodiac chart with planetary positions, house cusps, aspects, Ascendant, and Midheaven. Location-sensitive: relocating your solar return chart to a different city changes the houses and Ascendant. Solar return chart API, annual horoscope forecast, birthday chart calculator, yearly astrology prediction, relocated solar return.
Lunar Return Chart - Monthly emotional forecast with Moon cycle chart
Generate a lunar return chart for any month — cast for the exact moment the transiting Moon returns to its natal ecliptic longitude. The Moon completes one sidereal orbit every ~27.3 days, making this the primary technique for monthly astrological forecasting. Returns full tropical zodiac chart with planetary positions, house cusps, aspects, Ascendant, and Midheaven. Reveals emotional patterns, domestic focus, and intuitive themes for the coming month. Lunar return chart API, monthly horoscope forecast, Moon cycle chart, emotional astrology prediction.
Composite Chart - Midpoint relationship chart with interpretations
Generate a composite chart by calculating midpoints between two natal charts. The composite chart represents the relationship as a single entity, showing its core identity, emotional bond, communication style, and growth direction. Returns composite planetary positions, house cusps, Ascendant, Midheaven, aspects, and relationship interpretation. Composite chart API, midpoint chart calculator, relationship astrology, couple chart analysis.
Compatibility Score - Relationship compatibility analysis with category breakdown
Calculate a detailed compatibility score between two birth charts using Western synastry (inter-chart aspects). Returns overall score (0-100) plus category breakdowns for romantic, emotional, intellectual, physical, and spiritual compatibility. Each category analyzes specific planetary pairs: Venus-Mars for romance, Moon-Moon for emotions, Mercury-Mercury for intellect. Includes relationship strengths, challenges, and narrative interpretation. Compatibility score API, love match calculator, relationship astrology, synastry score.
Daily horoscope by zodiac sign - Transit-based forecast
Get today's daily horoscope for any zodiac sign. Forecast is generated from real-time planetary transits through the sign, covering love, career, health, finance, and general outlook. Returns lucky number, lucky color, and compatible signs. Daily horoscope API, zodiac forecast, sun sign horoscope, astrology prediction.
All zodiac signs daily horoscope - Batch forecast for all 12 signs
Retrieve daily horoscope forecasts for all 12 zodiac signs in a single request. More efficient than making 12 individual sign requests. Each sign includes love, career, health, finance, lucky number, lucky color, and compatible signs. Bulk horoscope API, all signs daily forecast, zodiac horoscope feed.
Weekly horoscope by zodiac sign - 7-day transit forecast
Get weekly horoscope for any zodiac sign. Forecast covers a full 7-day period based on planetary transits through the sign, with love, career, health, finance guidance plus lucky days, lucky numbers, and compatible signs. Weekly horoscope API, zodiac weekly forecast, astrology weekly prediction.
Monthly horoscope by zodiac sign - 30-day transit forecast
Get monthly horoscope for any zodiac sign with week-by-week breakdown and key dates. Based on planetary transits through the sign, covering love, career, health, and finance for the entire month. Includes important astrological dates and lucky numbers. Monthly horoscope API, zodiac monthly forecast, astrology monthly prediction.
Planetary Return Chart - Saturn return, Jupiter return, and inner planet cycles
Generate a planetary return chart for Mercury, Venus, Mars, Jupiter, or Saturn. A planetary return occurs when a transiting planet conjuncts its natal longitude, marking the beginning of a new cycle. Saturn return (~29 years) is the most significant life milestone in Western astrology. Jupiter return (~12 years) signals expansion and growth phases. Mars return (~2 years) resets energy and drive. Returns full tropical zodiac chart with all planetary positions, house cusps, and aspects. Planetary return chart API, Saturn return calculator, Jupiter return chart, Mars return forecast.
What You Can Build with Western Astrology API
Real-world applications and use cases for integrating Western Astrology API into your projects:
Launch natal chart apps with professional-grade accuracy — birth charts, planet positions, house placements, aspects, and element analysis ready for your UI in days
Add zodiac compatibility scoring to dating apps — synastry analysis, composite charts, and compatibility scores with detailed relationship dynamics
Ship personalized horoscope platforms — daily, weekly, and monthly forecasts for all 12 signs with love, career, health, and finance categories
Build AI astrology chatbots with MCP — your OpenAI, Claude, or Gemini agent auto-discovers and calls all 23+ astrology endpoints with zero integration code
Power wellness and lifestyle apps with real-time transits, moon phase calendars, solar returns, and planetary movement alerts for self-discovery features
Create astrology content engines — automated zodiac content, horoscope newsletters, transit alerts, and seasonal forecasts at scale
Getting Started with Western Astrology API
Start building in under 2 minutes. No signup required.
Next Steps
| Get your API key | View Plans |
| Explore the API | View Docs |
AI-Native Integration
MCPFirst-class Model Context Protocol support for AI agents and autonomous applications
Start Using Western Astrology API Today
Ship your astrology app this weekend. Not this quarter.
Choose a plan and get your API key instantly delivered to your email. No credit card required for testing. Pay-as-you-go pricing with 23+ endpoints included.
View Pricing & Get API Key