Popular

Western Astrology API

Ship your astrology app this weekend. Not this quarter.

Natal ChartHoroscopeSynastryCompatibilityTransitMoon PhaseAstrocartographyRelocation ChartLocal SpaceFixed StarsArabic PartsAsteroidsBlack Moon LilithProgressionsSolar ArcProfections …and so much more

<50mslatency
99.9%uptime

Start building in seconds.

Want to try without writing code? Try this domain live in API playground →

Terminal
npm install @roxyapi/sdk
import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.astrology.get(/* ... */)
SDK docs

Want to ship faster? Clone a free template and go from zero to production in 30 minutes.

Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app in minutes.

Building on WordPress? Install the RoxyAPI plugin and drop a shortcode, no code required.

POST /api/v2/astrology/natal-chart
{
  "birthDetails": {
    "date": "1990-07-15",
    "time": "13:30:00",
    "latitude": 40.7128,
    "longitude": -74.006,
    "timezone": -5
  },
  "planets": [
    {
      "name": "Sun",
      "longitude": 113.01012297464763,
      "latitude": -0.000023757319263795868,
      "sign": "Cancer",
      "degree": 23.01012297464763,
      "speed": 0.9541023962147364,
      "isRetrograde": false,
      "house": 9,
      "interpretation": {
        "summary": "Your Sun in Cancer in The Ninth House reveals how you express self-awareness and ego with intuitive and nurturing energy in the realm of exploration.",
        "detailed": "Sun represents self-awareness and ego. In Cancer (Crab), this energy becomes intuitive, nurturing, protective. Located in The Ninth House, you direct this Cancer Sun energy toward exploration and religious beliefs and personal philosophy. This creates a unique expression where your self-awareness and ego naturally manifests through intuitive, nurturing, protective approaches in matters related to the ninth house.",
        "keywords": [
          "active",
          "awareness",
          "bright",
          "confidence",
          "consciousness",
          "intuitive",
          "nurturing",
          "protective"
        ]
      }
    },
    {
      "name": "Moon",
      "longitude": 27.069104206098757,
      "latitude": 5.181836887962161,
      "sign": "Aries",
      "degree": 27.069104206098757,
      "speed": 14.229731173744796,
      "isRetrograde": false,
      "house": 6,
      "interpretation": {
        "summary": "Your Moon in Aries in The Sixth House reveals how you express inner emotional life with ambitious and independent energy in the realm of work and job.",
        "detailed": "Moon represents inner emotional life. In Aries (Ram), this energy becomes ambitious, independent, impatient. Located in The Sixth House, you direct this Aries Moon energy toward work and job and techniques and methods. This creates a unique expression where your inner emotional life naturally manifests through ambitious, independent, impatient approaches in matters related to the sixth house.",
        "keywords": [
          "caretaker",
          "comfort",
          "emotion",
          "feeling",
          "femininity",
          "ambitious",
          "independent",
          "impatient"
        ]
      }
    }
  ],
  "houses": [
    {
      "number": 1,
      "longitude": 216.94758165419276,
      "sign": "Scorpio",
      "degree": 6.9475816541927315
    },
    {
      "number": 2,
      "longitude": 245.70493298442574,
      "sign": "Sagittarius",
      "degree": 5.704932984425795
    },
    {
      "number": 3,
      "longitude": 278.86478584928255,
      "sign": "Capricorn",
      "degree": 8.864785849282498
    },
    {
      "number": 4,
      "longitude": 314.37573350548865,
      "sign": "Aquarius",
      "degree": 14.375733505488597
    }
  ],
  "houseSystem": "placidus",
  "aspects": [
    {
      "planet1": "North Node",
      "planet2": "South Node",
      "type": "OPPOSITION",
      "angle": 180,
      "orb": 0,
      "isApplying": false,
      "strength": 100,
      "interpretation": "challenging"
    },
    {
      "planet1": "Sun",
      "planet2": "Jupiter",
      "type": "CONJUNCTION",
      "angle": 0,
      "orb": 0.39442371250532915,
      "isApplying": false,
      "strength": 95.06970359368339,
      "interpretation": "neutral"
    },
    {
      "planet1": "Jupiter",
      "planet2": "Saturn",
      "type": "OPPOSITION",
      "angle": 180,
      "orb": 0.6778443722118368,
      "isApplying": false,
      "strength": 91.52694534735204,
      "interpretation": "challenging"
    },
    {
      "planet1": "Mercury",
      "planet2": "North Node",
      "type": "OPPOSITION",
      "angle": 180,
      "orb": 0.804916363861139,
      "isApplying": false,
      "strength": 89.93854545173576,
      "interpretation": "challenging"
    },
    {
      "planet1": "Mercury",
      "planet2": "South Node",
      "type": "CONJUNCTION",
      "angle": 0,
      "orb": 0.804916363861139,
      "isApplying": false,
      "strength": 89.93854545173576,
      "interpretation": "neutral"
    },
    {
      "planet1": "Mercury",
      "planet2": "Uranus",
      "type": "QUINCUNX",
      "angle": 150,
      "orb": 0.33677933831427254,
      "isApplying": false,
      "strength": 88.77402205619092,
      "interpretation": "neutral"
    }
  ],
  "ascendant": {
    "longitude": 216.94758165419276,
    "sign": "Scorpio",
    "degree": 6.9475816541927315
  },
  "midheaven": {
    "longitude": 134.37573350548865,
    "sign": "Leo",
    "degree": 14.375733505488654
  },
  "partOfFortune": {
    "sign": "Leo",
    "degree": 11.006562885643916,
    "longitude": 131.00656288564392,
    "sect": "day"
  },
  "vertex": {
    "longitude": 77.23573150642028,
    "sign": "Gemini",
    "degree": 17.23573150642028
  },
  "patterns": [
    {
      "kind": "T_SQUARE",
      "name": "T-Square",
      "planets": [
        "Moon",
        "Sun",
        "Saturn"
      ],
      "apex": "Moon",
      "modality": "cardinal",
      "dissociate": false,
      "tightness": 61,
      "interpretationKey": "aspectPattern.tSquare",
      "interpretationVars": {
        "apex": "Moon",
        "apexSign": "Aries",
        "end1": "Sun",
        "end2": "Saturn"
      },
      "interpretation": "T-Square focused on Moon in Aries, tension between Sun and Saturn demands resolution at the apex, the primary growth engine of the chart."
    },
    {
      "kind": "T_SQUARE",
      "name": "T-Square",
      "planets": [
        "Moon",
        "Jupiter",
        "Saturn"
      ],
      "apex": "Moon",
      "modality": "cardinal",
      "dissociate": false,
      "tightness": 62,
      "interpretationKey": "aspectPattern.tSquare",
      "interpretationVars": {
        "apex": "Moon",
        "apexSign": "Aries",
        "end1": "Jupiter",
        "end2": "Saturn"
      },
      "interpretation": "T-Square focused on Moon in Aries, tension between Jupiter and Saturn demands resolution at the apex, the primary growth engine of the chart."
    }
  ],
  "aspectsInterpretation": {
    "summary": "Your chart contains 37 aspects: 7 harmonious, 17 challenging, and 13 neutral. This creates a balanced overall pattern. The balanced mix of aspects suggests a well-rounded chart with both natural talents and growth opportunities.",
    "dominant": "balanced",
    "harmonious": 7,
    "challenging": 17,
    "neutral": 13
  },
  "summary": {
    "dominantElement": "Water",
    "dominantModality": "Cardinal",
    "retrogradePlanets": [
      "Saturn",
      "Uranus",
      "Neptune",
      "Pluto",
      "North Node",
      "South Node"
    ],
    "elementDistribution": {
      "Fire": 3,
      "Earth": 4,
      "Air": 2,
      "Water": 5
    },
    "modalityDistribution": {
      "Cardinal": 7,
      "Fixed": 6,
      "Mutable": 1
    }
  }
}

