I Ching Oracle API
Access 3,000 years of Chinese wisdom through the I Ching Oracle API. Complete access to all 64 hexagrams with traditional judgments, images, and modern interpretations for love, career, and decision-making. Cast readings using the authentic three-coin method, explore the 8 trigrams, and decode hexagram patterns. Build divination apps, fortune-telling platforms, and ancient wisdom tools.
Instant API Key Delivery • No Sign-Up Required • Production Ready
Want to get started faster? Check out our free starter apps and templates for complete examples and code you can customize.
I Ching Oracle API Features
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.
Production-ready capabilities for your application. Click any feature to view detailed documentation and code examples.
Key Features
Everything you need from our I Ching API, built for production:
Complete 64 hexagram database with King Wen sequence numbering, traditional Chinese names, pinyin romanization, and multiple English translations for authentic I Ching readings
Traditional Judgment and Image texts for each hexagram plus modern interpretations covering general meaning, love and relationships, career guidance, and decision-making wisdom
384 changing line interpretations (6 lines per hexagram) explaining how each line transforms your reading and what the transition means for your situation
Authentic three-coin casting method simulation generating hexagram readings with changing lines automatically calculated and resulting hexagram determined
All 8 trigram references (Heaven, Earth, Thunder, Wind, Water, Fire, Mountain, Lake) with elements, attributes, and symbolic meanings for deeper hexagram analysis
Hexagram lookup by binary pattern enabling custom divination interfaces where users input line configurations to find matching hexagram interpretations
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 resulting transformations
Create daily oracle features for wellness and meditation apps - deliver daily I Ching insights, hexagram of the day, or contemplation prompts from ancient Chinese philosophy
Power AI-assisted decision-making tools that combine I Ching wisdom with modern coaching - help users gain clarity on life choices through structured ancient guidance
Develop Chinese philosophy education platforms teaching the Book of Changes, Taoist principles, and hexagram symbolism through interactive hexagram exploration
Build fortune-telling and spiritual guidance platforms combining I Ching with astrology, tarot, and numerology for comprehensive divination experiences
Create journaling apps that incorporate I Ching readings - users record situations, cast hexagrams, and track how readings relate to outcomes over time
Getting Started with I Ching API
Start building in under 2 minutes. No signup required.
Next Steps
| Get your API key | View Plans |
| Explore the API | View Docs |
AI-Native Integration
MCPFirst-class Model Context Protocol support for AI agents and autonomous applications
Start Using I Ching API Today
Ancient wisdom for modern decisions
Choose a plan and get your API key instantly delivered to your email. No credit card required for testing. Pay-as-you-go pricing with 9+ endpoints included.
View Pricing & Get API Key