The Vedika I Ching API casts hexagrams and returns the reading as structured JSON: a cast hexagram, its changing lines, hexagram lookup by number, the trigrams, daily guidance, a reading for a specific question, a compatibility reading and an AI interpretation.
It is part of the Vedika astrology API, so one key and wallet also cover tarot, charts and other divination systems. The cast route accepts an optional seed, so the same seed repeats the same cast.
| Endpoint | Returns |
|---|---|
POST /v2/iching/cast | Cast I Ching Hexagram |
POST /v2/iching/changing-lines | I Ching Changing Lines |
GET /v2/iching/hexagram/{number} | Hexagram by Number |
GET /v2/iching/trigrams | Get Trigrams |
GET /v2/iching/daily | Daily I Ching Guidance |
POST /v2/iching/question | I Ching Question Reading |
POST /v2/iching/interpretation | AI I Ching Interpretation |
POST /v2/iching/compatibility | I Ching Compatibility |
The question and interpretation routes take a question; the cast routes take an optional seed. The API reference lists the exact parameters.
Send an optional seed for a repeatable cast. Auth is a Bearer API key. The keyless sandbox mirrors the production routes.
curl -X POST https://api.vedika.io/v2/iching/cast \
-H "Authorization: Bearer vk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"seed":"demo-seed"}'See the quickstart and the API reference.
Self-serve plans are Starter $12/month, Professional $60/month, Business $120/month and Enterprise $240/month. Flagship is custom-priced by contract. AI answers are priced per query and vary with the request; each response reports the amount charged. There is no free production tier, and the sandbox is a mock. Accounts that have never paid can start one 14-day Professional trial. Terms are on the pricing page.
Use it for I Ching reading apps, daily-guidance features and journaling tools. For tarot see the Tarot API; for other oracle systems the Oracles and Divination API; for embeddable daily feeds the Daily Content API.
It casts hexagrams and returns the primary hexagram, changing lines, hexagram and trigram lookups, daily guidance, a reading for a specific question, a compatibility reading and an AI interpretation, all as structured JSON.
POST /v2/iching/cast casts a hexagram and POST /v2/iching/changing-lines covers its changing lines. GET /v2/iching/hexagram/{number} looks up any of the 64 hexagrams. An optional seed makes a cast repeatable.
Yes. GET /v2/iching/daily returns daily guidance, and the Daily Content API carries a daily I Ching feed at GET /v2/daily/iching.
Yes. A keyless mock sandbox at vedika.io/sandbox mirrors production routes, so you can call it with no API key. There is no free production tier. Accounts that have never paid can start one 14-day Professional trial: you authorise the Professional auto-debit and receive $5 of credit that ends with the trial. Nothing is charged for the plan on day 0, and Professional ($60/month, plus GST in India) is charged on day 14 unless you cancel at least 48 hours before the trial ends.
Self-serve plans are Starter $12/month, Professional $60/month, Business $120/month and Enterprise $240/month; Flagship is custom-priced by contract. AI answers are priced per query and vary with the request, and every response reports the exact amount charged. Current limits are on vedika.io/pricing.
Astrology API · Tarot API · Oracles and Divination API · Daily Content API · Documentation · API reference · Pricing · Playground