
AI Astrology Chatbot
Web App / Open Source30 minAI chatbot with real readings across all spiritual domains. Not hallucinations.
Bring 3,000 years of I-Ching wisdom to your app. In days.
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.iching.get(/* ... */)pip install roxy-sdkfrom roxy_sdk import create_roxy
roxy = create_roxy("your-api-key")
result = roxy.iching.get(...) # async: await roxy.iching.get_async(...)composer require roxyapi/sdkuse function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->iching->get(/* ... */);curl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/iching/claude mcp add --transport http \
roxy-iching https://roxyapi.com/mcp/iching \
--header "X-API-Key: YOUR_KEY"AI agents auto-discover all 9+ 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.
{
"seed": "roxy-demo",
"hexagram": {
"number": 25,
"symbol": "䷘",
"chinese": "無妄",
"english": "Innocence (The Unexpected)",
"pinyin": "Wu Wang",
"binary": "111001",
"upperTrigram": "Thunder",
"lowerTrigram": "Heaven",
"judgment": "Innocence. Supreme success. Perseverance furthers. If someone is not as he should be, He has misfortune, And it does not further him To undertake something.",
"image": "Under heaven thunder rolls: All things attain the natural state of innocence. Thus the kings of old, Rich in virtue, and in harmony with the time, Fostered and nourished all beings.",
"interpretation": {
"general": "Act with spontaneous sincerity and natural integrity, free from calculation or ulterior motives. When your actions arise from genuine inner truth rather than strategic thinking, the universe supports you. Unexpected events are part of the natural order. Accept them without blame.",
"love": "Approach love with sincerity and without ulterior motives. Genuine connection comes from innocence of intention. Let go of manipulation and expectation.",
"career": "Success comes from acting with integrity and without calculation. Trust the natural course of events. Unexpected good fortune comes to those who are sincere.",
"decision": "Act naturally without overthinking or scheming. Trust that right action leads to right outcomes. Deviating from your true nature brings misfortune.",
"advice": "Innocence means acting in accord with your true nature and the natural order. Forced action brings unexpected difficulties. Be genuine and accept what comes."
},
"changingLines": [
{
"position": 1,
"text": "Innocent behavior brings good fortune."
},
{
"position": 2,
"text": "If one does not count on the harvest while plowing, Nor on the use of the ground while clearing it, It furthers one to undertake something."
},
{
"position": 3,
"text": "Undeserved misfortune. The cow that was tethered by someone Is the wanderer's gain, the citizen's loss."
},
{
"position": 4,
"text": "He who can be persevering Remains without blame."
},
{
"position": 5,
"text": "Use no medicine in an illness Incurred through no fault of your own. It will pass of itself."
},
{
"position": 6,
"text": "Innocent action brings misfortune. Nothing furthers."
}
]
},
"lines": [
7,
9,
7,
8,
8,
7
],
"changingLinePositions": [
2
],
"resultingHexagram": {
"number": 21,
"symbol": "䷔",
"chinese": "噬嗑",
"english": "Biting Through",
"pinyin": "Shih Ho",
"binary": "101001",
"upperTrigram": "Thunder",
"lowerTrigram": "Fire",
"judgment": "Biting Through has success. It is favorable to let justice be administered.",
"image": "Thunder and lightning: The image of Biting Through. Thus the kings of former times made firm the laws Through clearly defined penalties.",
"interpretation": {
"general": "An obstacle blocks the path and must be removed decisively. Like biting through something hard to unite what has been separated, this situation calls for firm action and clear judgment. Legal matters, enforcement of standards, or cutting through deception may be required.",
"love": "Obstacles in the relationship must be confronted directly. Clear away what blocks true connection. Sometimes love requires decisively dealing with problems.",
"career": "Take decisive action to break through obstacles. Enforce standards and address problems that have been allowed to fester. Justice and clarity are needed.",
"decision": "The situation requires forceful action to break through resistance. Do not be timid—address the obstacle directly. Decisive measures bring success.",
"advice": "When something obstructs, bite through it. This is a time for clear action and the enforcement of standards. Obstacles must be removed for harmony to return."
},
"changingLines": [
{
"position": 1,
"text": "His feet are fastened in the stocks, So that his toes disappear. No blame."
},
{
"position": 2,
"text": "Bites through tender meat, So that his nose disappears. No blame."
},
{
"position": 3,
"text": "Bites on old dried meat And strikes on something poisonous. Slight humiliation. No blame."
},
{
"position": 4,
"text": "Bites on dried gristly meat. Receives metal arrows. It furthers one to be mindful of difficulties And to be persevering. Good fortune."
},
{
"position": 5,
"text": "Bites on dried lean meat. Receives yellow gold. Perseveringly aware of danger. No blame."
},
{
"position": 6,
"text": "His neck is fastened in the wooden cangue, So that his ears disappear. Misfortune."
}
]
}
}Structured JSON with documented fields. Not hallucinated text. See all 9+ endpoints
Works with your stack
I-Ching oracle API + hosted MCP for AI agents and developers. Connect Claude Code, Cursor, VS Code in seconds, no local setup. Access 3,000 years of Chinese wisdom with all 64 hexagrams, 384 changing lines, 8 trigrams, and modern interpretations for love, career, and decision-making. Cast readings with the authentic three-coin method, get daily hexagrams, and explore the Book of Changes programmatically. 9+ endpoints optimized for divination apps, AI oracle chatbots, fortune-telling platforms, daily wisdom features, and spiritual guidance products.
Multi-language API responses
Everything you need from our I-Ching API, built for production:
Complete 64 hexagram database with King Wen sequence, traditional Chinese names, pinyin, Unicode symbols, and binary patterns for authentic I-Ching readings
Modern interpretations for each hexagram covering general meaning, love and relationships, career guidance, decision-making wisdom, and actionable advice
384 changing line interpretations (6 lines x 64 hexagrams) explaining how each line transforms your reading and what the transition means for your situation
Authentic three-coin casting method with changing lines, resulting hexagram transformation, and seeded reproducibility for personalized daily oracle readings
Daily hexagram and daily cast endpoints with date-based seeding for consistent daily wisdom features, oracle of the day, and contemplation prompts
AI-optimized JSON responses with structured hexagram data, trigram analysis, and interpretations, perfect for MCP-powered I-Ching chatbots and LLM integration
Multi-language responses in 8 languages (EN, TR, DE, ES, HI, PT, FR, RU) via ?lang= query parameter
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.
Browse all templates or use AI prompts to generate a custom app.
Real-world applications and use cases for integrating I-Ching API into your projects:
Build I-Ching divination apps with authentic coin-toss readings: users ask their question and receive complete hexagram interpretations with changing lines and transformations
Add daily oracle features to wellness and meditation apps: daily hexagrams, daily cast readings, and contemplation prompts from 3,000 years of Chinese philosophy
Build AI I-Ching chatbots with MCP: your OpenAI, Claude, or Gemini agent auto-discovers oracle endpoints and delivers conversational hexagram readings
Create Chinese philosophy education platforms teaching the Book of Changes, Taoist principles, trigram symbolism, and hexagram patterns through interactive exploration
Ship comprehensive spiritual guidance platforms combining I-Ching with astrology, tarot, numerology, and dream interpretation under one API key
Power decision-making and journaling apps: users record situations, cast hexagrams, track how readings relate to outcomes, and gain clarity through structured ancient wisdom
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.
The I Ching API casts a reading with the traditional three-coin method in a single call and returns the primary hexagram, its full interpretation, the six lines read bottom to top, and any changing lines. You can pass an optional seed so the same question always returns the same reading, which is ideal for shareable or saved readings. One RoxyAPI key covers I Ching and eleven other domains, activation is instant, and the same casting is available to AI agents as a tool on our Remote MCP server with no local setup or Docker.
Yes. Every cast reports which lines are moving and, when one or more change, returns the resulting hexagram the reading transforms into, with its own judgment, image, and interpretation. Each hexagram also carries the text for all six changing lines, so you can explain exactly what a transition means rather than just naming it. This is the depth that turns a simple draw into a real I Ching reading.
Yes. The full 64-hexagram catalog ships in the traditional King Wen sequence, each with its Chinese name, pinyin, Unicode symbol, judgment, image, and layered interpretations for general guidance, love, career, and decisions. You can browse the whole catalog or fetch a single hexagram by its number. It is curated content across eight languages, so you can build a complete reference without sourcing and translating the text yourself.
Yes. The I Ching API resolves any six-line yin and yang pattern to its matching hexagram, so interfaces where users enter their own lines work out of the box. You also get all eight trigrams, the bagua building blocks such as Heaven, Earth, Fire, and Water, and every hexagram names its upper and lower trigram. Pair them to explain how two trigrams combine into a single meaning.
The I Ching API offers a daily hexagram and a full daily cast, both seeded by date so a given user sees the same result all day. That is exactly what oracle of the day, mindfulness, and contemplation features need, and it powers AI wisdom chatbots that reflect on one hexagram each morning. Drop it in with our typed SDKs for TypeScript, Python, and PHP, the WordPress plugin, or ready-made UI components.
Pricing is flat and predictable: one subscription unlocks I Ching plus astrology, tarot, numerology, dreams, and the rest of the twelve domains, with no per-domain or per-call fees. Activation is instant, so you can be casting hexagrams within minutes of signing up. AI agents connect to our Remote MCP server in seconds, and an AGENTS.md file plus llms.txt mean coding assistants can wire up the I Ching API for you.
Bring 3,000 years of I-Ching wisdom to your app. In days.
All 12 domains included with every plan. 9+ 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.