Structured JSON with documented fields. Not hallucinated text. See all endpoints

Works with your stack

Claude CodeCursorAntigravityChatGPTWindsurfVS Code CopilotOpenAI AgentsGeminiLangChainCrewAIVercel AI SDK

Western astrology API for natal birth charts, daily, weekly, and monthly horoscopes with unique content per sign, 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, aspect-pattern detection (Grand Trine, T-Square, Yod), astrocartography planetary lines, relocation charts, and local space maps for location based astrology, plus classical and professional points like fixed star conjunctions, Arabic lots, the asteroid goddesses (Ceres, Pallas, Juno, Vesta), mean and true Black Moon Lilith, and timing techniques like secondary progressions, solar arc directions, and annual profections. Built for horoscope platforms, astrology dating apps, AI chatbots, wellness products, and zodiac content engines. Schedule future horoscopes with a date parameter for editorial workflows, no astronomy expertise needed. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.

Every Western Astrology calculation is verified against NASA JPL Horizons across 828 gold-standard tests, with a public MIT benchmark repo anyone can clone and re-run. See how we test.

Multi-language API responses

EnglishDeutschEspanolFrancaisHindiPortuguesRusskiyTurkce

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) covering all 14 celestial bodies (the 10 classical planets, the lunar nodes, Chiron, and Black Moon Lilith), the Ascendant, Midheaven, Part of Fortune, and Vertex, 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

