Popular

Astrology API

Ship your astrology app this weekend. Not this quarter.

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

<50mslatency
99.95%+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": "14:30:00",
    "latitude": 40.7128,
    "longitude": -74.006,
    "timezone": -5
  },
  "houseSystem": "placidus",
  "ascendant": {
    "longitude": 228.70514411922719,
    "sign": "Scorpio",
    "degree": 18.705144119227157
  },
  "midheaven": {
    "longitude": 149.78373310472432,
    "sign": "Leo",
    "degree": 29.78373310472432
  },
  "summary": {
    "dominantElement": "Water",
    "dominantModality": "Cardinal",
    "retrogradePlanets": [
      "Saturn",
      "Uranus",
      "Neptune"
    ],
    "elementDistribution": {
      "Fire": 3,
      "Earth": 4,
      "Air": 2,
      "Water": 5
    },
    "modalityDistribution": {
      "Cardinal": 7,
      "Fixed": 6,
      "Mutable": 1
    }
  },
  "planets": [
    {
      "name": "Sun",
      "longitude": 113.04427333389697,
      "latitude": -0.00002376112855731198,
      "sign": "Cancer",
      "degree": 23.044273333896967,
      "speed": 0.9541095523114649,
      "isRetrograde": false,
      "house": 8,
      "dignity": "peregrine",
      "interpretation": {
        "summary": "Your Sun in Cancer in The Eighth House reveals how you express self-awareness and ego with intuitive and nurturing energy in the realm of transformation and crisis.",
        "detailed": "Sun represents self-awareness and ego. In Cancer (Crab), this energy becomes intuitive, nurturing, protective. Located in The Eighth House, you direct this Cancer Sun energy toward transformation and crisis and sexuality. This creates a unique expression where your self-awareness and ego naturally manifests through intuitive, nurturing, protective approaches in matters related to the eighth house.",
        "keywords": [
          "active",
          "awareness",
          "bright",
          "confidence",
          "consciousness",
          "intuitive",
          "nurturing",
          "protective"
        ]
      }
    },
    {
      "name": "Moon",
      "longitude": 27.65720300997708,
      "latitude": 5.191167434861755,
      "sign": "Aries",
      "degree": 27.65720300997708,
      "speed": 14.239486218742574,
      "isRetrograde": false,
      "house": 5,
      "dignity": "peregrine",
      "interpretation": {
        "summary": "Your Moon in Aries in The Fifth House reveals how you express inner emotional life with ambitious and independent energy in the realm of creative self-expression.",
        "detailed": "Moon represents inner emotional life. In Aries (Ram), this energy becomes ambitious, independent, impatient. Located in The Fifth House, you direct this Aries Moon energy toward creative self-expression and pleasure and entertainment. This creates a unique expression where your inner emotional life naturally manifests through ambitious, independent, impatient approaches in matters related to the fifth house.",
        "keywords": [
          "caretaker",
          "comfort",
          "emotion",
          "feeling",
          "femininity",
          "ambitious",
          "independent",
          "impatient"
        ]
      }
    }
  ],
  "houses": [
    {
      "number": 1,
      "longitude": 228.70514411922719,
      "sign": "Scorpio",
      "degree": 18.705144119227157
    },
    {
      "number": 2,
      "longitude": 258.62614389203986,
      "sign": "Sagittarius",
      "degree": 18.626143892039863
    }
  ],
  "aspects": [
    {
      "planet1": "North Node",
      "planet2": "South Node",
      "type": "OPPOSITION",
      "angle": 180,
      "orb": 0,
      "isApplying": false,
      "strength": 100,
      "interpretation": "challenging",
      "aspectInterpretation": {
        "summary": "Your North Node forms a very strong opposition (180) with South Node, currently separating (weakening). This challenging aspect creates \"It takes two\" is the expression, and the opposition is created by dividing the circle by 2. Therein...",
        "keywords": [
          "accept",
          "accepting",
          "balance",
          "challenge",
          "complacent",
          "easy",
          "growth",
          "obstacle",
          "relationship",
          "struggle",
          "talent",
          "tension"
        ]
      }
    },
    {
      "planet1": "Sun",
      "planet2": "Jupiter",
      "type": "CONJUNCTION",
      "angle": 0,
      "orb": 0.424823542959075,
      "isApplying": false,
      "strength": 94.68970571301156,
      "interpretation": "neutral",
      "aspectInterpretation": {
        "summary": "Your Sun forms a very strong conjunction (0) with Jupiter, currently separating (weakening). This neutral aspect creates Planets and points that form a conjunction are energies that are united. They are blended; therefore...",
        "keywords": [
          "blend",
          "difficult",
          "unite",
          "united"
        ]
      }
    }
  ],
  "patterns": [
    {
      "kind": "T_SQUARE",
      "name": "T-Square",
      "planets": [
        "Moon",
        "Sun",
        "Saturn"
      ],
      "apex": "Moon",
      "modality": "cardinal",
      "dissociate": false,
      "tightness": 57,
      "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."
    }
  ]
}

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

