NEW8 Endpoints | 64 Hexagrams | Changing Lines | AI Readings | FREE Sandbox

I Ching Oracle API

64 Hexagrams | Changing Lines | Trigram Analysis | AI Interpretation

The Book of Changes as a REST API. Cast hexagrams using traditional yarrow stalk or coin toss methods. Get the original texts, changing lines, nuclear hexagrams, and AI-powered natural language readings.

FREE Sandbox
64 Hexagrams + Texts
Plans from $12/mo

The Book of Changes as an API

Traditional wisdom, modern interface

Hexagram Casting

Cast hexagrams using yarrow stalk simulation or three-coin method. Returns primary hexagram, changing lines, and resulting hexagram with full texts.

/v2/divination/iching/cast

64 Hexagram Reference

Complete reference data for all 64 hexagrams. Name, judgment, image text, line texts, trigram composition, and traditional commentary.

/v2/divination/iching/hexagrams

Changing Lines

Analysis of moving lines that transform the primary hexagram into the resulting hexagram. Each changing line returns its specific text and meaning.

/v2/divination/iching/lines

Trigram Analysis

Detailed upper and lower trigram analysis. Eight trigrams with elemental associations, family members, body parts, and directional attributes.

/v2/divination/iching/trigrams

AI Interpretation

Vedika AI interprets hexagram readings in context of your question. Natural language wisdom drawing from the I Ching tradition.

/v2/divination/iching/interpret

Daily Hexagram

Daily hexagram of the day with interpretation. Date-seeded for consistency. Perfect for daily content feeds and app notifications.

/v2/divination/iching/daily

Simple Integration

cURL - Cast Hexagram
curl -X POST https://api.vedika.io/v2/divination/iching/cast \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Should I start this venture?",
    "method": "coin"
  }'
JavaScript
const res = await fetch(
  'https://api.vedika.io/v2/divination/iching/cast',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer your_api_key',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      question: 'Should I start this venture?',
      method: 'yarrow'
    })
  }
);
const { data } = await res.json();
console.log(data.hexagram.name);
console.log(data.changing_lines);
console.log(data.interpretation);

Pricing

All endpoints included in every plan.

Starter

$12/mo
Get Started
POPULAR

Pro

$60/mo
Get Started

Business

$120/mo
Get Started

Enterprise

$240/mo
Contact Sales

Consult the Oracle via API

64 hexagrams. Changing lines. AI wisdom. Plans from $12/month.