Publisher-grade daily, weekly, and monthly horoscopes with unique content per sign via whole-sign house system. Love, career, health, finance, advice sections, active transits, Moon data, energy rating, and date scheduling for editorial workflows

Solar returns, lunar returns, and planetary return charts for annual and monthly forecasting with customizable house systems

Detect classical aspect configurations including Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, and Stellium with apex identification, element and modality coherence, dissociate flagging, and tightness scoring for chart pattern callouts

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

Astrocartography planetary line maps, relocation charts, and local space directions for location based astrology, showing where each planet turns angular across the world, how the angles and houses shift for any city, and which compass directions carry each planet energy from your birthplace

Classical and traditional points: precessed fixed star positions with conjunctions to natal planets and angles (Regulus, Spica, Algol, and the royal and Behenian stars), and the Hermetic Arabic lots (Part of Fortune, Spirit, Eros, Necessity, Courage, Victory, Nemesis) computed by day and night sect

The asteroid goddesses (Ceres, Pallas, Juno, Vesta) and both Black Moon Lilith calculations (mean and true lunar apogee), the feminine-archetype and professional points that round out a serious natal reading beyond the ten planets

Predictive timing techniques: secondary progressions (the day-for-a-year progressed chart), solar arc directions, and annual profections with the traditional lord of the year, the methods professional astrologers use to time the unfolding of a life

All Endpoints

Click any endpoint to view detailed documentation, parameters, and response examples.

