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, monthly, or yearly 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, monthly, and yearly horoscopes with unique content per sign and the dated sky events behind every reading, 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 by date or by year 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 9,584 automated tests per deploy, 2,121 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

Editorial horoscope columns at four periods, daily, weekly, monthly, and yearly. Each is a long-form piece that names the sky events driving it and the dates they fall on, read into the whole-sign houses of that sign, and it ships with the evidence underneath it: an events array giving the bodies involved, the angle where there is one, the house it falls in for that sign, the exact instant to the second, and the window it holds open, so a column can be checked against NASA JPL Horizons or the US Naval Observatory before it goes out. Every column is available in eight languages, and each one is COMPOSED in its own language rather than translated after the fact: German, Russian, Turkish and Hindi decline the house phrase into the case their own frames govern, French elides, and word order is native to each, so a Turkish or Hindi column reads as written rather than as English rearranged

Readings are reproducible with no language model involved, so the same sign and period returns the same column on every call and a piece written months ahead is the piece that runs. Across a full year of all twelve signs no two columns are the same writing, and no section is ever identical across the twelve signs on the same day. The six sections (overview, love, career, health, finance, advice) split that same reading by topic, beside active transits, Moon sign and phase, an energy rating from how loaded and how harmonious the sky is for that sign, lucky number and color, and compatible signs

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 39 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, adding 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 editorial columnsDaily horoscope by zodiac sign - Transit-based editorial columnsA publish-ready column for any zodiac sign, built from the dated transits over it and returned with those events for fact-checking. The reading names the aspects, sign ingresses, lunations and retrograde stations driving it and reads each into the whole-sign houses of that sign, so every sign gets different content rather than one blurb reused twelve times. Alongside the column come overview, love, career, health, finance and advice, the active transits, Moon sign and phase, an energy rating, lucky number and color, and compatible signs. No language model is involved, so a given sign and date always returns the same text and a piece scheduled months ahead is the piece that runs. Content rolls over at midnight, by default UTC. Pass date for editorial scheduling, or timezone to roll over on a local clock. Available in eight languages. Daily horoscope API, zodiac forecast, sun sign horoscope, astrology prediction.Try it
Weekly horoscope by zodiac sign - Seven-day editorial columnWeekly horoscope by zodiac sign - Seven-day editorial columnA Monday to Sunday column for any zodiac sign, naming the transits that perfect during the week and the days they fall on. Each event is read into the whole-sign houses of that sign, so content is unique per sign, and the dated events come back beside the prose so an editor can check a piece before it runs. Alongside the column come overview, love, career, health, finance and advice, plus lucky days, lucky numbers and compatible signs. No language model is involved, so the same sign and week always returns the same text. Pass any date inside a week to retrieve that week, or timezone to roll over on a local clock. Available in eight languages. Weekly horoscope API, zodiac weekly forecast, astrology weekly prediction.Try it
Monthly horoscope by zodiac sign - Editorial column with key datesMonthly horoscope by zodiac sign - Editorial column with key datesA month-long column for any zodiac sign, plus a week-by-week breakdown and dated key dates a calendar page renders directly. The column names every aspect, ingress, lunation and station of the month and reads each into the whole-sign houses of that sign, and those events come back beside the prose with their exact instants, so a piece can be checked against NASA JPL Horizons or the US Naval Observatory before it runs. Key dates are the real New Moon, Full Moon and retrograde instants, never approximations. Alongside the column come overview, love, career, health, finance and advice. Pass any date inside a month to retrieve that month, or timezone to roll over on a local clock. Available in eight languages. Monthly horoscope API, zodiac monthly forecast, astrology monthly prediction.Try it
Yearly horoscope by zodiac sign - Year ahead forecast with themes, key periods, eclipses and retrogradesYearly horoscope by zodiac sign - Year ahead forecast with themes, key periods, eclipses and retrogradesGet the year ahead for any zodiac sign, as a long-form column plus the structured arrays a year-ahead page is built from: the slow-body themes that set the backdrop, a dated key period for each of the twelve houses, the best month for love, career, health and finance, and every eclipse and every retrograde and direct station with the house it falls in for this sign. Love, career, health, finance and advice cover the whole year, and the dated events behind the copy come back beside it so an editor can check the piece before it runs. Omit the year for the one in progress, or pass any year from 1900 to 2100 to build an archive or a forecast ahead of time. Yearly horoscope API, year ahead astrology, annual zodiac forecast, eclipse and retrograde calendar.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: editorial daily, weekly, monthly, and yearly columns with unique content per sign, the dated events each one rests on returned beside the prose for fact-checking, active transit metadata, Moon phase data, and any past or future period on request 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 year-ahead pages built from every eclipse and every retrograde and direct station of the year with the house each one falls in for that sign

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 14+ 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 Ephemeris9,584 tests, 2121 vs NASA JPL
Verified result14 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, monthly, and yearly horoscopes for every zodiac sign?

One call per sign and period returns a column you can publish as it stands, plus overview, love, career, health, finance, and advice, lucky numbers and colors, compatible signs, the active transits driving it, the Moon sign and phase, and an energy rating. Beside the prose comes the list of dated sky events the reading rests on, each with its exact instant, so an editor can verify a column before it runs. Content is genuinely different for each sign rather than one blurb reused twelve times: across a full year of all twelve signs no two columns are the same writing, and no section is identical across the twelve signs on the same day. Ask for any past or future period to pre-build a publishing calendar, and responses come in eight languages.

What does the yearly horoscope return that the monthly one does not?

The year ahead in one call: a long-form annual column, plus every eclipse and every retrograde and direct station of the year with the whole-sign house each one falls in for that sign, and the year split into dated key periods by life area. Those three arrays are what an annual forecast page renders, and every instant in them can be checked against NASA JPL Horizons or the US Naval Observatory. Omit the year for the one in progress, or ask for any year from 1900 to 2100 to build an archive or publish ahead.

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 every spiritual-data domain 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 14 domains included with every plan. Every endpoint, MCP server, SDK, and starters.

Plans from $39/mo, starting at $2.32 per domain on annual billing. No credit card required for testing.

View Pricing & Get API Key