Skip to content
96Astro API

Chinese astrology

Available

I-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
Request
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

Runs the real calculation, free and without a key, a few times a minute. For more, and for AI readings, get a free sandbox key.

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.

  • seedstring
  • seed_generatedboolean
  • methodstring
  • questionstring
  • linesarray of object
  • changing_linesarray of number
  • hexagramobject
  • resulting_hexagramobject
  • readingstring
  • notestring
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.

FAQ

I-Ching Cast API: common questions

4answers

Ask the team
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.

Send us feedback

What is it about?