Get all zodiac signs - Complete zodiac signs list with dates and elementsReturns 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/{id} for complete zodiac sign profiles with personality traits, compatibility, and detailed characteristics.Get zodiac sign details - Complete astrology sign profile with personality traitsRetrieve 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 listReturns all 14 astrological bodies (the 10 classical planets Sun through Pluto, the lunar nodes, Chiron, and Black Moon Lilith) 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/{id} for complete profiles with detailed interpretations, keywords, temperature, and dignities (rulership/detriment/exaltation/fall).Get planet meaning details - Complete astrology planet interpretationRetrieve 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/exaltation/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 aspectsCalculate complete Western astrology natal chart (birth chart) with tropical zodiac. Returns all 14 celestial bodies (the 10 classical planets Sun through Pluto, the lunar nodes, Chiron, and Black Moon Lilith), 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. Verified against NASA JPL Horizons.Get planetary positions - Ephemeris calculator for all planetsCalculate accurate tropical zodiac positions for all 14 celestial bodies (the 10 classical planets Sun through Pluto, the lunar nodes, Chiron, and Black Moon Lilith) 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. Verified against NASA JPL Horizons.Get current moon phase - Lunar phase calculator with zodiac signGet 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, quartersGet 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 monthGet 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 APICalculate 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 comparisonCalculate 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 timeCalculate 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.
Show all endpoints
Detect aspect patterns - Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, StelliumIdentify classical Western astrology multi-planet configurations in a birth chart. Returns Grand Trines (with element), Kites (with apex), T-Squares (with apex and modality), Grand Crosses (with modality), Yods (Finger of Fate, with apex), Mystic Rectangles, and Stelliums. Each pattern carries a tightness score (0-100), dissociate flag for out-of-sign configurations, and a one-line interpretation suitable for chart reports. Disambiguation is built in: a Grand Cross suppresses its contained T-Squares, a Kite suppresses its underlying Grand Trine. Useful for personalized natal report engines, astrology chatbots, AI agents that interpret chart geometry, and editorial chart-pattern callouts.Calculate planetary transits - Current transits with natal chart comparisonCalculate current or future planetary transits (positions of all bodies now). Optionally compare transits to natal chart to find transit-to-natal aspects. Returns all 14 celestial bodies (the 10 classical planets, the lunar nodes, Chiron, and Black Moon Lilith) 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 interpretationsCalculate 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 chartGenerate 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 chartGenerate 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 interpretationsGenerate 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 breakdownCalculate 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 Sun, Moon, Venus, and Mars sign compatibility narratives, element balance analysis, relationship archetype classification, and the most significant inter-chart aspects with relationship-specific interpretations.Daily horoscope by zodiac sign - Transit-based forecast with house activationsGet the daily horoscope for any zodiac sign. Forecast is generated from real-time planetary transits using whole-sign house positions, so every sign receives unique content. Returns love, career, health, finance, overview with active transits, Moon sign, Moon phase, energy rating, lucky number, lucky color, and compatible signs. Supports date parameter for editorial scheduling. Daily horoscope API, zodiac forecast, sun sign horoscope, astrology prediction.Weekly horoscope by zodiac sign - 7-day transit forecastGet weekly horoscope for any zodiac sign. Forecast covers a full 7-day period based on planetary transits with house-based content unique to each 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 with key datesGet monthly horoscope for any zodiac sign with sign-specific week-by-week breakdown and real lunar phase key dates. Based on planetary transits with house activations unique to each sign, covering love, career, health, and finance for the entire month. Key dates include actual New Moon, Full Moon, and retrograde dates from ephemeris calculations. Monthly horoscope API, zodiac monthly forecast, astrology monthly prediction.Planetary Return Chart - Saturn return, Jupiter return, and inner planet cyclesGenerate 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.Astrocartography map - planetary lines and relocation calculatorGenerate an astrocartography map of Midheaven, Imum Coeli, Ascendant, and Descendant planetary lines for any birth moment. Each line marks where a planet turns angular across the world, the core of relocation astrology and astro mapping. Returns right ascension, declination, the two meridian line longitudes, and sampled rising and setting curves ready to plot, with a short interpretation per line.Generate relocation chart - Relocated birth chart calculator with shifted houses and anglesCalculate a relocation chart (relocated birth chart) for a new place on Earth. The birth moment stays the same, so every planet keeps its natal sign and degree, while the Ascendant, Midheaven, Vertex, and all twelve house cusps are recomputed for the new latitude and longitude. Returns the relocated houses and angles, the planets that change house, the angular planets activated at the new place, and the distance and compass direction from the birthplace. Built for relocation astrology readings, astrocartography style move planning, and travel charts. Verified against NASA JPL Horizons.Local space astrology map - Directional planetary compass linesGenerate a local space astrology map that projects the natal planets onto the local horizon as compass directions and great-circle lines radiating from the birthplace. Returns each body azimuth (degrees clockwise from true north), altitude, 16-point compass direction, whether it sits above the horizon, and the latitude and longitude waypoints of its directional line. Ideal for relocation planning, directional astrology, and travel-direction maps.Fixed stars and star conjunctions calculator - Regulus, Spica, Algol natal reportCalculate the tropical zodiac positions of the major named fixed stars for any birth moment, including the four Royal stars and the fifteen Behenian stars, then detect conjunctions to the natal planets, Ascendant, and Midheaven. Each star returns its precessed ecliptic longitude, zodiac sign, visual magnitude, and traditional planetary nature, with a plain language interpretation for every conjunction inside the chosen orb. A focused tool for natal reports that weigh Regulus, Spica, Aldebaran, Antares, and Algol against the chart.Arabic lots calculator - seven Hermetic parts including Part of Fortune and SpiritCalculate the seven Hermetic lots (Arabic parts) for any birth moment: Part of Fortune, Part of Spirit, Eros, Necessity, Courage, Victory, and Nemesis. Each lot is a sensitive point projected by arc from the Ascendant, with the day or night formula applied automatically from the chart sect. Returns the zodiac sign, degree, exact longitude, the arc used, and a plain language interpretation per lot, for Hellenistic and traditional astrology apps. Built on accurate tropical chart positions, no astronomy expertise needed.Asteroid goddesses calculator - Ceres, Pallas, Juno, and Vesta natal positionsCalculate the natal positions of the four classical asteroid goddesses, Ceres, Pallas, Juno, and Vesta, for any birth moment. Each asteroid returns its tropical zodiac sign, degree, house placement, daily speed, retrograde status, and a plain language interpretation of its meaning in the chart. Chiron is available through the natal chart endpoint, so this endpoint stays focused on the four asteroid goddesses for natal reports and relationship astrology.Black Moon Lilith calculator - mean and true lunar apogee in the natal chartCalculate Black Moon Lilith for any birth chart, both the mean lunar apogee, the steady and most widely used point, and the true or osculating apogee, the exact position that can shift sign and turn retrograde. Returns the zodiac sign, degree, house, ecliptic longitude and latitude, daily speed, retrograde flag, and a plain language interpretation for each variant. Built for natal astrology apps and AI agents exploring the wild, suppressed, and reclaimed self that Lilith represents.Secondary progressions calculator - progressed chart, progressed Sun and MoonGenerate the secondary progressed chart for any date using the day-for-a-year key, where each day of ephemeris motion after birth stands in for one year of life. Returns every progressed body with its sign, degree, whole-sign house, motion, and retrograde state, plus the progressed Ascendant and Midheaven via the Naibod arc. The progressed Sun and progressed Moon are the headline timing markers for inner growth and emotional chapters. Secondary progressions API, progressed chart calculator, progressed Sun and Moon, progressed Ascendant and Midheaven.Solar arc directions calculator - directed chart at one degree per yearCalculate a solar arc directed chart for any birth moment and target date. The solar arc is the secondary-progressed Sun longitude minus the natal Sun longitude, about one degree for each year of life, and every natal point including the Ascendant and Midheaven is advanced forward by that same arc. Returns the solar arc, each directed point with its natal and directed longitude, zodiac sign, degree, and a plain language interpretation, for predictive astrology apps timing major life events. Built on accurate tropical chart positions, no astronomy expertise needed.Annual profections calculator - lord of the year and yearly time lord by ageCalculate the annual profection and lord of the year for any birth chart and target date using the Hellenistic time lord technique. Each completed year of life advances the rising sign by one whole sign house, activating a new profected house, profected sign, and ruling planet that sets the tone of the year. Returns the age, profected house and sign, the lord of the year with its natal sign and house placement, and a plain language interpretation for traditional and Hellenistic astrology apps.

