Chinese astrology
AvailableI-Ching Cast API
An I-Ching cast by the three-coin method: six lines (6, 7, 8 or 9), the changing lines, the hexagram, the resulting hexagram and our own summary of each. Pass a seed to replay a cast; without one a fresh seed is returned.
- POST /v1/chinese/i-ching-cast
- 1 credit
curl https://api.96astroapi.com/v1/chinese/i-ching-cast \ -H "Authorization: Bearer $ASTRO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "seed": "my question, 20 November 2026", "question": "How should I approach the move?" }'
Overview
An I-Ching cast by the three-coin method: six lines (6, 7, 8 or 9), the changing lines, the hexagram, the resulting hexagram and our own summary of each. Pass a seed to replay a cast; without one a fresh seed is returned.
Call it with POST /v1/chinese/i-ching-cast. Input: specific input. Output: JSON, as a direct response. Each successful call costs 1 credit.
- POST /v1/chinese/i-ching-cast
- 1 credit
- Specific input
Try it
Response
Ready when you are
Press Run it to see the live response here.
Example response
Fields in dataInferred from the example response: a guide to the shape, not a contract.
seedstringseed_generatedbooleanmethodstringquestionstringlinesarray of objectchanging_linesarray of numberhexagramobjectresulting_hexagramobjectreadingstringnotestring
200Example response
Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items and image data is shortened.
Loading the example…
Request schema and every field: the Chinese astrology reference.
Related endpoints
01What does the I-Ching Cast API return?
An I-Ching cast by the three-coin method: six lines (6, 7, 8 or 9), the changing lines, the hexagram, the resulting hexagram and our own summary of each. Pass a seed to replay a cast; without one a fresh seed is returned. The response's data object includes seed, seed_generated, method, question, lines, changing_lines, hexagram and resulting_hexagram. See the reference for an example response.
02What input does I-Ching Cast need?
Specific input.
03How much does a I-Ching Cast call cost?
1 credit per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.
04Can I try it before paying?
Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.


