
AI Astrology Chatbot
Web App / Open Source30 minAI chatbot with real readings across all spiritual domains. Not hallucinations.
Ship a numerology app your users will love. This week.
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.numerology.get(/* ... */)pip install roxy-sdkfrom roxy_sdk import create_roxy
roxy = create_roxy("your-api-key")
result = roxy.numerology.get(...) # async: await roxy.numerology.get_async(...)composer require roxyapi/sdkuse function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->numerology->get(/* ... */);curl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/numerology/claude mcp add --transport http \
roxy-numerology https://roxyapi.com/mcp/numerology \
--header "X-API-Key: YOUR_KEY"AI agents auto-discover all 20 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.
{
"profile": {
"name": "Ada Lovelace",
"birthdate": "1815-12-10"
},
"coreNumbers": {
"lifePath": {
"number": 1,
"calculation": "Month: 12 → 1+2 = 3, Day: 10 → 1+0 = 1, Year: 1815 → 1+8+1+5 = 15 → 1+5 = 6 → 3+1+6=10 → 1",
"type": "single",
"hasKarmicDebt": false,
"meaning": {
"title": "The Leader",
"keywords": [
"independence",
"leadership",
"initiative",
"new beginnings",
"confidence",
"ambition",
"innovation",
"pioneer",
"self-reliance",
"courage"
],
"description": "The number 1, the very first of all numbers, puts power directly in our hands as a symbol of independence, confidence, and new beginnings. There is so much motivation and momentum surrounding this single-digit number. It is a true pioneer, eager to break ground on new endeavors and pave the way for others to follow. It is a natural leader and a proactive force. The number 1 represents newness, movement, and the possibilities that await us. In spiritual symbolism, it is the number of creation and the birth of all things, the divine origin of the universe. In Numerology the number 1 is the root of opportunity in our lives. It is a symbol of confidence, power, and action. It pushes us to look at our current circumstances and realize that we have the power to turn them into anything we wish. Even if we are afraid, the 1 inspires us to take control of our future and embrace new beginnings.",
"strengths": [
"Independent: Of all the numbers in Numerology, the 1 is the most self-sufficient, needing nothing but itself and its energy to thrive. It does not sit around waiting for opportunities to come about, it makes its own luck by capitalizing on circumstances others may be afraid to explore. The single-digit number 1 does not want to waste any time getting stuck negotiating or discussing plans. Going it alone allows for greater flexibility and quick, efficient movement.",
"Goal-oriented: With a positive outlook and unwavering self-determination, this number excels at setting and going after its goals. It has a hard time standing still because it sees a world packed with possibilities just waiting to be taken advantage of. It is not that the number 1 cannot be satisfied, rather, its satisfaction comes from staying active and always progressing. In a few words: Why stand still when you could advance?",
"Innovative: Roadblocks do not exist for the strong-willed 1, not because they do not arise, but because the innovative mindset of this number can find new ideas and creative solutions to work around them. Instead of being daunted by obstacles, the 1 looks at them as a challenge that must be (and will be) overcome. Seeing a door where others see a wall is a major asset to the success of the 1."
],
"challenges": [
"Forceful: While this number can come across as ambitious, its stop-at-nothing attitude can also make it seem uncaring or domineering as it pushes its way forward. More physical than spiritual, it does not need help from anyone and is too focused on its own pursuits to even realize when it has caused offense. Softer energies of cooperation and patience get shoved aside in the interest of movement and progress.",
"Risky: The number 1 would call itself fearless, but a lack of foresight can all-too-easily lead it into trouble that could have been avoided. Tunnel vision and an extreme sense of invincibility makes the 1 so focused on the path before it that it can miss the warning signs in its peripheral vision.",
"Doubtful: With such an extreme drive to accomplish and succeed, self-doubt is the Achilles heel of this number. Though it will not show it on the outside, the number 1 harbors a deep fear of making mistakes or coming up short of its goal. It takes even minor criticism to heart but will ultimately use it as motivation to improve."
],
"career": "Life Path 1 thrives in roles that offer autonomy and leadership. They excel as entrepreneurs, executives, inventors, and public speakers. Their independent and innovative nature makes a traditional 9-to-5 feel stifling, so they do best in positions where they can call the shots, guide the action, and pioneer new ground. Careers in tech startups, photojournalism, extreme sports, military leadership, politics, and freelance consulting are strong fits. Independence and adventure often matter more to them than money, though their drive usually attracts financial success naturally.",
"relationships": "In relationships, 1s are passionate and confident partners who lead with their heart and vision. Their independent streak can sometimes come across as domineering, so they thrive with partners who respect their autonomy while offering grounded support. Most compatible with Life Path 5 (shared love of adventure), 3 (lighthearted fun), and 6 (nurturing support). They may clash with other 1s or 8s due to competing drives for control. Learning to accept input, share decision-making, and temper their forceful energy with patience is key to lasting love.",
"spirituality": "Number 1 pulses with the energy of creation and new beginnings. It represents the first step, the original idea, the courage to stand alone. Spiritually, 1s are called to lead with authenticity rather than ego. Their soul lesson is learning that true strength comes from purpose, not dominance. They grow by setting bold intentions, embracing their pioneering spirit, and trusting that the universe supports those who dare to take the first step. Meditation on self-trust and morning intention-setting rituals align them with their highest potential."
}
}
},
"additionalInsights": {
"karmicLessons": {
"missingNumbers": [
2,
7,
8,
9
],
"lessons": [
{
"number": 2,
"lesson": "Learn cooperation, patience, and sensitivity",
"description": "Missing number 2 indicates challenges with teamwork and relationships. You may be impatient or insensitive to the needs of others.",
"howToOvercome": "Practice active listening. Work on group projects. Develop empathy through understanding different perspectives. Learn patience through meditation."
},
{
"number": 7,
"lesson": "Learn introspection, spirituality, and trust",
"description": "Missing number 7 indicates lack of inner development. You may be too focused on material world or struggle with faith.",
"howToOvercome": "Develop meditation practice. Study spiritual or philosophical topics. Spend time in nature and solitude. Learn to trust intuition."
},
{
"number": 8,
"lesson": "Learn material mastery, authority, and power",
"description": "Missing number 8 indicates challenges with money and authority. You may struggle with financial management or accepting power.",
"howToOvercome": "Study business and finance. Take leadership roles. Learn to manage resources effectively. Develop healthy relationship with money and power."
},
{
"number": 9,
"lesson": "Learn compassion, humanitarianism, and selflessness",
"description": "Missing number 9 indicates lack of universal compassion. You may be too self-focused or struggle with letting go.",
"howToOvercome": "Engage in humanitarian work. Practice forgiveness. Develop global perspective. Learn to give without expecting return."
}
],
"presentNumbers": {
"1": 3,
"2": 0,
"3": 3,
"4": 2,
"5": 2,
"6": 1,
"7": 0,
"8": 0,
"9": 0
}
},
"karmicDebt": {
"hasKarmicDebt": true,
"debtNumbers": [
19
],
"meanings": [
{
"number": 19,
"description": "Karmic Debt of Power Abuse",
"challenge": "Past life misuse of power or authority, possibly selfishness. May struggle with dependence vs independence.",
"resolution": "Learn to use power wisely and share it with others. Develop healthy independence while respecting others autonomy."
}
]
},
"hiddenPassion": {
"number": 1,
"count": 3,
"allPassions": [
1,
3
],
"title": "The Drive to Lead",
"description": "An intense drive toward independence, originality, and leadership. You are compelled to stand out and take charge. This passion fuels ambition but can become aggressive self-focus if unchecked."
}
},
"birthDayProfile": {
"day": 10,
"reducesTo": 1,
"title": "The Magnetic Initiator",
"keywords": [
"charisma",
"ambition",
"creativity",
"courage",
"optimism",
"risk-taking",
"all-or-nothing"
],
"description": "People born on the 10th carry the leadership energy of 1, softened and amplified by the infinite potential of 0. They are a gentler, more approachable version of the pure 1 energy, possessing all the ambition and drive of the trailblazer but with greater social grace and emotional awareness. The zero acts as a magnifier, expanding the creative potential of the 1 while smoothing its sharper edges. These individuals are born with the conviction that they can achieve anything, and this belief often becomes a self-fulfilling prophecy. They are ambitious, clear-minded, and remarkably decisive. Once they set a course, they pursue it with stubborn determination, refusing to stop until every plan is realized. Their courage is exceptional. They take risks that others find reckless, yet they succeed often enough to justify their boldness. They have vivid imaginations and genuine creative talent, which they combine with practical execution. Their weakness for recognition and public validation can lead them to prioritize appearance over substance. They crave honors, awards, and the spotlight. When channeled positively, this desire for recognition drives extraordinary achievement. When unchecked, it leads to superficiality and an exhausting need for external approval.",
"strengths": [
"Powerful charisma with natural ability to attract followers",
"Decisive action combined with creative imagination",
"Courage to take calculated risks that others avoid",
"Infectious optimism that motivates entire teams"
],
"challenges": [
"Excessive need for recognition and external validation",
"Inability to tolerate routine or mundane tasks",
"Tendency to dismiss details in favor of the big picture",
"Emotional volatility when authority is challenged"
],
"career": "They need high-energy careers that offer visibility, risk, and the chance to distinguish themselves. Entrepreneurship, stunt work, professional athletics, firefighting, emergency medicine, test piloting, and performing arts are all strong fits. They are attracted to anything that lets them demonstrate courage and receive recognition. They struggle in bureaucratic environments where advancement is slow and performance is measured by compliance rather than innovation.",
"relationships": "People born on the 10th are openly emotional and comfortable demonstrating their feelings, which makes the early stages of relationships exciting and intense. Problems arise when the novelty fades and daily life demands attention to mundane details. They can be impatient with domestic responsibilities and tend to consider themselves the ultimate authority on all household matters. They need a patient, adaptable partner who can enjoy the rollercoaster of their enthusiasm while gently grounding them in practical reality."
},
"maturityStatus": {
"isActive": true,
"currentAge": 211,
"activationRange": "35-40"
},
"luckyAssociations": {
"colors": [
"Red",
"Gold",
"Orange"
],
"gemstones": [
"Ruby",
"Garnet",
"Topaz"
],
"day": "Sunday",
"element": "Fire",
"rulingPlanet": "Sun",
"compatibleNumbers": [
1,
3,
5,
9
],
"incompatibleNumbers": [
2,
4,
8
]
},
"summary": "Your numerology chart reveals a Life Path 1 (The Leader), indicating independence, leadership, initiative energy. Your Expression number 9 shows The Humanitarian talents. Soul Urge 1 reveals The Leader inner desires, while Personality 8 projects The Powerhouse to the world. Birth Day 1 gives special independence abilities. Maturity 1 shows you will grow into The Leader.You have 4 karmic lesson(s) to learn. Karmic debt 19 requires attention. Your Personal Year 5 focuses on Freedom and Change."
}Structured JSON with documented fields. Not hallucinated text. See all 20 endpoints
Works with your stack
Production-ready Pythagorean numerology API + hosted MCP for AI agents and developers. Connect Claude Code, Cursor, VS Code in seconds, no local setup. Calculate life path, expression, soul urge, personality, and maturity numbers. Pinnacle and Challenge life phase timing with meanings. Hidden Passion, Subconscious Self, and Cornerstone/Capstone name analysis. Birth day 1-31 profiles, lucky associations (colors, gemstones, planets), personal year and month forecasts, relationship compatibility, karmic debt and lessons. Unicode-aware multilingual name handling: Spanish, French, German, Italian, Portuguese, Russian, Ukrainian, Belarusian, Hindi, Bengali, Tamil, Japanese, Chinese, Korean, Arabic, Greek, and Hebrew names produce correct Pythagorean numbers via automatic transliteration so accented and non-Latin scripts no longer silently drop letters. Now with both Pythagorean and Chaldean systems in a single call, Cheiro compound numbers (10 to 52) with planetary rulers, and business and brand name analysis. 20 endpoints with detailed interpretations optimized for numerology apps, editorial platforms, AI chatbots, wellness platforms, and spiritual services.
Multi-language API responses
Everything you need from our Numerology API, built for production:
Life Path number reveals life purpose and destiny from birth date - detects master numbers 11, 22, 33 and karmic debt 13, 14, 16, 19
Expression (Destiny) and Soul Urge numbers from full birth name - uncover natural talents, inner motivations, and spiritual mission
Relationship compatibility scoring (0-100) - weighted analysis of Life Path, Expression, Soul Urge with strengths, challenges, and advice for couples
Personal Year cycles (1-9) - annual forecasts with themes, opportunities, challenges, and strategic guidance for year-ahead planning
Karmic Lessons analysis - identify missing numbers in birth name revealing underdeveloped traits and growth opportunities
Complete numerology chart - all core numbers, pinnacles, challenges, hidden passion, subconscious self, name analysis, lucky associations, karmic analysis, and yearly forecast in a single API call
Pinnacle and Challenge numbers - four life phases with calculated age ranges, meanings, opportunities, and obstacles for predictive life timeline analysis
Birth Day profiles (1-31) - unique personality, career, and relationship insights per calendar day, not just the reduced single digit
Hidden Passion, Subconscious Self, Cornerstone, Capstone, and First Vowel analysis - deep name letter profiling for editorial-grade readings
Lucky associations per Life Path - colors, gemstones, ruling planet, element, compatible and incompatible numbers for personalized lifestyle content
Personal Year, Month, and Day forecasts - annual, monthly, and daily personalized themes and guidance for year-ahead, month-ahead, and daily planning
Bridge Numbers - reveal the gap between Life Path and Expression, Expression and Personality, Expression and Soul Urge with actionable advice for harmonizing different aspects of self
Maturity Number with activation status - reveals emerging life purpose around age 35-40, accepts raw name and birthdate or pre-calculated numbers
Compatibility accepts raw name and birthdate inputs - no pre-calculation needed, supports mixed mode (numbers for one person, raw inputs for the other)
Number meanings endpoint - fetch detailed 300-500 word interpretations for any number (1-9, 11, 22, 33) across all contexts
AI-optimized responses - structured JSON with keywords, descriptions, and context perfect for chatbot integration and LLM consumption
Pure mathematics - zero external dependencies, lightning-fast calculations under 20ms, no rate limiting by algorithm complexity
Proven accuracy - verified against authoritative Pythagorean numerology standards with step-by-step calculation strings for full transparency
Multi-language responses in 8 languages (EN, DE, ES, FR, HI, PT, RU, TR) via ?lang= query parameter
Global name input support - Spanish, French, German, Italian, Portuguese, Russian, Ukrainian, Belarusian, Hindi, Bengali, Tamil, Japanese (Hiragana and Katakana), Chinese, Korean, Arabic, Greek, Hebrew names automatically transliterated to Latin for correct Pythagorean number computation, so José Garcia, Анна, राज, 김민준, and 王明 all produce the same accurate output as their plain ASCII equivalents
Chaldean numerology system - the older 1 to 8 letter method (the number 9 is never assigned to a letter) returning Destiny, Soul Urge, and Personality numbers with planetary rulers and a caution flag for the karmic numbers 4 and 8
Cheiro compound numbers (10 to 52) - the unreduced fadic numbers that reveal the hidden influence behind a name, each with its classical symbol (the Wheel of Fortune, the Crown of the Magi) and full interpretation from the Book of Numbers
Dual-system readings in one call - Pythagorean and Chaldean name numbers side by side with an agreement flag, the only numerology API that returns both systems in a single request
Business and brand name numerology - Chaldean name number, planetary ruler, business rating, industry fit, and favorable-compound check for vetting company and product names
Click any endpoint to view detailed documentation, parameters, and response examples.
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.

