---
title: "Throw Coins"
method: POST
path: "/iching/throw-coins"
tags: ["I Ching (Standalone)"]
---

# Throw Coins

`POST /iching/throw-coins`

Seeded 3-coin method.

## Request body

- Throw
  - `seed` union
    - number
    - string

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `method` string, nullable
    - `seed` number, nullable
    - `hexagram` object, nullable
      - `number` number, nullable
      - `name` string, nullable
      - `chinese` string, nullable
      - `trigrams` number[], nullable
      - `lines` object[], nullable
        - `value` number, nullable
        - `isYang` boolean, nullable
        - `isChanging` boolean, nullable
      - `changingHexagram` number, nullable
    - `source` string, nullable

## Other responses

- `400` — Validation error
- `401` — Missing or invalid API key

## Changes

- **2026-08-24** `8ab5a768b521` — 9 info
  - added the optional property `data/hexagram/changingHexagram` to the response with the `200` status
  - added the optional property `data/hexagram/chinese` to the response with the `200` status
  - added the optional property `data/hexagram/lines` to the response with the `200` status
  - added the optional property `data/hexagram/name` to the response with the `200` status
  - …5 more

[Change history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/iching/throw-coins/post.md)

---

[API](https://skmtc.dev/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.dev/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/astroway/astroway-calculation-api/revisions/8ab5a768b521/schema)