Drop-in UI components

Render Western Astrology responses without building charts yourself. These open source, framework-agnostic web components take the typed API response and draw it, in React, Vue, Svelte, Angular, plain HTML, and WordPress.

MIT licensedFramework agnosticThemeable via CSS variablesjsDelivr CDN
ElementRenders
<roxy-natal-chart>Natal chart wheel with planet glyphs and aspect lines
<roxy-synastry-chart>Dual-wheel synastry with inter-aspects table
<roxy-western-planets-table>Sign, degree, house, motion columns plus ASC, MC, PoF, Vertex
<roxy-transits-table>Transit planet positions plus optional aspects to a natal chart
<roxy-aspects-table>Aspect rows coloured by nature with orb and strength, plus detected chart patterns
<roxy-moon-phase>Moon phase card and calendar
<roxy-horoscope-card>Daily, weekly, or monthly horoscope card
<roxy-astrocartography-map>World map of planetary MC, IC, Ascendant, and Descendant lines with per-line interpretations
Show all components
<roxy-local-space-compass>Compass dial of planetary azimuth lines from the birthplace, dimmed below the horizon
<roxy-relocation-wheel>Relocated chart wheel plus the move geometry, angular planets, and planets that change house
<roxy-positions-table>Body, sign, degree, and per-shape columns (house, motion, formula, or natal arc) plus each reading
<roxy-fixed-stars>Star to natal point conjunctions with readings, plus a catalog of position, magnitude, nature, and keywords
<roxy-profection-card>Profected house and sign for the year, the lord of the year, its natal placement, and the reading
<roxy-compatibility-card>Score card with category breakdown
<roxy-reference-card>Symbol, name, description, keyword chips, and an attribute grid for any glossary lookup

