I Ching API

Ancient I Ching wisdom, modern API delivery. Multiple casting methods, complete hexagram analysis, let AI interpret the oracle.

Supports random casting and the three-coin method, faithfully reproducing the traditional divination experience.

Returns original hexagram, transformed hexagram, changing lines, judgment, image, and line texts — nothing left out.

Built-in complete database of all 64 hexagrams with individual lookup and batch retrieval.

POST /v1/iching/cast

{
  "hexagram": 1,
  "name": "乾 (Qián)",
  "judgment": "元亨利貞",
  "changing_lines": [3, 5]
}

Try the I Ching API Now

Cast for free and let AI interpret millennia of hexagram wisdom.