
AI Astrology Chatbot
Web App / Open Source30 minAI chatbot with real readings across all spiritual domains. Not hallucinations.
Ship your astrology app this weekend. Not this quarter.
Natal ChartHoroscopeSynastryCompatibilityTransitMoon PhaseAstrocartographyRelocation ChartLocal SpaceFixed StarsArabic PartsAsteroidsBlack Moon LilithProgressionsSolar ArcProfections …and so much more
Want to try without writing code? Try this domain live in API playground →
npm install @roxyapi/sdkimport { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.astrology.get(/* ... */)pip install roxy-sdkfrom roxy_sdk import create_roxy
roxy = create_roxy("your-api-key")
result = roxy.astrology.get(...) # async: await roxy.astrology.get_async(...)composer require roxyapi/sdkuse function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->astrology->get(/* ... */);dotnet add package RoxyApi.Sdkusing RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
// await roxy.Astrology.<resource>.GetAsync() or .PostAsync(new() { ... })go get github.com/RoxyAPI/sdk-goimport roxyapi "github.com/RoxyAPI/sdk-go"
roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
// resp, err := roxy.Astrology.<Method>(context.Background(), nil)curl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/astrology/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.
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.
{
"birthDetails": {
"date": "1990-07-15",
"time": "13:30:00",
"latitude": 40.7128,
"longitude": -74.006,
"timezone": -5
},
"planets": [
{
"name": "Sun",
"longitude": 113.01012297464763,
"latitude": -0.000023757319263795868,
"sign": "Cancer",
"degree": 23.01012297464763,
"speed": 0.9541023962147364,
"isRetrograde": false,
"house": 9,
"interpretation": {
"summary": "Your Sun in Cancer in The Ninth House reveals how you express self-awareness and ego with intuitive and nurturing energy in the realm of exploration.",
"detailed": "Sun represents self-awareness and ego. In Cancer (Crab), this energy becomes intuitive, nurturing, protective. Located in The Ninth House, you direct this Cancer Sun energy toward exploration and religious beliefs and personal philosophy. This creates a unique expression where your self-awareness and ego naturally manifests through intuitive, nurturing, protective approaches in matters related to the ninth house.",
"keywords": [
"active",
"awareness",
"bright",
"confidence",
"consciousness",
"intuitive",
"nurturing",
"protective"
]
}
},
{
"name": "Moon",
"longitude": 27.069104206098757,
"latitude": 5.181836887962161,
"sign": "Aries",
"degree": 27.069104206098757,
"speed": 14.229731173744796,
"isRetrograde": false,
"house": 6,
"interpretation": {
"summary": "Your Moon in Aries in The Sixth House reveals how you express inner emotional life with ambitious and independent energy in the realm of work and job.",
"detailed": "Moon represents inner emotional life. In Aries (Ram), this energy becomes ambitious, independent, impatient. Located in The Sixth House, you direct this Aries Moon energy toward work and job and techniques and methods. This creates a unique expression where your inner emotional life naturally manifests through ambitious, independent, impatient approaches in matters related to the sixth house.",
"keywords": [
"caretaker",
"comfort",
"emotion",
"feeling",
"femininity",
"ambitious",
"independent",
"impatient"
]
}
}
],
"houses": [
{
"number": 1,
"longitude": 216.94758165419276,
"sign": "Scorpio",
"degree": 6.9475816541927315
},
{
"number": 2,
"longitude": 245.70493298442574,
"sign": "Sagittarius",
"degree": 5.704932984425795
},
{
"number": 3,
"longitude": 278.86478584928255,
"sign": "Capricorn",
"degree": 8.864785849282498
},
{
"number": 4,
"longitude": 314.37573350548865,
"sign": "Aquarius",
"degree": 14.375733505488597
}
],
"houseSystem": "placidus",
"aspects": [
{
"planet1": "North Node",
"planet2": "South Node",
"type": "OPPOSITION",
"angle": 180,
"orb": 0,
"isApplying": false,
"strength": 100,
"interpretation": "challenging"
},
{
"planet1": "Sun",
"planet2": "Jupiter",
"type": "CONJUNCTION",
"angle": 0,
"orb": 0.39442371250532915,
"isApplying": false,
"strength": 95.06970359368339,
"interpretation": "neutral"
},
{
"planet1": "Jupiter",
"planet2": "Saturn",
"type": "OPPOSITION",
"angle": 180,
"orb": 0.6778443722118368,
"isApplying": false,
"strength": 91.52694534735204,
"interpretation": "challenging"
},
{
"planet1": "Mercury",
"planet2": "North Node",
"type": "OPPOSITION",
"angle": 180,
"orb": 0.804916363861139,
"isApplying": false,
"strength": 89.93854545173576,
"interpretation": "challenging"
},
{
"planet1": "Mercury",
"planet2": "South Node",
"type": "CONJUNCTION",
"angle": 0,
"orb": 0.804916363861139,
"isApplying": false,
"strength": 89.93854545173576,
"interpretation": "neutral"
},
{
"planet1": "Mercury",
"planet2": "Uranus",
"type": "QUINCUNX",
"angle": 150,
"orb": 0.33677933831427254,
"isApplying": false,
"strength": 88.77402205619092,
"interpretation": "neutral"
}
],
"ascendant": {
"longitude": 216.94758165419276,
"sign": "Scorpio",
"degree": 6.9475816541927315
},
"midheaven": {
"longitude": 134.37573350548865,
"sign": "Leo",
"degree": 14.375733505488654
},
"partOfFortune": {
"sign": "Leo",
"degree": 11.006562885643916,
"longitude": 131.00656288564392,
"sect": "day"
},
"vertex": {
"longitude": 77.23573150642028,
"sign": "Gemini",
"degree": 17.23573150642028
},
"patterns": [
{
"kind": "T_SQUARE",
"name": "T-Square",
"planets": [
"Moon",
"Sun",
"Saturn"
],
"apex": "Moon",
"modality": "cardinal",
"dissociate": false,
"tightness": 61,
"interpretationKey": "aspectPattern.tSquare",
"interpretationVars": {
"apex": "Moon",
"apexSign": "Aries",
"end1": "Sun",
"end2": "Saturn"
},
"interpretation": "T-Square focused on Moon in Aries, tension between Sun and Saturn demands resolution at the apex, the primary growth engine of the chart."
},
{
"kind": "T_SQUARE",
"name": "T-Square",
"planets": [
"Moon",
"Jupiter",
"Saturn"
],
"apex": "Moon",
"modality": "cardinal",
"dissociate": false,
"tightness": 62,
"interpretationKey": "aspectPattern.tSquare",
"interpretationVars": {
"apex": "Moon",
"apexSign": "Aries",
"end1": "Jupiter",
"end2": "Saturn"
},
"interpretation": "T-Square focused on Moon in Aries, tension between Jupiter and Saturn demands resolution at the apex, the primary growth engine of the chart."
}
],
"aspectsInterpretation": {
"summary": "Your chart contains 37 aspects: 7 harmonious, 17 challenging, and 13 neutral. This creates a balanced overall pattern. The balanced mix of aspects suggests a well-rounded chart with both natural talents and growth opportunities.",
"dominant": "balanced",
"harmonious": 7,
"challenging": 17,
"neutral": 13
},
"summary": {
"dominantElement": "Water",
"dominantModality": "Cardinal",
"retrogradePlanets": [
"Saturn",
"Uranus",
"Neptune",
"Pluto",
"North Node",
"South Node"
],
"elementDistribution": {
"Fire": 3,
"Earth": 4,
"Air": 2,
"Water": 5
},
"modalityDistribution": {
"Cardinal": 7,
"Fixed": 6,
"Mutable": 1
}
}
}Structured JSON with documented fields. Not hallucinated text. See all endpoints
Works with your stack
Western astrology API for natal birth charts, daily, weekly, and monthly horoscopes with unique content per sign, synastry compatibility scores, composite charts, solar and lunar returns, real-time transit aspects, and moon phases. 4 house systems (Placidus, Koch, Whole Sign, Equal) with accurate tropical ephemeris, aspect-pattern detection (Grand Trine, T-Square, Yod), astrocartography planetary lines, relocation charts, and local space maps for location based astrology, plus classical and professional points like fixed star conjunctions, Arabic lots, the asteroid goddesses (Ceres, Pallas, Juno, Vesta), mean and true Black Moon Lilith, and timing techniques like secondary progressions, solar arc directions, and annual profections. Built for horoscope platforms, astrology dating apps, AI chatbots, wellness products, and zodiac content engines. Schedule future horoscopes with a date parameter for editorial workflows, no astronomy expertise needed. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.
Every Western Astrology calculation is verified against NASA JPL Horizons across 828 gold-standard tests, with a public MIT benchmark repo anyone can clone and re-run. See how we test.
Multi-language API responses
Everything you need from our Western Astrology API, built for production:
Natal birth charts with 4 house systems (Placidus, Koch, Whole Sign, Equal) covering all 14 celestial bodies (the 10 classical planets, the lunar nodes, Chiron, and Black Moon Lilith), the Ascendant, Midheaven, Part of Fortune, and Vertex, all major aspects, planetary dignities, and element/modality analysis
Synastry compatibility and composite charts with relationship scoring, aspect patterns, Venus-Mars connections, and partnership dynamics
Publisher-grade daily, weekly, and monthly horoscopes with unique content per sign via whole-sign house system. Love, career, health, finance, advice sections, active transits, Moon data, energy rating, and date scheduling for editorial workflows
Solar returns, lunar returns, and planetary return charts for annual and monthly forecasting with customizable house systems
Detect classical aspect configurations including Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, and Stellium with apex identification, element and modality coherence, dissociate flagging, and tightness scoring for chart pattern callouts
Real-time transit calculations and transit aspect analysis with current planetary positions, applying/separating aspects, and personalized forecasts
Moon phase tracking with current phase, upcoming phases calendar, and lunar cycle data for wellness, gardening, and ritual timing apps
Astrocartography planetary line maps, relocation charts, and local space directions for location based astrology, showing where each planet turns angular across the world, how the angles and houses shift for any city, and which compass directions carry each planet energy from your birthplace
Classical and traditional points: precessed fixed star positions with conjunctions to natal planets and angles (Regulus, Spica, Algol, and the royal and Behenian stars), and the Hermetic Arabic lots (Part of Fortune, Spirit, Eros, Necessity, Courage, Victory, Nemesis) computed by day and night sect
The asteroid goddesses (Ceres, Pallas, Juno, Vesta) and both Black Moon Lilith calculations (mean and true lunar apogee), the feminine-archetype and professional points that round out a serious natal reading beyond the ten planets
Predictive timing techniques: secondary progressions (the day-for-a-year progressed chart), solar arc directions, and annual profections with the traditional lord of the year, the methods professional astrologers use to time the unfolding of a life
Click any endpoint to view detailed documentation, parameters, and response examples.
Render Western Astrology responses without building charts yourself. These open source, framework-agnostic web components take the typed API response and draw it, in React, Vue, Svelte, Angular, plain HTML, and WordPress.
| 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-aspects-table> | Aspect rows coloured by nature with orb and strength, plus detected chart patterns |
| <roxy-moon-phase> | Moon phase card and calendar |
| <roxy-horoscope-card> | Daily, weekly, or monthly horoscope card |
| <roxy-astrocartography-map> | World map of planetary MC, IC, Ascendant, and Descendant lines with per-line interpretations |
| <roxy-local-space-compass> | Compass dial of planetary azimuth lines from the birthplace, dimmed below the horizon |
| <roxy-relocation-wheel> | Relocated chart wheel plus the move geometry, angular planets, and planets that change house |
| <roxy-positions-table> | Body, sign, degree, and per-shape columns (house, motion, formula, or natal arc) plus each reading |
| <roxy-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 |
Clone. Edit. Ship. Free and open source by Team Roxy.

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

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

Birth charts. Horoscopes. Transits. Zodiac compatibility.
Browse all templates or use AI prompts to generate a custom app.
Real-world applications and use cases for integrating Western Astrology API into your projects:
Launch natal chart apps with professional-grade accuracy: birth charts, planet positions, house placements, aspects, and element analysis ready for your UI in days
Add zodiac compatibility scoring to dating apps: synastry analysis, composite charts, and compatibility scores with detailed relationship dynamics
Ship personalized horoscope platforms: publisher-grade daily, weekly, and monthly forecasts with unique content per sign, active transit metadata, Moon phase data, and date scheduling for editorial pre-publishing
Build AI astrology chatbots with MCP: your OpenAI, Claude, or Gemini agent auto-discovers and calls every astrology endpoint with zero integration code
Power wellness and lifestyle apps with real-time transits, moon phase calendars, solar returns, and planetary movement alerts for self-discovery features
Create astrology content engines: automated zodiac content with house-based uniqueness per sign, horoscope newsletters with real lunar event dates, transit alerts, and seasonal forecasts at scale
Build travel and relocation astrology features: astrocartography line maps, relocated charts for any city, and local space direction lines for apps that help users decide where to live, travel, or work
Serve traditional and Hellenistic astrology apps: precessed fixed star conjunctions and the classical Arabic lots, the depth that professional and traditional practitioners expect and that generic chart APIs skip
Add the asteroid goddesses (Ceres, Pallas, Juno, Vesta) and mean and true Black Moon Lilith for archetypal and feminine-centered readings, the points modern self-discovery and astrology apps increasingly feature
Build predictive and timing features: secondary progressions, solar arc directions, and annual profections power forecast timelines, year-ahead reports, and time-lord tools without any astronomy code of your own
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.
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.
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.
Every page here is built so AI search engines can read and cite it, so go straight to the source. Let ChatGPT, Perplexity, or Claude search the web and tell you what they find about RoxyAPI accuracy, MCP, SDKs, and pricing.
Opens a live web search in a new tab.
From zero to production in 3 steps. No signup required for testing.
| 1Install the SDK | npm i @roxyapi/sdk |
| 2Get your API key | View Plans |
| 3Make your first call | View Docs |
Remote MCP, llms.txt, and AGENTS.md. The full agent-readiness stack for 12 spiritual domains under one key.
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
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.
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.
One call per sign returns a full horoscope with overview, love, career, health, finance, and advice, plus lucky numbers and colors, compatible signs, the active transits driving it, the current Moon sign and phase, and a daily energy rating. Content is genuinely different for each sign rather than one blurb reused twelve times. You can request a future date to pre-build a publishing calendar, and responses come in eight languages, which makes the astrology API a ready content engine for horoscope platforms and newsletters.
Ask for the current sky and you get live planetary positions back. Add a saved birth chart to the same request and the API also returns how today is touching that person specifically, telling you which aspects are building and which are fading so you can power a what is happening for me today feed. For longer arcs there are solar returns, lunar returns, and planetary return charts, including the Saturn return, which makes this a strong fit for wellness apps, lunar-cycle features, and AI companions that check in over time.
Yes. Our Remote MCP server runs over Streamable HTTP with no local setup and no Docker, so Claude, Cursor, ChatGPT, and VS Code agents connect in seconds and call birth chart, synastry, horoscope, and transit tools directly. An AGENTS.md playbook tells the agent how to chain those calls for a real task. If you prefer to write code, typed SDKs for TypeScript, Python, and PHP and a published llms.txt discovery file get you there just as fast.
Planet positions, house cusps, aspects, returns, and Moon phases come from Roxy Ephemeris, verified against NASA JPL Horizons, so the charts hold up to professional scrutiny. Pricing is flat and predictable, and one key unlocks not just Western astrology but all twelve spiritual-data domains on the platform, so you are never paying per product or stitching together separate vendors. There is a WordPress plugin and a set of drop-in UI components if you want chart visuals on a site without building them.
Ship your astrology app this weekend. Not this quarter.
All 12 domains included with every plan. Every endpoint, MCP server, SDK, and starters.
Plans from $39/mo — thats $3.25 per domain. No credit card required for testing.
View Pricing & Get API KeyHi, I'm Rosie, your guide to RoxyAPI's insight tools.
Ask me to read your birth chart, pull a card, or map your numbers, and I'll interpret what it means for you. Unlike most AIs, I never make the numbers up: every reading runs on real, verified calculations. Curious about the API, pricing, or docs instead? Ask me that too.