Free Templates for Western Astrology

Clone. Edit. Ship. Free and open source by Team Roxy.

AI astrology chatbot template with MCP integration, horoscope, tarot, numerology, birth chart, and Vedic astrology powered by RoxyAPI

AI Astrology Chatbot

Web App / Open Source30 min

AI chatbot with real readings across all spiritual domains. Not hallucinations.

AstrologyVedicTarotNumerologyCrystalsDreamsI-ChingAngel Numbers
AI spiritual voice assistant template with embeddable voice widget for astrology, tarot, numerology, and Vedic readings powered by RoxyAPI

AI Spiritual Voice Assistant

Web App / Open Source30 min

Talk to the stars. Real readings across every spiritual domain, spoken aloud.

VoiceAstrologyVedicTarotNumerologyHuman Design
Western astrology template with natal birth chart, zodiac compatibility, daily horoscope, and planet transit tracking for iOS and Android

Western Astrology App

Mobile App / Open Source30 min

Birth charts. Horoscopes. Transits. Zodiac compatibility.

Birth ChartsHoroscopesTransitsCompatibility

Browse all templates or use AI prompts to generate a custom app.

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: publisher-grade daily, weekly, and monthly forecasts with unique content per sign, active transit metadata, Moon phase data, and date scheduling for editorial pre-publishing

Build AI astrology chatbots with MCP: your OpenAI, Claude, or Gemini agent auto-discovers and calls every astrology endpoint 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 with house-based uniqueness per sign, horoscope newsletters with real lunar event dates, transit alerts, and seasonal forecasts at scale

Build travel and relocation astrology features: astrocartography line maps, relocated charts for any city, and local space direction lines for apps that help users decide where to live, travel, or work

Serve traditional and Hellenistic astrology apps: precessed fixed star conjunctions and the classical Arabic lots, the depth that professional and traditional practitioners expect and that generic chart APIs skip

Add the asteroid goddesses (Ceres, Pallas, Juno, Vesta) and mean and true Black Moon Lilith for archetypal and feminine-centered readings, the points modern self-discovery and astrology apps increasingly feature

Build predictive and timing features: secondary progressions, solar arc directions, and annual profections power forecast timelines, year-ahead reports, and time-lord tools without any astronomy code of your own

What developers are saying

DM

Dhani M.

Indie App Developer

Shipped an astrology app over a long weekend. Birth charts, nakshatras, KP cusps, significators. I verified the Lahiri ayanamsha values independently and they line up with my reference. One API key for all of it.

Email feedback
TH

Tom H.

Senior Developer

The OpenAPI spec is the most complete I have seen in this space. Generated a type-safe TypeScript client from it in seconds. Every field has descriptions and examples. Production-grade documentation.

Email feedback
CW

Chris W.

Backend Engineer

Response times consistently under 50ms for numerology and tarot endpoints. The API returns structured JSON with every field documented. Integrated it into our platform in an afternoon.

Email feedback

Do not take our word for it. Ask the agents.

Every page here is built so AI search engines can read and cite it, so go straight to the source. Let ChatGPT, Perplexity, or Claude search the web and tell you what they find about RoxyAPI accuracy, MCP, SDKs, and pricing.

Opens a live web search in a new tab.

Getting started with Western Astrology API.

From zero to production in 3 steps. No signup required for testing.

3 Steps to Ship

1Install the SDKnpm i @roxyapi/sdk
2Get your API keyView Plans
3Make your first callView Docs

