

An I Ching reading that interprets every changing line, not just the hexagram it lands on.
Daily Hexagram · I Ching Reading · Hexagram · Trigram
Included with every plan (at no extra cost)
Three-coin casting with old and young lines
Every changing line read by position and polarity
Resulting hexagram the reading transforms into
Hexagram of the day and a daily cast
King Wen sequence with Chinese name and pinyin
Judgment and Image for every hexagram
Readings for love, career and decisions
Lookup by yin and yang line pattern
Bagua trigrams as upper and lower pairs
Element, direction, season and family member
Body part, animal and core attribute
I-Ching oracle API 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 a daily hexagram, and explore the Book of Changes programmatically. Built for divination apps, AI oracle chatbots, fortune-telling platforms, daily wisdom features, and spiritual guidance products. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.
Every I-Ching calculation is covered by 13,957 automated tests per deploy, 3,683 of them gold-standard tests locked to the named references on our methodology page. See how we test.
Interpretations in English, Deutsch, Español, Français, हिन्दी, Português, Русский, Türkçe, one query parameter away.
Paste a widget into any site builder, install the WordPress plugin, or start from an MIT template you can white-label. Results render from the I-Ching Oracle API with no backend.
A Remote MCP server exposes every endpoint as a tool for Claude, ChatGPT, Cursor and any MCP client, with no local install. Opt-in compact responses cut the tokens your agent reads by roughly 40 to 52 percent, and one call stays one request.
Typed SDKs for TypeScript, Python, PHP, C#, Go, and Rust, generated from the live spec, each with an AGENTS.md so your coding assistant calls the I-Ching Oracle API correctly.
This is what your visitors see. Paste one snippet into Wix, Squarespace, or WordPress and the I-Ching Oracle API reading appears on your site, with no code and no backend. Developers install the same components from npm for Next.js, React, Vue, Svelte, Angular, or plain HTML. MIT licensed and included in every plan.
| Element | Renders |
|---|---|
<roxy-hexagram> | Hexagram figure with trigrams, judgment, image, and a reading per line (statement plus meaning); a cast highlights the moving lines and the resulting hexagram |
<roxy-reference-card> | Symbol, name, description, keyword chips, and an attribute grid for any glossary lookup |
The depth behind every line above, written out in full.
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 domain = roxy.ichingpip install roxy-sdkfrom roxy_sdk import create_roxy
roxy = create_roxy("your-api-key")
domain = roxy.ichingcomposer require roxyapi/sdkuse function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$domain = $roxy->iching;dotnet add package RoxyApi.Sdkusing RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var domain = roxy.Iching;go get github.com/RoxyAPI/sdk-goimport roxyapi "github.com/RoxyAPI/sdk-go"
roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
domain := roxy.Ichingcargo add roxyapiuse roxyapi::Roxy;
let roxy = Roxy::new(std::env::var("ROXY_API_KEY")?)?;
let domain = roxy.iching();claude mcp add --transport http \
roxy-iching https://roxyapi.com/mcp/iching \
--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.
Full MCP setup guidecurl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/iching/Generating your own client? Get the I-Ching OpenAPI schema.
Want to ship faster? Clone a free template and white-label it as your own app.
Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app.
Building on WordPress? Install the RoxyAPI plugin and drop a shortcode, no code required.
{
"hexagram": {
"number": 3,
"symbol": "䷂",
"chinese": "屯",
"english": "Difficulty at the Beginning",
"pinyin": "Zhūn",
"binary": "100010",
"upperTrigram": "Water",
"lowerTrigram": "Thunder",
"judgment": "Something real is being born and the birth is hard, so progress is available but only through firmness and through help. Start nothing else until this one thing has taken root, and appoint people to carry part of the load.",
"image": "Thunder moves beneath the clouds, energy pushing upward into conditions that have not yet cleared. Sort the tangle strand by strand and put order into the confusion before you apply any force.",
"interpretation": {
"general": "The birth of something new is always chaotic. Confusion and obstacles mark the early stage of any significant beginning. Do not rush forward or force outcomes. Gather support, organize your resources, and allow things to take shape naturally. Patience at the outset prevents failure later.",
"love": "New relationships face natural confusion and misunderstandings. Be patient with the awkward beginning stages. Do not force closeness: let love take form slowly like a river finding its path.",
"career": "Starting a new venture or project brings challenges. Do not expand too quickly. Focus on establishing a solid foundation and gathering the right helpers before moving forward.",
"decision": "Hold back from premature action. The confusion you feel is natural when something new is forming. Seek assistance and guidance rather than pushing through alone.",
"advice": "Bring order out of chaos step by step. Like untangling silk threads, patience and method are required. Everything of value takes time to grow."
},
"changingLines": [
{
"position": 1,
"text": "The first push meets resistance, so hold your ground and appoint helpers.",
"meaning": "The first place is the beginning and this yang line has drive with no road under it. Force applied now goes nowhere and burns the strength that will be needed later. Stay correct, stay put, and build the alliances that will move the thing when it can be moved."
},
{
"position": 2,
"text": "The horses turn back and the chariot halts, but the man riding up is a suitor and not a raider; she keeps her word and does not marry for ten years.",
"meaning": "The second place is inner and supported, but this yin line is pressed by strength that is close and immediate rather than correct. What is nearest is not what belongs to the querent. Refuse the convenient offer and hold out for the right one, even when the wait is long."
},
{
"position": 3,
"text": "Chasing the deer into the forest with no forester to guide you only loses you among the trees.",
"meaning": "The third place is the exposed threshold, and this yin line has appetite without competence and without a guide. The pursuit itself is the error, and going deeper only buries it. Abandon the chase now, because carrying on will be regretted."
},
{
"position": 4,
"text": "The chariot turns back once more, but a union is offered, and going forward with it succeeds.",
"meaning": "The fourth place is near power, and this yin line cannot cut through the difficulty on its own strength. Admitting that is the intelligence of the line rather than its weakness. Accept the help that is genuinely offered and move with it, because alone the querent stalls."
},
{
"position": 5,
"text": "What you have to give cannot reach far through the obstruction: small measures succeed, and large ones fail.",
"meaning": "This is the ruling line, yang in the place of authority, but the hexagram is obstruction and even a sound ruler cannot distribute freely through it. Ambition scaled to the moment is rewarded, and ambition scaled to the title is not. Give what can actually reach people and postpone the grand gesture."
},
{
"position": 6,
"text": "The horses turn back a final time, and tears of blood run down.",
"meaning": "The sixth place is past the peak, and this yin line is spent at the deepest point of the obstruction with nothing left to push. Persisting here is what produces the grief. Stop, withdraw, and accept that this attempt is finished."
}
]
},
"lines": [
9,
8,
8,
8,
7,
8
],
"changingLinePositions": [
1
],
"resultingHexagram": {
"number": 8,
"symbol": "䷇",
"chinese": "比",
"english": "Holding Together (Union)",
"pinyin": "Bǐ",
"binary": "000010",
"upperTrigram": "Water",
"lowerTrigram": "Earth",
"judgment": "Union is right and it is available, but examine yourself first and be sure you carry the constancy others can safely gather around. Those who join in time do well, and whoever waits until the thing is settled arrives too late.",
"image": "Water lies over the earth and fills every hollow in it, touching the ground at every point. Bind yourself to people the same way, closing the gaps rather than governing them from a distance.",
"interpretation": {
"general": "This is a time for forming alliances and building connections. Unity and cooperation bring success. Examine whether the bonds you are forming are based on sincerity and mutual benefit. The leader of any group must be worthy of trust, and followers must be genuine in their commitment.",
"love": "Seek genuine connection built on mutual trust and loyalty. Join with those who share your values. Unity in relationships comes from authentic commitment, not obligation.",
"career": "Success comes through forming alliances and building cooperative relationships. Seek out those whose strengths complement yours. Together you can achieve what neither could alone.",
"decision": "The time is favorable for joining with others. Examine whether the partnership is based on genuine alignment of values. True union brings mutual benefit.",
"advice": "Hold together with others sincerely. Late joiners may find less favor: commit fully when you see the right opportunity. Unity requires trust both given and received."
},
"changingLines": [
{
"position": 1,
"text": "Come with sincerity and there is no fault: a plain clay vessel filled to the brim brings good fortune in the end.",
"meaning": "The first place is the start of the union, and this yin line brings nothing but honesty, which is exactly what is required of it. What is inside the vessel is what counts, and what the vessel is made of does not. Approach without ornament and the connection holds."
},
{
"position": 2,
"text": "The attachment forms from within.",
"meaning": "The second place is inner and central, and this yin line answers the ruling line out of genuine agreement rather than pressure. A union that starts on the inside is stable, and one that is bought is not. Join because you actually agree, and never sell yourself into it."
},
{
"position": 3,
"text": "You are keeping company with people you do not belong with.",
"meaning": "The third place is the exposed threshold, and this yin line is surrounded by others as weak as itself with no correct partner anywhere near. Proximity is not alliance, and habit is not loyalty. Look hard at who is actually around you and detach before the association costs you."
},
{
"position": 4,
"text": "Hold to the one above you, and do it openly.",
"meaning": "The fourth place is next to power, and this yin line is correctly placed to support it rather than compete with it. Loyalty declared in the open is safe, and loyalty that hedges is what gets punished. Commit visibly and stay firm."
},
{
"position": 5,
"text": "The king drives the game from three sides and leaves the fourth open, and his townspeople do not close it either.",
"meaning": "This is the ruling line, yang in the place of authority, and it is the model for how union is properly formed. People are gathered by being left free to leave, never by closing the circle around them. Hold the center, take whoever comes willingly, and let the rest go."
},
{
"position": 6,
"text": "The union is entered without a head, and it comes to nothing.",
"meaning": "The sixth place is past the peak, and this yin line has waited until the alliance has already formed and now wants a place in it. Joining late and without commitment leaves the querent standing outside the thing that was joined. Accept that the moment has passed, and do not fake an allegiance that has no beginning."
}
]
}
}Structured JSON with documented fields. Not hallucinated text. See all endpoints
Clone. Edit. Ship. Free and open source by Team Roxy.

