I-Ching Oracle API
Bring 3,000 years of I-Ching wisdom to your app. In days.
Start building in seconds
npm install @roxyapi/sdkimport Roxy from '@roxyapi/sdk'
const roxy = new Roxy({ apiKey: 'your-key' })
const data = await roxy.i-ching.get(/* ... */)curl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/iching/claude mcp add --transport http \
roxy-iching-api https://roxyapi.com/mcp/iching-api \
--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 starter app 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.
{
"hexagram": {
"number": 11,
"symbol": "䷊",
"chinese": "泰",
"english": "Peace",
"pinyin": "Tai",
"upperTrigram": "Earth",
"lowerTrigram": "Heaven",
"judgment": "Peace. The small departs, the great approaches. Good fortune. Success.",
"image": "Heaven and earth unite: the image of Peace. The ruler fashions the way of heaven and earth.",
"interpretation": {
"general": "A period of harmony and prosperity. Heaven and earth are in balance...",
"love": "Deep mutual understanding and emotional harmony flourish now...",
"career": "Exceptional opportunities for advancement and collaboration...",
"decision": "The time is right for bold action. Conditions strongly favor your plans...",
"advice": "Embrace this harmonious period. Build partnerships and share abundance..."
}
},
"lines": [
7,
8,
9,
7,
6,
8
],
"changingLinePositions": [
3,
5
],
"resultingHexagram": {
"number": 34,
"english": "The Power of the Great",
"symbol": "䷡"
}
}Structured JSON with documented fields. Not hallucinated text. See all 9+ endpoints
Works with your stack
Multi-language API responses
I-Ching oracle API + MCP for AI agents and developers. 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.
Key Features
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
All 9+ Endpoints
Click any endpoint to view detailed documentation, parameters, and response examples.
Get daily I-Ching hexagram
Receive a daily I-Ching hexagram for guidance and reflection. This endpoint uses seeded randomness to ensure the same seed gets the same hexagram on the same day - perfect for "Hexagram of the Day" features in oracle apps, meditation platforms, and daily wisdom tools. Returns the hexagram with judgment, image, and interpretations for love, career, decisions, and practical advice based on ancient Chinese wisdom from the Book of Changes.
Cast daily I-Ching reading with changing lines
Cast a complete daily I-Ching reading using the traditional three-coin method with seeded randomness. Unlike the simple daily hexagram, this provides the full casting experience with line values (6-9), changing line positions, and the resulting hexagram if transformation occurs. Same seed + same date = same casting result. Perfect for I-Ching divination apps requiring authentic oracle experience with daily consistency.
List all 64 hexagrams
Browse all 64 I-Ching hexagrams from the Book of Changes with their Chinese names, English translations, and trigram compositions. The hexagrams are ordered by the traditional King Wen sequence used in I-Ching divination for 3,000 years. Each hexagram represents a unique life situation combining two trigrams (Heaven, Earth, Thunder, Wind, Water, Fire, Mountain, Lake) into profound wisdom for decision-making and self-understanding.
Get a random hexagram
Receive a random I-Ching hexagram with full interpretation. Perfect for daily oracle features, meditation prompts, or exploring the Book of Changes. Returns complete hexagram data including judgment, image, interpretations for love/career/decisions, and all six changing line meanings.
Lookup hexagram by line pattern
Find an I-Ching hexagram by its binary line pattern. Provide 6 digits (0 or 1) representing broken (yin) and solid (yang) lines from bottom to top. Use this for custom divination interfaces where users input their own line configurations, or to find hexagrams matching specific trigram combinations. Example: "111111" returns Hexagram 1 (The Creative), "000000" returns Hexagram 2 (The Receptive).
Get hexagram by number
Retrieve complete I-Ching hexagram details by King Wen sequence number (1-64). Returns the full hexagram with Chinese name, English translation, judgment text, image text, modern interpretations for general situations, love, career, and decision-making, plus all six changing line meanings. Use this to display detailed hexagram information after casting or for educational reference.
Cast an I-Ching reading
Generate an authentic I-Ching reading using the traditional three-coin casting method. Each of the six lines is determined by virtually tossing three coins, producing values 6-9 where 6 (old yin) and 9 (old yang) are changing lines. Returns the primary hexagram with full interpretation, the line values showing which lines are changing, and if any lines change, the resulting hexagram that the primary transforms into. Optionally provide a seed for reproducible castings. Perfect for divination apps, oracle features, and decision-making tools.
List all 8 trigrams
Retrieve all 8 I-Ching trigrams (bagua) - the fundamental building blocks of hexagrams. Each trigram consists of three lines and represents a primal force of nature: Heaven (Qian), Earth (Kun), Thunder (Zhen), Wind (Xun), Water (Kan), Fire (Li), Mountain (Gen), and Lake (Dui). Understanding trigrams is essential for interpreting hexagram meanings, as each hexagram combines an upper and lower trigram.
Get trigram by number or name
Retrieve a specific I-Ching trigram by its number (1-8) or English name (Heaven, Earth, Thunder, Wind, Water, Fire, Mountain, Lake). Returns complete trigram information including Chinese name, pinyin, element associations, core attributes, and symbolic meaning. Use this to understand the component trigrams of any hexagram.
What You Can Build with I-Ching API
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
What developers are saying
Dhani M.
Indie App Developer
Shipped an astrology app in 3 days. Birth charts, nakshatras, KP cusps, significators. I verified the Lahiri ayanamsha values independently and they are spot on. 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.
Getting Started with I-Ching API
From zero to production in 3 steps. No signup required for testing.
3 Steps to Ship
| 1Install the SDK | npm i @roxyapi/sdk |
| 2Get your API key | View Plans |
| 3Make your first call | View Docs |
Agent-Ready Infrastructure
MCPThe only MCP server covering 9 spiritual domains under one key
- MCP server — 9+ tools auto-discovered by Claude, ChatGPT, Cursor
- llms.txt — AI-native documentation for code generation
- AGENTS.md — Included in SDK for GitHub Copilot, Windsurf, Cline
Start Using I-Ching API Today
Bring 3,000 years of I-Ching wisdom to your app. In days.
All 9 domains included with every plan. 9+ endpoints, MCP server, SDK, and starters.
Plans from $39/mo — thats $4.33 per domain. No credit card required for testing.
View Pricing & Get API Key