Drop-in UI components & widgets

Render Astrology API responses without building charts yourself. Install the npm package and drop these into Next.js, React, Vue, Svelte, Angular, or plain HTML, or embed the very same component on Squarespace, Wix, or WordPress by pasting one snippet, with no backend and no build step. They belong to one library that covers the entire spiritual stack rather than astrology alone, MIT licensed and included in every plan at no extra cost, never a separate product and never an upsell. The Astrology API calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.

MIT licensedFramework agnosticThemeable via CSS variablesnpm or CDN
Show all Astrology UI components
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-transit-wheel>Natal chart on the inner ring, transiting bodies on the outer ring, aspect lines between them
<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
<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-ephemeris-table>Per-body sign changes and retrograde windows for the month, over the full daily position grid
<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

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 covered by 6,991 automated tests per deploy, 1,527 of them gold-standard tests locked to named external references such as NASA JPL Horizons, 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 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

Every one of the four house systems is cross-verified cusp by cusp, all twelve of them, not just the Ascendant and Midheaven that most implementations check. Quadrant systems are the easy place for an astrology engine to be quietly wrong on the intermediate cusps while the angles look perfect, so each system is pinned against an independent reference across eight charts spanning both hemispheres and the equator to high latitude

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

Declination parallels and contraparallels for a month, the aspect family that does not depend on zodiacal distance at all: two bodies at the same declination read much like a conjunction, equal and opposite like an opposition, and both surface connections an aspect table cannot show. Geocentric declinations matching what an ephemeris publishes, verified against NASA JPL Horizons and independently cross-checked

Month-at-a-glance forecasting from two more calendar endpoints: every tropical sign ingress for all 14 bodies with its exact date and time, and every aspect that perfects during the month across the 13 non-lunar bodies, each with the nature of the aspect and how close it came. Both default to the month in progress, so a published calendar stays current without a redeploy

Node passages for a whole year: every moment a body crosses the plane of the ecliptic, ascending or descending, with the exact instant and the sign it falls in. These are what make an eclipse possible when a lunar crossing meets a New or Full Moon, and they are the timing practitioners reach for when working with the nodes

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 38 Endpoints