Life Path. Expression. Soul Urge. Every core number.
Browse all templates or use AI prompts to generate a custom app.
Real-world applications and use cases for integrating Numerology API into your projects:
AI chatbots and assistants - integrate numerology readings into conversational AI, ChatGPT plugins, and virtual spiritual advisors with structured responses
Dating and relationship apps - add compatibility scoring to matchmaking algorithms, display Life Path synastry on profiles, show partnership potential scores
Personalized wellness platforms - generate automated numerology reports, birth chart PDFs, and daily/yearly guidance for meditation and self-discovery apps
Life coaching and therapy tools - support client sessions with Personal Year forecasts, karmic lesson identification, and life purpose clarity from Life Path analysis
Content generation systems - power horoscope-style content, numerology blog posts, and personalized email campaigns with accurate calculations and rich interpretations
Spiritual marketplaces and consultation services - enable quick numerology readings, tiered report generation (basic to premium), and automated client onboarding with full chart analysis
Business and brand naming tools - vet company and product names with Chaldean numerology, surface lucky numbers by industry, and compare name options before launch
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.
Send a birth date to the numerology API and you get the Life Path number back with a step-by-step calculation and a full written meaning. It uses the Pythagorean system, preserves master numbers, and flags karmic debt automatically. No birth time and no location are needed, so this is the single easiest spiritual reading to integrate. Your RoxyAPI key activates instantly and unlocks Life Path alongside 11 other domains, all on one flat plan.
Pass a full birth name and the numerology API returns the Expression number, also called the Destiny number, which maps every letter to reveal natural talents and life direction. Names in Latin and non-Latin scripts are handled, so accented and global names compute correctly. Drop it in with our typed SDKs for TypeScript, Python, and PHP, the WordPress plugin, or our Remote MCP server, with no local setup and no Docker. One key, instant activation, and the same name powers Soul Urge and Personality too.
The Soul Urge number, drawn from the vowels in a full birth name, reveals what a person truly wants underneath the surface. The numerology API returns it with a clear interpretation built for self-discovery, dating, and coaching products. Request Soul Urge on its own, or get it together with Life Path, Expression, Personality, Birthday, and Maturity in one full chart call. Responses are structured JSON, so they are easy to render in an app or hand straight to an AI agent.
Yes. Master numbers 11, 22, and 33 are kept intact instead of being reduced, and each comes with its own dedicated interpretation. Karmic debt numbers 13, 14, 16, and 19 are detected during the calculation and returned with their meanings. This depth ships across every reading, from a single Life Path call to the full chart with pinnacles, challenges, karmic lessons, and hidden passion. The math is transparent: every result includes the reduction steps so you can show your work.
Send a birth month and day with a target year and the numerology API returns the Personal Year cycle from 1 to 9, with its theme, keywords, and practical advice. Companion monthly and daily forecasts break the same energy into tighter guidance for planners and content automation. It is a natural fit for year-ahead emails, coaching check-ins, and daily insight feeds. Interpretations come in 8 languages through a single query parameter, professionally localized for each locale.
Yes. Give it two people, as either raw names and birth dates or pre-calculated numbers, and the numerology API returns a 0 to 100 compatibility score with shared strengths, challenges, and advice. You can mix the modes, so one partner can be a name and the other a number. Because numerology needs no birth time or coordinates, this is one of the fastest matchmaking features to ship into a dating or relationship product. It is also exposed as a tool on our Remote MCP server for AI agents and through llms.txt for AI search.
Pythagorean numerology maps letters 1 to 9 in alphabetical order and keeps the master numbers 11, 22, and 33. Chaldean numerology, the older system, maps letters 1 to 8 by vibration, never assigns 9 to a letter, and reads the unreduced compound number alongside the single-digit root. The numerology API returns both. Call the dual endpoint to get a name in both systems at once, with an agreement flag that shows whether they point to the same energy.
Yes. The Chaldean endpoint returns the Destiny, Soul Urge, and Personality numbers using the Chaldean letter values, each with its compound number, root, and planetary ruler. Compound numbers from 10 to 52, also called fadic numbers, carry the classical Cheiro interpretations such as the Wheel of Fortune and the Crown of the Magi. You can also look up any compound number directly, and analyze a business or brand name with the same Chaldean method.
Ship a numerology app your users will love. This week.
All 12 domains included with every plan. 20+ endpoints, 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.