
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.
Life PathNumerology ChartCompatibilityPersonal YearExpression …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.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(/* ... */);dotnet add package RoxyApi.Sdkusing RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
// await roxy.Numerology.<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.Numerology.<Method>(context.Background(), nil)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 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.
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": "John William Smith",
"birthdate": "1990-07-15"
},
"coreNumbers": {
"lifePath": {
"number": 5,
"calculation": "Month: 7, Day: 15 → 1+5 = 6, Year: 1990 → 1+9+9+0 = 19 → 1+9 = 10 → 1+0 = 1 → 7+6+1=14 → 5",
"type": "single",
"hasKarmicDebt": true,
"karmicDebtNumber": 14,
"meaning": {
"title": "The Adventurer",
"keywords": [
"freedom",
"adventure",
"change"
],
"description": "The 5 is the most kinetic of all single-digit numbers. It is in constant motion, oriented toward what is new, and constitutionally resistant to the kind of settled routine that other numbers find stabilizing. Occupying the center of the 1-through-9 sequence, the 5 functions as a pivot point: it has engaged with enough of life to know that many directions are possible, and its primary drive is to explore as many of them as it can. This number is defined by versatility and adaptability; it adjusts to new circumstances not through effort but through a genuine responsiveness to its environment that makes transitions feel natural. The freedom the 5 requires is not simply physical; it is cognitive and relational as well. It needs room to form its own opinions, change them without pressure, and pursue experience without being constrained by convention. At its most developed, the 5 harnesses its wide-ranging engagement with life into wisdom that only direct experience can produce.",
"strengths": [
"Adaptable: The 5 adjusts to new conditions with a fluidity that most other numbers find difficult to achieve. Changes of environment, circumstance, or direction that would unsettle a 4 or frustrate a 6 are absorbed by the 5 with minimal disruption. This adaptability is not indifference; it reflects a genuine curiosity about what each new situation contains. The 5 treats transition as information rather than threat.",
"Resourceful: When conventional approaches do not serve, the 5 draws on a broad repertoire of experience to find an alternative. Its exposure to varied people, environments, and situations gives it a practical creativity that is grounded in what has actually worked rather than in theory. The 5 does not wait for ideal conditions; it works with what is available and finds a way through.",
"Socially fluent: The 5 moves easily across different social contexts, adapting its communication style to connect with a wide range of people. This social fluency reflects a genuine interest in others and an ability to find common ground across significant differences. The 5 is often the person who can build a bridge between groups that have difficulty understanding each other."
],
"challenges": [
"Unreliable: The same mobility that makes the 5 effective can make it difficult to count on. Its attention shifts with genuine speed, and commitments made during a period of enthusiasm may not survive the arrival of something more immediately compelling. This inconsistency is rarely malicious, but it produces real costs in professional relationships and personal ones where others have organized their expectations around the word of the 5.",
"Impulsive: The preference for direct experience over careful planning means the 5 often acts before considering consequences. This impulsiveness generates interesting experiences and occasionally stumbles into the right answer, but it also produces avoidable difficulties that a modest investment in forethought would have prevented. The 5 does not naturally slow down to evaluate; it moves first and recalibrates afterward.",
"Directionless: The abundance of interests available to the 5 can produce a life that is wide but not deep. Without a chosen direction to organize its energy, the 5 may move through many experiences without accumulating the competence and mastery that comes from sustained engagement with a single domain. The result can be a restlessness that never quite resolves into genuine fulfillment."
],
"career": "The 5 requires variety, autonomy, and stimulation in its professional life. Sales, journalism, public relations, travel-related work, entrepreneurship, and roles requiring frequent contact with new people and situations suit this number well. It performs poorly under rigid management structures or in repetitive environments where each day resembles the last. The 5 often changes career directions multiple times before finding a role that offers the scope it requires, and the experience gained along the way is rarely wasted.",
"relationships": "The 5 brings vitality and spontaneity to relationships but requires genuine freedom within them to function well. It is more loyal than it initially appears: once genuinely committed, it maintains that commitment. The difficulty arises in reaching that commitment, as the 5 resists anything that feels like confinement. Partners who respect its independence and bring their own richness to the relationship tend to hold the attention of the 5 most durably. A relationship that claims the 5 must earn it.",
"spirituality": "The 5 encounters the sacred primarily through direct experience rather than formal practice. Travel, conversation with diverse people, and immersion in unfamiliar environments are all forms of spiritual inquiry for this number. Its lesson is that genuine freedom is not the absence of commitment but the presence of a chosen direction. The 5 develops spiritually when it learns to distinguish restlessness from growth, and when it recognizes that depth and freedom are not opposites."
}
},
"expression": {
"number": 6,
"calculation": "J=1, O=6, H=8, N=5, W=5, I=9, L=3, L=3, I=9, A=1, M=4, S=1, M=4, I=9, T=2, H=8 → 1+6+8+5+5+9+3+3+9+1+4+1+4+9+2+8 = 78 → 15 → 1+5 = 6",
"type": "single",
"hasKarmicDebt": false,
"meaning": {
"title": "The Nurturer",
"keywords": [
"love",
"harmony",
"responsibility"
],
"description": "The 6 is the most relationship-oriented of the single-digit numbers, organized around a genuine drive to care for those within its sphere. Its instinct is to tend: to notice when someone needs support and to provide it in ways that are practical and consistent rather than occasional and showy. This quality is not merely sentiment; the 6 experiences the wellbeing of others as intimately connected to its own wellbeing, which gives its caregiving a depth of investment that others rarely match. The 6 is also the most aesthetically attuned of all single-digit numbers, drawn to beauty, harmony, and the creation of environments where people feel at ease. Across numerology traditions, this number is regarded as the most harmonious of the nine: at its best it embodies the mature expression of love as active responsibility rather than passive feeling. Its challenge is learning that care without boundaries depletes rather than sustains.",
"strengths": [
"Supportive: The 6 offers support that is attentive and real rather than general and reflexive. It pays close attention to what others actually need, and its response is calibrated to the specific situation rather than a generic expression of concern. This quality makes the 6 one of the most effective caregivers of all numbers: people in its circle know they will receive genuine help rather than symbolic sympathy.",
"Protective: The 6 is quietly fierce in defense of those it cares for. Its warmth does not preclude assertiveness; when the people or values it holds most closely are at risk, the 6 will respond with a directness that can surprise those who only know its gentler register. The protective instinct of the 6 extends to community and broader social concerns, not only to immediate family.",
"Responsible: The 6 takes its obligations seriously and follows through on them without requiring external pressure. Whether the commitment is to a family member, a colleague, or a cause, the 6 does what it said it would do, and it does so before the reminder arrives. This quality generates trust that accumulates over time and defines how others understand and rely on this number."
],
"challenges": [
"Overprotective: The care the 6 offers can tip into control when it becomes convinced that its judgment about what others need is more reliable than their own. This overreach, always well-intentioned, denies others the opportunity to navigate difficulty independently. The 6 genuinely believes it is helping; the difficulty is that its helping sometimes prevents the growth that comes from encountering and resolving one problems independently.",
"Self-neglecting: The 6 prioritizes others so consistently that its own needs are regularly deferred or ignored entirely. The result is a gradual depletion that the 6 is often slow to recognize, partly because caring for others feels like what it is supposed to be doing. When the depletion becomes severe, the 6 can become resentful or withdrawn, behaviors that seem at odds with its usual warmth but are the predictable consequence of unsustained giving.",
"Idealistic: The 6 holds a vision of how relationships and communities ought to function, and it can experience significant distress when reality falls consistently short of that vision. This idealism is generative at its best, motivating the 6 to create better environments for those around it. But when it becomes a standard that no real situation can meet, it produces chronic disappointment and a moralizing quality that others find difficult to be around."
],
"career": "The 6 is most effective in roles where its capacity for care and its aesthetic sensibility can both find expression. Healthcare, counseling, teaching, social work, and community organizing fit this number naturally. Its eye for beauty and harmony also serves it in interior design, hospitality, and the arts. The 6 is most fulfilled when it can see a direct connection between its daily work and the wellbeing of the people or environments it serves.",
"relationships": "The 6 is a devoted and attentive partner who brings warmth, stability, and genuine investment to its closest relationships. Its love is expressed through consistent action rather than declaration. The risk is a tendency to over-function for others while under-attending to its own needs, creating an imbalance that strains the relationship over time. The most successful partnerships for the 6 are those in which mutual care flows in both directions and honesty is valued above surface harmony.",
"spirituality": "The spiritual life of the 6 is inseparable from its relational life. It finds the sacred in acts of genuine service, in the beauty of natural and created environments, and in the experience of being genuinely connected to another person. Its spiritual lesson is that real service is sustainable only when the 6 first acknowledges its own needs as legitimate. The practice of receiving care with the same openness it extends to others is a significant developmental threshold for this number."
}
}
}
}Structured JSON with documented fields. Not hallucinated text. See all endpoints
Render Numerology 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 Numerology calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.
Numerology card widget snippet
Reference card widget snippet
The complete UI libraryExplore Roxy UI| Element | Renders |
|---|---|
| <roxy-compatibility-card> | Score card with category breakdown |
| <roxy-numerology-card> | Life path, expression, soul urge, personality, personal year, full chart |
| <roxy-reference-card> | Symbol, name, description, keyword chips, and an attribute grid for any glossary lookup |
Works with your stack
Numerology API to calculate life path, expression, soul urge, personality, and maturity numbers, with Pinnacle and Challenge life-phase timing, Hidden Passion, Subconscious Self, and Cornerstone and Capstone name analysis. Birth day 1-31 profiles, lucky associations (colors, gemstones, planets), personal year and month forecasts, relationship compatibility, and karmic debt and lessons. Unicode-aware multilingual name handling transliterates Spanish, French, German, Russian, Hindi, Bengali, Tamil, Japanese, Chinese, Korean, Arabic, Greek, and Hebrew names to correct Pythagorean numbers so non-Latin scripts no longer drop letters. Both Pythagorean and Chaldean systems in one call, Cheiro compound numbers (10 to 52) with planetary rulers, and business and brand name analysis. Built for numerology apps, editorial platforms, AI chatbots, and wellness services. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.
Every Numerology calculation is covered by 6,044 automated tests per deploy, 1241 of them gold-standard tests locked to named external references such as NASA JPL Horizons, with a public MIT benchmark repo anyone can clone and re-run. See how we test.
Multi-language API responses
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
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
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.

The practitioner website you own. Free birth charts, tarot, and human design built in.

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.
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 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 Numerology endpoint runs live in the API playground
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, PHP, C#, and Go, 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. Every endpoint, MCP server, SDK, and starters.
Plans from $39/mo, starting at $2.70 per domain on annual billing. No credit card required for testing.
View Pricing & Get API 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.