AI chatbot with real readings across all domains. Not hallucinations.

Talk to the stars. Real readings across every domain, spoken aloud.

A multi-agent astrology reader in n8n, on web chat and Telegram, with a forecast every morning.

Independent proof, domain by domain. Every reference value cited, rerun monthly.
Browse all templates or use AI prompts to generate a custom app.
The products teams ship on the I-Ching Oracle API.
Real calls against the production API, no account needed. Every endpoint sits in the public OpenAPI spec and is callable as an MCP tool; open one for its parameters and response examples.
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 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.
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.
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.
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).
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.
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.
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.
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.
Course creator, Denmark
I think you have done an amazing job, it must have taken a long time. Clients are happy, and so am I.
Natal chart, transit, horoscope, tarot, dream and crystal readings inside her online courses
Founder, United States
I use RoxyAPI as the data layer for my astrology assistant. It has been reliable.
An astrology assistant on Vedic and KP, dashas, divisional charts, panchang, Western astrology, numerology and tarot
Founder, Portugal
I really appreciate the quick and helpful support from the RoxyAPI team.
A self-knowledge platform that combines Astrology, Human Design, Numerology, BaZi and other traditions into one personal reading
Every customer story comes from an account we confirmed and is published with the approval of that customer.
Read customer storiesThe 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.
Your AI agent
your model, your voice
Remote MCP
auto-discovered, no local setup
Token-optimizedRoxy Ephemeris
13,957 tests, 3683 gold standard
Verified result
18+ domains, one flat rate
Your agent uses calculated charts and readings in its replies, with your model and your own voice. Planetary positions are verified against NASA JPL Horizons. No local setup, no AGPL, no hosted-AI markup.
Audit it yourself: every I-Ching endpoint runs live in the API playground
Included in the same plan as I-Ching Oracle
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 a casting can be reproduced exactly, which is ideal for shareable or saved readings. One RoxyAPI key covers I Ching and every other RoxyAPI domain, 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 of the six lines carries both its oracle statement and a written meaning, so you can explain exactly what a moving line is asking for rather than handing a user a line of archaic verse and leaving them to guess. That is the depth that turns a simple draw into a real I Ching reading, and it is why an LLM reading our payload does not have to make the interpretation up.
Yes. The full 64-hexagram catalog ships in the traditional King Wen sequence, each with its Chinese name, pinyin with tone marks, Unicode symbol, upper and lower trigram, 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. The readings are our own editorial content, written from the mechanics of the hexagram and checked against the tradition, so you can build a complete reference without sourcing and licensing 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 stable for the day 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, PHP, C#, Go, and Rust, 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 catalogue, with no per-domain or per-call fees. Activation is instant, so you can start casting hexagrams as soon as you sign up. AI agents connect to our Remote MCP server with no local setup, and an AGENTS.md file plus llms.txt mean coding assistants can wire up the I Ching API for you.
An I Ching reading that interprets every changing line, not just the hexagram it lands on.
All 18+ domains included with every plan. Every endpoint, MCP server, SDK, and templates.
Plans from $39/mo, starting at $1.80 per domain on annual billing. No credit card required for testing.
View Pricing & Get API KeyHi, I am Rosie, your guide to the RoxyAPI insight tools.
Ask me to read your birth chart, pull a card, or map your numbers, and I will 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.