Every one is live in the public OpenAPI spec and callable as an MCP tool. 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 aspectsGenerate 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.Try it
Get planetary positions - Ephemeris calculator for all planetsGet 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.Try it
Monthly Ephemeris - Daily tropical planetary positions for a monthMonthly Ephemeris - Daily tropical planetary positions for a monthGet daily tropical ecliptic positions for all 14 Western bodies (the 10 classical planets Sun through Pluto, the lunar nodes, Chiron, and Black Moon Lilith) for an entire month. Returns longitude, zodiac sign, degree within sign, and retrograde status for each body on each day, calculated at noon UTC. Omit year and month to get the month in progress, so a published ephemeris page stays current without a redeploy. Essential for ephemeris tables, transit tracking, retrograde calendars, and planetary movement charts. Monthly ephemeris API, tropical position table, daily planet transit positions, ecliptic longitude calculator. Verified against NASA JPL Horizons.Try it
Get current moon phase - Lunar phase calculator with zodiac signGet 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.Try it
Get upcoming moon phases - Next new moon, full moon, quartersGet 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.Try it
Get lunar calendar - Moon phases for entire monthGet 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.Try it
Calculate synastry - Relationship compatibility analysis APICalculate 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.Try it
Calculate house cusps - House system calculator with comparisonCalculate 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.Try it
Show all endpoints
Calculate planetary aspects - Aspect finder for any date and timeCalculate 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.Try it
Monthly Aspects - Tropical aspect calendar for an entire monthMonthly Aspects - Tropical aspect calendar for an entire monthGet every planetary aspect that perfects during a given month, across the 13 non-lunar Western bodies: the Sun and Mercury through Pluto, both lunar nodes, Chiron and Black Moon Lilith. Detects nine aspects, five major (conjunction, sextile, square, trine, opposition) and four minor (semi-sextile, semi-square, sesquiquadrate, quincunx), each with its own traditional orb, and returns the exact date and time of closest approach in your timezone along with the nature of the aspect. Calculated on tropical longitudes. The Moon is excluded because it forms hundreds of aspects a month and belongs in a daily view rather than a monthly one. Omit year and month to get the month in progress, so a published calendar stays current without a redeploy. Essential for monthly forecast copy, transit calendars, electional timing, and newsletter automation. Monthly aspect calendar API, exact aspect times, planetary aspect ephemeris, transit timing. Verified against NASA JPL Horizons.Try it
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 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.Try it
Monthly Transits - Tropical sign ingresses for an entire monthMonthly Transits - Tropical sign ingresses for an entire monthGet every tropical sign change for a given month, for all 14 Western bodies: the Sun through Pluto, both lunar nodes, Chiron and Black Moon Lilith. Returns the starting sign of each body on the first of the month and then each ingress with its exact date and time in your timezone. Omit year and month to get the month in progress, so a published transit calendar stays current without a redeploy. Essential for transit calendars, monthly forecast copy, retrograde and ingress tracking, and newsletter automation. Monthly transit API, planetary ingress calendar, sign change dates, tropical transit table. Verified against NASA JPL Horizons, with the four cardinal ingresses cross-checked against published equinox and solstice times.Try it
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.Monthly Parallels - Declination contacts for an entire monthGet every parallel and contraparallel of declination that perfects during a given month, across the 13 non-lunar Western bodies: the Sun and Mercury through Pluto, both lunar nodes, Chiron and Black Moon Lilith. A parallel is two bodies at the same declination and reads much like a conjunction; a contraparallel is equal and opposite declinations and reads much like an opposition. Neither depends on zodiacal distance, so they surface connections an aspect table cannot show, which is why traditional and modern practitioners read them alongside aspects. Declinations are geocentric, matching what an ephemeris publishes. Returns the exact date and time of closest approach in your timezone with both declinations. The Moon is excluded because its declination swings the full range every month and would bury the slow pairs. Omit year and month to get the month in progress, so a published calendar stays current without a redeploy. Essential for declination work, out-of-bounds tracking, monthly forecast copy, and electional timing. Monthly parallel calendar API, declination aspects, contraparallel ephemeris. Verified against NASA JPL Horizons.Ecliptic Crossings - Node passages for a whole yearGet every moment a body crosses the plane of the ecliptic during a given year, for the 11 Western bodies that leave it: the Moon and Mercury through Pluto, plus Chiron and Black Moon Lilith. A crossing from south to north is an ascending node passage, north to south a descending one. These are the instants a body sits exactly on the ecliptic rather than merely near it, which is what makes an eclipse possible when a lunar crossing coincides with a New or Full Moon, and what practitioners use for node-based timing. Returns the exact date and time in your timezone with the tropical longitude and sign. The Sun and the lunar nodes are excluded because they lie on the plane by definition and so have no nodes of their own. Essential for eclipse-season work, node timing, and astronomical calendars. Ecliptic crossing API, planetary node passage, ascending and descending nodes. Verified against NASA JPL Horizons.
Solar Return Chart - Annual birthday forecast with relocated chartSolar 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.Try it
Lunar Return Chart - Monthly emotional forecast with Moon cycle chartLunar 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.Try it
Composite Chart - Midpoint relationship chart with interpretationsComposite 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. Uses the midpoint method: planets, angles and house cusps are each the midpoint of the two natal values, so the Ascendant always sits on the first cusp. Returns composite planetary positions, house cusps, Ascendant, Midheaven, aspects, and relationship interpretation. Composite chart API, midpoint chart calculator, relationship astrology, couple chart analysis.Try it
Compatibility Score. Relationship compatibility analysis with category breakdownCompatibility 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.Try it
Daily horoscope by zodiac sign - Transit-based forecast with house activationsDaily 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. Content is fixed for a given date and rolls over at midnight, by default UTC. Pass date for editorial scheduling, or timezone to roll over on a local clock. Daily horoscope API, zodiac forecast, sun sign horoscope, astrology prediction.Try it
Weekly horoscope by zodiac sign - 7-day transit forecastWeekly horoscope by zodiac sign - 7-day transit forecastGet weekly horoscope for any zodiac sign. Forecast covers a full Monday to Sunday 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. Pass any date inside a week to retrieve that week, or timezone to roll over on a local clock. Weekly horoscope API, zodiac weekly forecast, astrology weekly prediction.Try it
Monthly horoscope by zodiac sign - 30-day transit forecast with key datesMonthly 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. Pass any date inside a month to retrieve that month, or timezone to roll over on a local clock. Monthly horoscope API, zodiac monthly forecast, astrology monthly prediction.Try it
Planetary Return Chart - Saturn return, Jupiter return, and inner planet cyclesPlanetary 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.Try it
Astrocartography map - planetary lines and relocation calculatorAstrocartography 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.Try it
Generate relocation chart - Relocated birth chart calculator with shifted houses and anglesGenerate 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.Try it
Local space astrology map - Directional planetary compass linesLocal 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.Try it
Fixed stars and star conjunctions calculator - Regulus, Spica, Algol natal reportFixed 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.Try it
Arabic lots calculator - seven Hermetic parts including Part of Fortune and SpiritArabic 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.Try it
Asteroid goddesses calculator - Ceres, Pallas, Juno, and Vesta natal positionsAsteroid 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.Try it
Black Moon Lilith calculator - mean and true lunar apogee in the natal chartBlack 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.Try it
Secondary progressions calculator - progressed chart, progressed Sun and MoonSecondary 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.Try it
Solar arc directions calculator - directed chart at one degree per yearSolar 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.Try it
Annual profections calculator - lord of the year and yearly time lord by ageAnnual 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.Try it

Free Templates for Western Astrology

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

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

What You Can Build with Astrology API

Real-world applications and use cases for integrating 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.

The receipts are public: the testing methodology, the open MIT benchmark, the transparency report, and the live API playground. 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 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+ domains under one key.

  • Remote MCP server — every endpoint auto-discovered as a tool by Claude, ChatGPT, Cursor over Streamable HTTP. No Docker.
  • Token-optimized responses — opt-in compact mode returns the same data with each field name sent once, cutting the tokens your agent reads per call by roughly 40 to 52 percent. Lossless, and one call still counts as one request.
  • 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 setupToken-optimized
Roxy Ephemeris6,991 tests, 1527 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

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. That same response carries the twelve natal house cusps and the Ascendant, so a bi-wheel renders on the correct horizon with real house sectors from one call instead of two. 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, PHP, C#, and Go, plus 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 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, starting at $2.70 per domain on annual billing. No credit card required for testing.

View Pricing & Get API Key