Agent-Ready Infrastructure

MCP

Remote MCP, llms.txt, and AGENTS.md. The full agent-readiness stack for 12 spiritual domains under one key.

  • Remote MCP server — every endpoint auto-discovered as a tool by Claude, ChatGPT, Cursor over Streamable HTTP. No Docker.
  • llms.txt — AI-native discovery surface for ChatGPT, Perplexity, and Gemini citation
  • AGENTS.md — 2026 execution playbook for Cursor, Codex, Windsurf, Aider, Claude Code, Gemini CLI. Bundled in the SDK.

From your AI agent to a verified Western Astrology answer.

Your AI agentyour model, your voice
Remote MCPauto-discovered, no local setup
Roxy Ephemeris828 tests vs NASA JPL
Verified result12 domains, one flat rate

Your agent grounds every answer in verified calculations and replies in your own voice, so it never hallucinates a chart, date, or reading. No local setup, no AGPL, no hosted-AI markup.

Audit it yourself: every Western Astrology endpoint runs live in the API playground

Western Astrology API FAQ

How do I add birth charts to my app with an astrology API?

Send a birth date, time, and place, and the astrology API returns a complete natal chart your app can render right away: every planet with its sign, degree, and house, the Ascendant and Midheaven, the major aspects, chart patterns like a Grand Trine or T-Square, and a plain-language reading for each placement. You can pick Placidus, Whole Sign, Equal, or Koch houses with one setting. Activation is instant, so you can have a working birth chart in your product the same afternoon.

Can I build zodiac compatibility for a dating app with this API?

Yes. Pass two birth charts and the API returns a 0 to 100 compatibility score with the cross-chart connections behind it, including the Venus and Mars links that signal attraction and the harder aspects that show where a couple has work to do. For a quick match card there is a lighter compatibility score broken into romantic, emotional, intellectual, physical, and spiritual ratings, plus a named relationship archetype. It is enough to power a serious synastry feature without building any astrology math yourself.

How do I generate daily, weekly, and monthly horoscopes for every zodiac sign?

One call per sign returns a full horoscope with overview, love, career, health, finance, and advice, plus lucky numbers and colors, compatible signs, the active transits driving it, the current Moon sign and phase, and a daily energy rating. Content is genuinely different for each sign rather than one blurb reused twelve times. You can request a future date to pre-build a publishing calendar, and responses come in eight languages, which makes the astrology API a ready content engine for horoscope platforms and newsletters.

How do I track real-time transits and personalized forecasts for a user?

Ask for the current sky and you get live planetary positions back. Add a saved birth chart to the same request and the API also returns how today is touching that person specifically, telling you which aspects are building and which are fading so you can power a what is happening for me today feed. For longer arcs there are solar returns, lunar returns, and planetary return charts, including the Saturn return, which makes this a strong fit for wellness apps, lunar-cycle features, and AI companions that check in over time.

Can an AI agent call the astrology API directly without writing code?

Yes. Our Remote MCP server runs over Streamable HTTP with no local setup and no Docker, so Claude, Cursor, ChatGPT, and VS Code agents connect in seconds and call birth chart, synastry, horoscope, and transit tools directly. An AGENTS.md playbook tells the agent how to chain those calls for a real task. If you prefer to write code, typed SDKs for TypeScript, Python, and PHP and a published llms.txt discovery file get you there just as fast.

How accurate is the astrology API, and how is it priced?

Planet positions, house cusps, aspects, returns, and Moon phases come from Roxy Ephemeris, verified against NASA JPL Horizons, so the charts hold up to professional scrutiny. Pricing is flat and predictable, and one key unlocks not just Western astrology but all twelve spiritual-data domains on the platform, so you are never paying per product or stitching together separate vendors. There is a WordPress plugin and a set of drop-in UI components if you want chart visuals on a site without building them.

Start using Western Astrology API today.

Ship your astrology app this weekend. Not this quarter.

All 12 domains included with every plan. Every endpoint, MCP server, SDK, and starters.

Plans from $39/mo — thats $3.25 per domain. No credit card required for testing.

View Pricing & Get API Key