AI Spiritual Companion
Web App / Open Source45 minThe companion that remembers. Memory on your Supabase, readings on one key.
AstrologyTarotMemory
Western Astrology API
Birth charts checked cusp by cusp, and horoscopes that name the dated sky events behind each reading.
Natal ChartHoroscopeSynastryAstrology CompatibilityComposite ChartAstrology TransitAstrology CalendarDeclination ParallelsMoon PhaseSolar ReturnEphemerisAstrocartographyRelocation ChartLocal SpaceFixed StarsArabic PartsAsteroidsBlack Moon LilithProgressionsSolar ArcProfectionsLunar ReturnPlanetary ReturnAspect PatternsHouse SystemZodiac SignsPlanet Meanings and 19 more
Included with every plan (at no extra cost)
What the Western Astrology API covers.
Natal chart
- Placidus, Koch, Whole Sign and Equal houses
- Ascendant, Midheaven, Vertex, Part of Fortune
- Chiron and the lunar nodes
- Domicile, exaltation, detriment and fall
Horoscopes
- Daily, weekly, monthly and yearly columns per sign
- The dated sky events behind every reading
- Eclipses and retrogrades in the year ahead
Relationships
- Synastry with every inter-aspect
- Composite midpoint chart
- Compatibility score for any two charts
Transits
- Transit aspects to the natal chart, interpreted
- Monthly sign ingresses and aspect calendars
- Monthly declination parallels
- Node passages across a whole year
Timing techniques
- Secondary progressions
- Solar arc directions
- Annual profections and the lord of the year
- Solar, lunar and planetary returns
Classical points
- Fixed star conjunctions to natal planets
- Hermetic Arabic lots by day and night sect
- Ceres, Pallas, Juno and Vesta
- Mean and true Black Moon Lilith
Chart patterns
- Grand Trine, Kite, T-Square, Grand Cross, Yod
- Mystic Rectangle and Stellium
- Element and modality balance
- Orbs with applying and separating flags
Location astrology
- Astrocartography planetary lines
- Relocated chart for any city
- Local space compass lines
Moon
- Current phase with illumination
- Upcoming new moon, full moon and quarters
- Lunar calendar by month
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 13,405 automated tests per deploy, 3,620 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.
Interpretations in English, Deutsch, Español, Français, हिन्दी, Português, Русский, Türkçe, one query parameter away.
Start your way. Code, agents or no code.
Developers
Typed SDKs for TypeScript, Python, PHP, C#, and Go, generated from the live spec, each with an AGENTS.md so your coding assistant calls the Western Astrology API correctly.
AI agents
A Remote MCP server exposes every endpoint as a tool for Claude, ChatGPT, Cursor and any MCP client, with no local install. Opt-in compact responses cut the tokens your agent reads by roughly 40 to 52 percent, and one call stays one request.
No-code builders
Paste a widget into any site builder, install the WordPress plugin, or start from an MIT template you can white-label. Results render from the Western Astrology API with no backend.
Western Astrology API features, in detail.
The depth behind every line above, written out in full.
- 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. When the headline event of a period is a planet turning retrograde or a slower one changing sign, the reading names it once with both the date it opens and the date it closes, ahead of a smaller exact aspect. Every column, and the six sections beside it, is available in all supported 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 reading 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) are editorial columns in their own right rather than excerpts of the woven piece: each reads the same dated sky events as the column, filtered to its own life area, with the same events array behind it for fact-checking. Build a single-topic page straight from one field, love on its own for instance, or join overview, career, health, and finance into a general reading, 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
Start building with one key.
Want to try without writing code? Try this domain live in API playground →
Terminal
npm install @roxyapi/sdkUsage
import { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.astrology.get(/* ... */)Terminal
pip install roxy-sdkUsage
from roxy_sdk import create_roxy
roxy = create_roxy("your-api-key")
result = roxy.astrology.get(...) # async: await roxy.astrology.get_async(...)Terminal
composer require roxyapi/sdkUsage
use function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->astrology->get(/* ... */);Terminal
dotnet add package RoxyApi.SdkUsage
using RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
// await roxy.Astrology.<resource>.GetAsync() or .PostAsync(new() { ... })Terminal
go get github.com/RoxyAPI/sdk-goUsage
import roxyapi "github.com/RoxyAPI/sdk-go"
roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
// resp, err := roxy.Astrology.<Method>(context.Background(), nil)Claude Code / Cursor
claude mcp add --transport http \
roxy-astrology https://roxyapi.com/mcp/astrology \
--header "X-API-Key: YOUR_KEY"AI agents auto-discover all endpoints as callable tools. Zero configuration. Responses can come back token-optimized and lossless, cutting the tokens your agent spends per call by roughly 40 to 52 percent.
Full MCP setup guideTerminal
curl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/astrology/Want to ship faster? Clone a free template and white-label it as your own app.
Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app.
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": -4,
"nodeType": "true"
},
"planets": [
{
"name": "Sun",
"longitude": 113.00452053215861,
"latitude": 0.0001759667946626438,
"sign": "Cancer",
"degree": 23.004520532158608,
"speed": 0.9539944038144341,
"isRetrograde": false,
"house": 9,
"dignity": "peregrine",
"interpretation": {
"summary": "Your Sun in Cancer in The Ninth House reveals how you express self-awareness and ego with intuitive and nurturing energy in the realm of exploration.",
"detailed": "Sun represents self-awareness and ego. In Cancer (Crab), this energy becomes intuitive, nurturing, protective. Located in The Ninth House, you direct this Cancer Sun energy toward exploration and religious beliefs and personal philosophy. This creates a unique expression where your self-awareness and ego naturally manifests through intuitive, nurturing, protective approaches in matters related to the ninth house.",
"keywords": [
"active",
"awareness",
"bright",
"confidence",
"consciousness",
"intuitive",
"nurturing",
"protective"
]
}
},
{
"name": "Moon",
"longitude": 27.068938674158613,
"latitude": 5.181805332627993,
"sign": "Aries",
"degree": 27.068938674158613,
"speed": 14.104782784588977,
"isRetrograde": false,
"house": 6,
"dignity": "peregrine",
"interpretation": {
"summary": "Your Moon in Aries in The Sixth House reveals how you express inner emotional life with ambitious and independent energy in the realm of work and job.",
"detailed": "Moon represents inner emotional life. In Aries (Ram), this energy becomes ambitious, independent, impatient. Located in The Sixth House, you direct this Aries Moon energy toward work and job and techniques and methods. This creates a unique expression where your inner emotional life naturally manifests through ambitious, independent, impatient approaches in matters related to the sixth house.",
"keywords": [
"caretaker",
"comfort",
"emotion",
"feeling",
"femininity",
"ambitious",
"independent",
"impatient"
]
}
},
{
"name": "Mercury",
"longitude": 127.2804483512056,
"latitude": 1.771366339138991,
"sign": "Leo",
"degree": 7.280448351205607,
"speed": 1.869198256272938,
"isRetrograde": false,
"house": 9,
"dignity": "peregrine",
"interpretation": {
"summary": "Your Mercury in Leo in The Ninth House reveals how you express communication with proud and bold energy in the realm of exploration.",
"detailed": "Mercury represents communication. In Leo (Lion), this energy becomes proud, bold, ambitious. Located in The Ninth House, you direct this Leo Mercury energy toward exploration and religious beliefs and personal philosophy. This creates a unique expression where your communication naturally manifests through proud, bold, ambitious approaches in matters related to the ninth house.",
"keywords": [
"analysis",
"childhood",
"communication",
"curiosity",
"education",
"proud",
"bold",
"ambitious"
]
}
},
{
"name": "Venus",
"longitude": 84.73608276357183,
"latitude": -0.9479624880105159,
"sign": "Gemini",
"degree": 24.73608276357183,
"speed": 1.1994159129525883,
"isRetrograde": false,
"house": 8,
"dignity": "peregrine",
"interpretation": {
"summary": "Your Venus in Gemini in The Eighth House reveals how you express love, beauty, and money with curious and affectionate energy in the realm of transformation and crisis.",
"detailed": "Venus represents love, beauty, and money. In Gemini (Twins), this energy becomes curious, affectionate, kind. Located in The Eighth House, you direct this Gemini Venus energy toward transformation and crisis and sexuality. This creates a unique expression where your love, beauty, and money naturally manifests through curious, affectionate, kind approaches in matters related to the eighth house.",
"keywords": [
"attractiveness",
"beauty",
"culture",
"eros",
"fantasy",
"curious",
"affectionate",
"kind"
]
}
},
{
"name": "Mars",
"longitude": 32.12342925796031,
"latitude": -2.0650864909835867,
"sign": "Taurus",
"degree": 2.1234292579603107,
"speed": 0.6691958859832852,
"isRetrograde": false,
"house": 6,
"dignity": "detriment",
"interpretation": {
"summary": "Your Mars in Taurus in The Sixth House reveals how you express assertiveness and aggression with dependable and musical energy in the realm of work and job.",
"detailed": "Mars represents assertiveness and aggression. In Taurus (Bull), this energy becomes dependable, musical, practical. Located in The Sixth House, you direct this Taurus Mars energy toward work and job and techniques and methods. This creates a unique expression where your assertiveness and aggression naturally manifests through dependable, musical, practical approaches in matters related to the sixth house.",
"keywords": [
"action",
"adventurous",
"athletic",
"brave",
"courage",
"dependable",
"musical",
"practical"
]
}
},
{
"name": "Jupiter",
"longitude": 112.60994571682349,
"latitude": 0.23002826787756697,
"sign": "Cancer",
"degree": 22.60994571682349,
"speed": 0.22425373463141796,
"isRetrograde": false,
"house": 9,
"dignity": "exaltation",
"interpretation": {
"summary": "Your Jupiter in Cancer in The Ninth House reveals how you express luck and opportunity with intuitive and nurturing energy in the realm of exploration.",
"detailed": "Jupiter represents luck and opportunity. In Cancer (Crab), this energy becomes intuitive, nurturing, protective. Located in The Ninth House, you direct this Cancer Jupiter energy toward exploration and religious beliefs and personal philosophy. This creates a unique expression where your luck and opportunity naturally manifests through intuitive, nurturing, protective approaches in matters related to the ninth house.",
"keywords": [
"abundance",
"college",
"culture",
"curiosity",
"diversity",
"intuitive",
"nurturing",
"protective"
]
}
},
{
"name": "Saturn",
"longitude": 291.94353953255387,
"latitude": 0.07390792755091395,
"sign": "Capricorn",
"degree": 21.94353953255387,
"speed": -0.07405290659272623,
"isRetrograde": true,
"house": 3,
"dignity": "domicile",
"interpretation": {
"summary": "Your Saturn in Capricorn in The Third House reveals how you express responsibility, time, and routine with ambitious and disciplined energy in the realm of the lower mind.",
"detailed": "Saturn represents responsibility, time, and routine. In Capricorn (Goat), this energy becomes ambitious, disciplined, patient. Located in The Third House, you direct this Capricorn Saturn energy toward the lower mind and communication. This creates a unique expression where your responsibility, time, and routine naturally manifests through ambitious, disciplined, patient approaches in matters related to the third house.",
"keywords": [
"ambition",
"boundaries",
"determination",
"discipline",
"experience",
"ambitious",
"disciplined",
"patient"
]
}
},
{
"name": "Uranus",
"longitude": 276.956281802796,
"latitude": -0.32815436960618005,
"sign": "Capricorn",
"degree": 6.956281802796013,
"speed": -0.03844835717777073,
"isRetrograde": true,
"house": 2,
"dignity": "peregrine",
"interpretation": {
"summary": "Your Uranus in Capricorn in The Second House reveals how you express individuality and revolution with ambitious and disciplined energy in the realm of money and personal finances.",
"detailed": "Uranus represents individuality and revolution. In Capricorn (Goat), this energy becomes ambitious, disciplined, patient. Located in The Second House, you direct this Capricorn Uranus energy toward money and personal finances and sense of self-worth and basic values. This creates a unique expression where your individuality and revolution naturally manifests through ambitious, disciplined, patient approaches in matters related to the second house.",
"keywords": [
"avant-garde",
"change",
"comic",
"determined",
"experimental",
"ambitious",
"disciplined",
"patient"
]
}
},
{
"name": "Neptune",
"longitude": 282.9139975022088,
"latitude": 0.8724956724681929,
"sign": "Capricorn",
"degree": 12.913997502208815,
"speed": -0.02653699208624971,
"isRetrograde": true,
"house": 3,
"dignity": "peregrine",
"interpretation": {
"summary": "Your Neptune in Capricorn in The Third House reveals how you express dreams, healing, and intuition with ambitious and disciplined energy in the realm of the lower mind.",
"detailed": "Neptune represents dreams, healing, and intuition. In Capricorn (Goat), this energy becomes ambitious, disciplined, patient. Located in The Third House, you direct this Capricorn Neptune energy toward the lower mind and communication. This creates a unique expression where your dreams, healing, and intuition naturally manifests through ambitious, disciplined, patient approaches in matters related to the third house.",
"keywords": [
"artistic",
"calm",
"compassionate",
"deep",
"dreams",
"ambitious",
"disciplined",
"patient"
]
}
},
{
"name": "Pluto",
"longitude": 224.99788103667183,
"latitude": 15.61090590671027,
"sign": "Scorpio",
"degree": 14.997881036671828,
"speed": -0.0057325716183100894,
"isRetrograde": true,
"house": 1,
"dignity": "domicile",
"interpretation": {
"summary": "Your Pluto in Scorpio in The First House reveals how you express sex, death, and transformation with seductive and passionate energy in the realm of self-image.",
"detailed": "Pluto represents sex, death, and transformation. In Scorpio (Scorpion), this energy becomes seductive, passionate, independent. Located in The First House, you direct this Scorpio Pluto energy toward self-image and physical appearance. This creates a unique expression where your sex, death, and transformation naturally manifests through seductive, passionate, independent approaches in matters related to the first house.",
"keywords": [
"alchemy",
"bold",
"charismatic",
"complex",
"courageous",
"seductive",
"passionate",
"independent"
]
}
},
{
"name": "North Node",
"longitude": 307.35871686645265,
"latitude": 0,
"sign": "Aquarius",
"degree": 7.358716866452653,
"speed": -0.003171281607990295,
"isRetrograde": true,
"house": 3,
"interpretation": {
"summary": "Your North Node in Aquarius in The Third House reveals how you express life purpose and destiny with imaginative and idealistic energy in the realm of the lower mind.",
"detailed": "North Node represents life purpose and destiny. In Aquarius (Water Bearer), this energy becomes imaginative, idealistic, intuitive. Located in The Third House, you direct this Aquarius North Node energy toward the lower mind and communication. This creates a unique expression where your life purpose and destiny naturally manifests through imaginative, idealistic, intuitive approaches in matters related to the third house.",
"keywords": [
"destiny",
"life purpose",
"soul growth",
"future direction",
"karmic reward",
"imaginative",
"idealistic",
"intuitive"
]
}
},
{
"name": "South Node",
"longitude": 127.35871686645265,
"latitude": 0,
"sign": "Leo",
"degree": 7.358716866452653,
"speed": -0.003171281607990295,
"isRetrograde": true,
"house": 9,
"interpretation": {
"summary": "Your South Node in Leo in The Ninth House reveals how you express past life gifts and comfort zone with proud and bold energy in the realm of exploration.",
"detailed": "South Node represents past life gifts and comfort zone. In Leo (Lion), this energy becomes proud, bold, ambitious. Located in The Ninth House, you direct this Leo South Node energy toward exploration and religious beliefs and personal philosophy. This creates a unique expression where your past life gifts and comfort zone naturally manifests through proud, bold, ambitious approaches in matters related to the ninth house.",
"keywords": [
"innate talents",
"past life wisdom",
"natural abilities",
"comfort zone",
"mastered skills",
"proud",
"bold",
"ambitious"
]
}
},
{
"name": "Chiron",
"longitude": 109.25705196871604,
"latitude": -6.240259250272088,
"sign": "Cancer",
"degree": 19.25705196871604,
"speed": 0.10748734954066208,
"isRetrograde": false,
"house": 9,
"interpretation": {
"summary": "Your Chiron in Cancer in The Ninth House reveals how you express healing and inner wounds with intuitive and nurturing energy in the realm of exploration.",
"detailed": "Chiron represents healing and inner wounds. In Cancer (Crab), this energy becomes intuitive, nurturing, protective. Located in The Ninth House, you direct this Cancer Chiron energy toward exploration and religious beliefs and personal philosophy. This creates a unique expression where your healing and inner wounds naturally manifests through intuitive, nurturing, protective approaches in matters related to the ninth house.",
"keywords": [
"healing",
"wisdom",
"mentorship",
"teaching",
"empathy",
"intuitive",
"nurturing",
"protective"
]
}
},
{
"name": "Black Moon Lilith",
"longitude": 238.3402727210398,
"latitude": -4.828700516273704,
"sign": "Scorpio",
"degree": 28.34027272103981,
"speed": 0.11190589383744509,
"isRetrograde": false,
"house": 1,
"interpretation": {
"summary": "Your Black Moon Lilith in Scorpio in The First House reveals how you express primal instinct and the reclaimed self with seductive and passionate energy in the realm of self-image.",
"detailed": "Black Moon Lilith represents primal instinct and the reclaimed self. In Scorpio (Scorpion), this energy becomes seductive, passionate, independent. Located in The First House, you direct this Scorpio Black Moon Lilith energy toward self-image and physical appearance. This creates a unique expression where your primal instinct and the reclaimed self naturally manifests through seductive, passionate, independent approaches in matters related to the first house.",
"keywords": [
"authenticity",
"autonomy",
"instinct",
"raw power",
"self-possession",
"seductive",
"passionate",
"independent"
]
}
}
],
"houses": [
{
"number": 1,
"longitude": 216.94755540214257,
"sign": "Scorpio",
"degree": 6.947555402142569
},
{
"number": 2,
"longitude": 245.70511081785486,
"sign": "Sagittarius",
"degree": 5.705110817854859
},
{
"number": 3,
"longitude": 278.8646508303402,
"sign": "Capricorn",
"degree": 8.864650830340224
},
{
"number": 4,
"longitude": 314.3757003268656,
"sign": "Aquarius",
"degree": 14.375700326865626
},
{
"number": 5,
"longitude": 347.2694421714932,
"sign": "Pisces",
"degree": 17.26944217149321
},
{
"number": 6,
"longitude": 14.673514242355282,
"sign": "Aries",
"degree": 14.673514242355282
},
{
"number": 7,
"longitude": 36.9475554021426,
"sign": "Taurus",
"degree": 6.947555402142598
},
{
"number": 8,
"longitude": 65.70511081785486,
"sign": "Gemini",
"degree": 5.705110817854859
},
{
"number": 9,
"longitude": 98.86465083034022,
"sign": "Cancer",
"degree": 8.864650830340224
},
{
"number": 10,
"longitude": 134.3757003268656,
"sign": "Leo",
"degree": 14.375700326865598
},
{
"number": 11,
"longitude": 167.26944217149324,
"sign": "Virgo",
"degree": 17.26944217149324
},
{
"number": 12,
"longitude": 194.67351424235525,
"sign": "Libra",
"degree": 14.673514242355253
}
],
"houseSystem": "placidus",
"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 accept, accepting, balance...",
"keywords": [
"accept",
"accepting",
"balance",
"challenge",
"complacent",
"easy",
"growth",
"obstacle",
"relationship",
"struggle",
"talent",
"tension"
]
}
},
{
"planet1": "Mercury",
"planet2": "North Node",
"type": "OPPOSITION",
"angle": 180,
"orb": 0.07826851524703216,
"isApplying": true,
"strength": 99.0216435594121,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Mercury forms a very strong opposition (180) with North Node, currently applying (strengthening). This challenging aspect creates accept, accepting, balance...",
"keywords": [
"accept",
"accepting",
"balance",
"challenge",
"complacent",
"easy",
"growth",
"obstacle",
"relationship",
"struggle",
"talent",
"tension"
]
}
},
{
"planet1": "Mercury",
"planet2": "South Node",
"type": "CONJUNCTION",
"angle": 0,
"orb": 0.07826851524704637,
"isApplying": true,
"strength": 99.02164355941193,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Mercury forms a very strong conjunction (0) with South Node, currently applying (strengthening). This neutral aspect creates blend, difficult, unite...",
"keywords": [
"blend",
"difficult",
"unite",
"united"
]
}
},
{
"planet1": "Sun",
"planet2": "Jupiter",
"type": "CONJUNCTION",
"angle": 0,
"orb": 0.39457481533511896,
"isApplying": false,
"strength": 95.06781480831101,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Sun forms a very strong conjunction (0) with Jupiter, currently separating (weakening). This neutral aspect creates blend, difficult, unite...",
"keywords": [
"blend",
"difficult",
"unite",
"united"
]
}
},
{
"planet1": "Jupiter",
"planet2": "Saturn",
"type": "OPPOSITION",
"angle": 180,
"orb": 0.6664061842696185,
"isApplying": false,
"strength": 91.66992269662977,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Jupiter forms a very strong opposition (180) with Saturn, currently separating (weakening). This challenging aspect creates accept, accepting, balance...",
"keywords": [
"accept",
"accepting",
"balance",
"challenge",
"complacent",
"easy",
"growth",
"obstacle",
"relationship",
"struggle",
"talent",
"tension"
]
}
},
{
"planet1": "Mercury",
"planet2": "Uranus",
"type": "QUINCUNX",
"angle": 150,
"orb": 0.32416654840960746,
"isApplying": false,
"strength": 89.19444838634641,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Mercury forms a very strong quincunx (150) with Uranus, currently separating (weakening). This challenging aspect creates adjustment, tension, adaptation...",
"keywords": [
"adjustment",
"tension",
"adaptation",
"redirection"
]
}
},
{
"planet1": "Sun",
"planet2": "Saturn",
"type": "OPPOSITION",
"angle": 180,
"orb": 1.0609809996047375,
"isApplying": false,
"strength": 86.73773750494078,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Sun forms a very strong opposition (180) with Saturn, currently separating (weakening). This challenging aspect creates accept, accepting, balance...",
"keywords": [
"accept",
"accepting",
"balance",
"challenge",
"complacent",
"easy",
"growth",
"obstacle",
"relationship",
"struggle",
"talent",
"tension"
]
}
},
{
"planet1": "Uranus",
"planet2": "North Node",
"type": "SEMI_SEXTILE",
"angle": 30,
"orb": 0.4024350636566396,
"isApplying": false,
"strength": 86.58549787811202,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Uranus forms a very strong semi-sextile (30) with North Node, currently separating (weakening). This neutral aspect creates growth, subtle, adjustment...",
"keywords": [
"growth",
"subtle",
"adjustment",
"awareness"
]
}
},
{
"planet1": "Uranus",
"planet2": "South Node",
"type": "QUINCUNX",
"angle": 150,
"orb": 0.4024350636566396,
"isApplying": false,
"strength": 86.58549787811202,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Uranus forms a very strong quincunx (150) with South Node, currently separating (weakening). This challenging aspect creates adjustment, tension, adaptation...",
"keywords": [
"adjustment",
"tension",
"adaptation",
"redirection"
]
}
},
{
"planet1": "Neptune",
"planet2": "Black Moon Lilith",
"type": "SEMI_SQUARE",
"angle": 45,
"orb": 0.4262752188309946,
"isApplying": false,
"strength": 78.68623905845027,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Neptune forms a strong semi-square (45) with Black Moon Lilith, currently separating (weakening). This challenging aspect creates friction, irritation, agitation...",
"keywords": [
"friction",
"irritation",
"agitation",
"minor tension"
]
}
},
{
"planet1": "Saturn",
"planet2": "Chiron",
"type": "OPPOSITION",
"angle": 180,
"orb": 2.6864875638378294,
"isApplying": true,
"strength": 66.41890545202713,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Saturn forms a strong opposition (180) with Chiron, currently applying (strengthening). This challenging aspect creates accept, accepting, balance...",
"keywords": [
"accept",
"accepting",
"balance",
"challenge",
"complacent",
"easy",
"growth",
"obstacle",
"relationship",
"struggle",
"talent",
"tension"
]
}
},
{
"planet1": "Neptune",
"planet2": "Pluto",
"type": "SEXTILE",
"angle": 60,
"orb": 2.0838835344630127,
"isApplying": false,
"strength": 65.26860775894978,
"interpretation": "harmonious",
"aspectInterpretation": {
"summary": "Your Neptune forms a strong sextile (60) with Pluto, currently separating (weakening). This harmonious aspect creates ease, natural, relationship...",
"keywords": [
"ease",
"natural",
"relationship",
"talent"
]
}
},
{
"planet1": "Moon",
"planet2": "Venus",
"type": "SEXTILE",
"angle": 60,
"orb": 2.3328559105867868,
"isApplying": false,
"strength": 61.11906815688688,
"interpretation": "harmonious",
"aspectInterpretation": {
"summary": "Your Moon forms a strong sextile (60) with Venus, currently separating (weakening). This harmonious aspect creates ease, natural, relationship...",
"keywords": [
"ease",
"natural",
"relationship",
"talent"
]
}
},
{
"planet1": "Jupiter",
"planet2": "Chiron",
"type": "CONJUNCTION",
"angle": 0,
"orb": 3.352893748107448,
"isApplying": false,
"strength": 58.0888281486569,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Jupiter forms a moderate conjunction (0) with Chiron, currently separating (weakening). This neutral aspect creates blend, difficult, unite...",
"keywords": [
"blend",
"difficult",
"unite",
"united"
]
}
},
{
"planet1": "Moon",
"planet2": "Black Moon Lilith",
"type": "QUINCUNX",
"angle": 150,
"orb": 1.2713340468812078,
"isApplying": true,
"strength": 57.62219843729308,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Moon forms a moderate quincunx (150) with Black Moon Lilith, currently applying (strengthening). This challenging aspect creates adjustment, tension, adaptation...",
"keywords": [
"adjustment",
"tension",
"adaptation",
"redirection"
]
}
},
{
"planet1": "Sun",
"planet2": "Chiron",
"type": "CONJUNCTION",
"angle": 0,
"orb": 3.747468563442567,
"isApplying": false,
"strength": 53.156642956967914,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Sun forms a moderate conjunction (0) with Chiron, currently separating (weakening). This neutral aspect creates blend, difficult, unite...",
"keywords": [
"blend",
"difficult",
"unite",
"united"
]
}
},
{
"planet1": "Pluto",
"planet2": "Chiron",
"type": "TRINE",
"angle": 120,
"orb": 4.2591709320442135,
"isApplying": false,
"strength": 46.76036334944733,
"interpretation": "harmonious",
"aspectInterpretation": {
"summary": "Your Pluto forms a moderate trine (120) with Chiron, currently separating (weakening). This harmonious aspect creates accept, accepting, difficult...",
"keywords": [
"accept",
"accepting",
"difficult",
"natural",
"support",
"talent"
]
}
},
{
"planet1": "Sun",
"planet2": "Venus",
"type": "SEMI_SEXTILE",
"angle": 30,
"orb": 1.7315622314132213,
"isApplying": false,
"strength": 42.28125895289262,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Sun forms a moderate semi-sextile (30) with Venus, currently separating (weakening). This neutral aspect creates growth, subtle, adjustment...",
"keywords": [
"growth",
"subtle",
"adjustment",
"awareness"
]
}
},
{
"planet1": "Sun",
"planet2": "Moon",
"type": "SQUARE",
"angle": 90,
"orb": 4.064418142000008,
"isApplying": false,
"strength": 41.936883685714164,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Sun forms a moderate square (90) with Moon, currently separating (weakening). This challenging aspect creates difficult, obstacle, stress...",
"keywords": [
"difficult",
"obstacle",
"stress",
"tension"
]
}
},
{
"planet1": "Mars",
"planet2": "Uranus",
"type": "TRINE",
"angle": 120,
"orb": 4.832852544835703,
"isApplying": true,
"strength": 39.589343189553716,
"interpretation": "harmonious",
"aspectInterpretation": {
"summary": "Your Mars forms a weak trine (120) with Uranus, currently applying (strengthening). This harmonious aspect creates accept, accepting, difficult...",
"keywords": [
"accept",
"accepting",
"difficult",
"natural",
"support",
"talent"
]
}
},
{
"planet1": "Moon",
"planet2": "Mars",
"type": "CONJUNCTION",
"angle": 0,
"orb": 5.054490583801698,
"isApplying": true,
"strength": 36.81886770247878,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Moon forms a weak conjunction (0) with Mars, currently applying (strengthening). This neutral aspect creates blend, difficult, unite...",
"keywords": [
"blend",
"difficult",
"unite",
"united"
]
}
},
{
"planet1": "Moon",
"planet2": "Jupiter",
"type": "SQUARE",
"angle": 90,
"orb": 4.458992957335127,
"isApplying": false,
"strength": 36.30010060949819,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Moon forms a weak square (90) with Jupiter, currently separating (weakening). This challenging aspect creates difficult, obstacle, stress...",
"keywords": [
"difficult",
"obstacle",
"stress",
"tension"
]
}
},
{
"planet1": "Sun",
"planet2": "Black Moon Lilith",
"type": "TRINE",
"angle": 120,
"orb": 5.335752188881202,
"isApplying": true,
"strength": 33.30309763898498,
"interpretation": "harmonious",
"aspectInterpretation": {
"summary": "Your Sun forms a weak trine (120) with Black Moon Lilith, currently applying (strengthening). This harmonious aspect creates accept, accepting, difficult...",
"keywords": [
"accept",
"accepting",
"difficult",
"natural",
"support",
"talent"
]
}
},
{
"planet1": "Venus",
"planet2": "Jupiter",
"type": "SEMI_SEXTILE",
"angle": 30,
"orb": 2.1261370467483403,
"isApplying": false,
"strength": 29.128765108388656,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Venus forms a weak semi-sextile (30) with Jupiter, currently separating (weakening). This neutral aspect creates growth, subtle, adjustment...",
"keywords": [
"growth",
"subtle",
"adjustment",
"awareness"
]
}
},
{
"planet1": "Jupiter",
"planet2": "Black Moon Lilith",
"type": "TRINE",
"angle": 120,
"orb": 5.730327004216321,
"isApplying": true,
"strength": 28.370912447295993,
"interpretation": "harmonious",
"aspectInterpretation": {
"summary": "Your Jupiter forms a weak trine (120) with Black Moon Lilith, currently applying (strengthening). This harmonious aspect creates accept, accepting, difficult...",
"keywords": [
"accept",
"accepting",
"difficult",
"natural",
"support",
"talent"
]
}
},
{
"planet1": "Moon",
"planet2": "Saturn",
"type": "SQUARE",
"angle": 90,
"orb": 5.12539914160476,
"isApplying": false,
"strength": 26.780012262789143,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Moon forms a weak square (90) with Saturn, currently separating (weakening). This challenging aspect creates difficult, obstacle, stress...",
"keywords": [
"difficult",
"obstacle",
"stress",
"tension"
]
}
},
{
"planet1": "Mercury",
"planet2": "Mars",
"type": "SQUARE",
"angle": 90,
"orb": 5.157019093245296,
"isApplying": false,
"strength": 26.328298667924344,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Mercury forms a weak square (90) with Mars, currently separating (weakening). This challenging aspect creates difficult, obstacle, stress...",
"keywords": [
"difficult",
"obstacle",
"stress",
"tension"
]
}
},
{
"planet1": "Uranus",
"planet2": "Neptune",
"type": "CONJUNCTION",
"angle": 0,
"orb": 5.957715699412802,
"isApplying": false,
"strength": 25.528553757339978,
"interpretation": "neutral",
"aspectInterpretation": {
"summary": "Your Uranus forms a weak conjunction (0) with Neptune, currently separating (weakening). This neutral aspect creates blend, difficult, unite...",
"keywords": [
"blend",
"difficult",
"unite",
"united"
]
}
},
{
"planet1": "Mars",
"planet2": "North Node",
"type": "SQUARE",
"angle": 90,
"orb": 5.235287608492342,
"isApplying": true,
"strength": 25.210177021537973,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Mars forms a weak square (90) with North Node, currently applying (strengthening). This challenging aspect creates difficult, obstacle, stress...",
"keywords": [
"difficult",
"obstacle",
"stress",
"tension"
]
}
},
{
"planet1": "Mars",
"planet2": "South Node",
"type": "SQUARE",
"angle": 90,
"orb": 5.235287608492342,
"isApplying": true,
"strength": 25.210177021537973,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Mars forms a weak square (90) with South Node, currently applying (strengthening). This challenging aspect creates difficult, obstacle, stress...",
"keywords": [
"difficult",
"obstacle",
"stress",
"tension"
]
}
},
{
"planet1": "Neptune",
"planet2": "Chiron",
"type": "OPPOSITION",
"angle": 180,
"orb": 6.343054466507226,
"isApplying": false,
"strength": 20.711819168659673,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Neptune forms a weak opposition (180) with Chiron, currently separating (weakening). This challenging aspect creates accept, accepting, balance...",
"keywords": [
"accept",
"accepting",
"balance",
"challenge",
"complacent",
"easy",
"growth",
"obstacle",
"relationship",
"struggle",
"talent",
"tension"
]
}
},
{
"planet1": "Venus",
"planet2": "Saturn",
"type": "QUINCUNX",
"angle": 150,
"orb": 2.7925432310179588,
"isApplying": false,
"strength": 6.915225632734712,
"interpretation": "challenging",
"aspectInterpretation": {
"summary": "Your Venus forms a weak quincunx (150) with Saturn, currently separating (weakening). This challenging aspect creates adjustment, tension, adaptation...",
"keywords": [
"adjustment",
"tension",
"adaptation",
"redirection"
]
}
},
{
"planet1": "Jupiter",
"planet2": "Pluto",
"type": "TRINE",
"angle": 120,
"orb": 7.612064680151661,
"isApplying": false,
"strength": 4.849191498104233,
"interpretation": "harmonious",
"aspectInterpretation": {
"summary": "Your Jupiter forms a weak trine (120) with Pluto, currently separating (weakening). This harmonious aspect creates accept, accepting, difficult...",
"keywords": [
"accept",
"accepting",
"difficult",
"natural",
"support",
"talent"
]
}
}
],
"ascendant": {
"longitude": 216.94755540214257,
"sign": "Scorpio",
"degree": 6.947555402142569
},
"midheaven": {
"longitude": 134.3757003268656,
"sign": "Leo",
"degree": 14.375700326865598
},
"partOfFortune": {
"sign": "Leo",
"degree": 11.011973544142563,
"longitude": 131.01197354414256,
"sect": "day",
"house": 9
},
"vertex": {
"longitude": 77.23570400870443,
"sign": "Gemini",
"degree": 17.23570400870443,
"house": 8
},
"patterns": [
{
"kind": "T_SQUARE",
"name": "T-Square",
"planets": [
"Moon",
"Sun",
"Saturn"
],
"apex": "Moon",
"modality": "cardinal",
"dissociate": false,
"tightness": 62,
"interpretationKey": "aspectPattern.tSquare",
"interpretationVars": {
"apex": "Moon",
"apexSign": "Aries",
"end1": "Sun",
"end2": "Saturn"
},
"interpretation": "T-Square focused on Moon in Aries, tension between Sun and Saturn demands resolution at the apex, the primary growth engine of the chart."
},
{
"kind": "T_SQUARE",
"name": "T-Square",
"planets": [
"Moon",
"Jupiter",
"Saturn"
],
"apex": "Moon",
"modality": "cardinal",
"dissociate": false,
"tightness": 62,
"interpretationKey": "aspectPattern.tSquare",
"interpretationVars": {
"apex": "Moon",
"apexSign": "Aries",
"end1": "Jupiter",
"end2": "Saturn"
},
"interpretation": "T-Square focused on Moon in Aries, tension between Jupiter and Saturn demands resolution at the apex, the primary growth engine of the chart."
},
{
"kind": "STELLIUM",
"name": "Stellium",
"planets": [
"Uranus",
"Neptune",
"Saturn"
],
"tightness": 100,
"interpretationKey": "aspectPattern.stelliumSameSign",
"interpretationVars": {
"count": "3",
"sign": "Capricorn",
"planets": "Uranus, Neptune, and Saturn"
},
"interpretation": "Stellium of 3 planets in Capricorn, concentrated energy demanding mastery of Capricorn themes through Uranus, Neptune, and Saturn."
}
],
"aspectsInterpretation": {
"summary": "Your chart contains 33 aspects: 7 harmonious, 17 challenging, and 9 neutral. The balanced mix of aspects suggests a well-rounded chart with both natural talents and growth opportunities.",
"dominant": "balanced",
"harmonious": 7,
"challenging": 17,
"neutral": 9
},
"summary": {
"dominantElement": "Earth",
"dominantModality": "Cardinal",
"retrogradePlanets": [
"Saturn",
"Uranus",
"Neptune",
"Pluto",
"North Node",
"South Node"
],
"elementDistribution": {
"Fire": 2,
"Earth": 4,
"Air": 1,
"Water": 3
},
"modalityDistribution": {
"Cardinal": 6,
"Fixed": 3,
"Mutable": 1
}
}
}Structured JSON with documented fields. Not hallucinated text. See all endpoints
Drop-in UI components and no-code widgets.
Render Western 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 Western 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
Natal chart widget snippet
Synastry chart widget snippet
Western planets table widget snippet
Transits table widget snippet
Transit wheel widget snippet
Aspects table widget snippet
Moon phase widget snippet
Horoscope card widget snippet
Astrocartography map widget snippet
Local space compass widget snippet
Relocation wheel widget snippet
Positions table widget snippet
Ephemeris table widget snippet
Fixed stars widget snippet
Profection card widget snippet
Compatibility card widget snippet
Reference card widget snippet
The complete UI libraryExplore Roxy UI
Synastry chart widget snippetWestern planets table widget snippetTransits table widget snippetTransit wheel widget snippetAspects table widget snippetMoon phase widget snippetHoroscope card widget snippetAstrocartography map widget snippetLocal space compass widget snippetRelocation wheel widget snippetPositions table widget snippetEphemeris table widget snippetFixed stars widget snippetProfection card widget snippetCompatibility card widget snippetReference card widget snippetThe complete UI libraryExplore Roxy UIShow all Western Astrology UI componentsShow fewer Western Astrology UI components
| Element | Renders |
|---|---|
| <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 |
Free templates for Western Astrology.
Clone. Edit. Ship. Free and open source by Team Roxy.
AI Astrology Chatbot
Web App / Open Source30 minAI chatbot with real readings across all domains. Not hallucinations.
AstrologyVedicTarotNumerologyCrystalsDreamsI-ChingAngel Numbers
Practitioner Website Template
Web App / Open Source30 minThe practitioner website you own. Free birth charts, tarot, and human design built in.
AstrologyTarotNumerologyHuman Design
AI Spiritual Voice Assistant
Web App / Open Source30 minTalk to the stars. Real readings across every domain, spoken aloud.
VoiceAstrologyVedicTarotNumerologyHuman Design
Western Astrology App
Mobile App / Open Source30 minBirth charts. Horoscopes. Transits. Zodiac compatibility.
Birth ChartsHoroscopesTransitsCompatibility
Astrology on Supabase
Backend / Open Source20 minReadings from your own Postgres. Two Edge Functions, one cache, no key in the browser.
AstrologyBackend
n8n Astrology AI Agent
Workflow / Open Source10 minAn astrology companion in n8n. Import one file, add two keys, chat.
AstrologyTarotLocation
Browse all templates or use AI prompts to generate a custom app.
What you can build with the Western Astrology API.
The products teams ship on the Western Astrology API.
- Launch natal chart apps with professional-grade accuracy: birth charts, planet positions, house placements, aspects, and element analysis ready for your UI
- 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
All 39 endpoints, live in the playground.
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 for any date, time, and location. The bodies are the 10 classical planets Sun through Pluto, the lunar nodes, Chiron, and Black Moon Lilith. 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 endpointsShow fewer 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 APICompatibility score - Relationship compatibility APICalculate 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. Composed in 8 languages (en, de, es, fr, hi, pt, ru, tr); any other lang code returns English. 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. Composed in 8 languages (en, de, es, fr, hi, pt, ru, tr); any other lang code returns English. 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 the major aspects, slow-planet sign changes, lunations and stations 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. Composed in 8 languages (en, de, es, fr, hi, pt, ru, tr); any other lang code returns English. 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. Covers the four Royal stars and the fifteen Behenian stars, then detects 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. The lots are the 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. 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
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.
From your AI agent to a verified Western Astrology answer.
Your AI agentyour model, your voice
Remote MCPauto-discovered, no local setupToken-optimized
Roxy Ephemeris13,405 tests, 3620 gold standard
Verified result18 domains, one flat rate
Your agent uses calculated charts and readings in its replies, with your model and your own voice. Planetary positions are verified against NASA JPL Horizons. No local setup, no AGPL, no hosted-AI markup.
Audit it yourself: every Western Astrology endpoint runs live in the API playground
Western Astrology API questions, answered.
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 as editorial columns of their own, each reading the same dated sky events as the column but filtered to its own life area, 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 any section before it runs. Build a single-topic page from one field, a love column for a compatibility app say, or join overview, career, health, and finance into a general reading. 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 every field is composed natively in every language the API ships, never translated after the fact.
Is the horoscope text unique to my app, and can I edit it?
Every subscriber who asks for the same sign and period receives the same column, because readings are reproducible and no language model sits in the loop. What makes the text yours is the licence: edit, shorten, rewrite, and translate it into the voice of your product and publish it inside your own product, with one condition, that a materially altered version is not presented as our editorial content. Publishers who want prose nobody else runs rewrite from the column and keep the events array as the fact-check behind it.
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 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.
Why do the house cusps differ from another chart program while the planets match?
Almost always because the two charts were cast at different coordinates. Planet positions are apparent geocentric on the true ecliptic of date, the convention chart software prints, so they compare directly. The Ascendant, Midheaven and house cusps agree with the reference to the arcsecond at the same coordinates, but they move with the birthplace: a program that casts at a town position rounded to whole arcminutes shifts the angles and cusps by several arcminutes, unevenly across the twelve, while the planets stay put. Pass the coordinates the other program used and the charts line up; birthDetails on every chart echoes the coordinates it was cast at.
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 insight domain on the same key, so you are never paying per product or stitching together separate vendors. There is a WordPress plugin and a set of drop-in UI components if you want chart visuals on a site without building them.
Start using Western Astrology API today.
Birth charts checked cusp by cusp, and horoscopes that name the dated sky events behind each reading.
All 18 domains included with every plan. Every endpoint, MCP server, SDK, and templates.
Plans from $39/mo, starting at $1.80 per domain on annual billing. No credit card required for testing.
View Pricing & Get API Key