yarrow

Cast a hexagram for an I-Ching consultation. Returns the primary hexagram, the six lines (6=old yin, 7=young yang, 8=young yin, 9=old yang from bottom to top), any moving lines, and the changing hexagram if there are moving lines. Pass `seed` to make the cast deterministic (useful for testing or for reproducing a reading).

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "The question being asked (not used for casting, returned in result for context)."
    },
    "method": {
      "type": "string",
      "enum": [
        "coins",
        "yarrow",
        "random"
      ],
      "default": "coins",
      "description": "coins = three-coin toss (most common); yarrow = traditional 50-stalk probabilities; random = uniformly pick one of the 64 hexagrams with no moving lines."
    },
    "seed": {
      "type": [
        "string",
        "number"
      ],
      "description": "Optional seed for deterministic casting."
    }
  },
  "required": []
}

Return the full classical sources for a hexagram by its number (1–64): judgment (卦辞), image (大象), Tuan commentary, Zhu Xi 周易本义, Yang Tian Cai modern explanation, Yarrow's separately labelled Chinese reading aid, and historical anecdote — with available Chinese and English source material.

{
  "type": "object",
  "properties": {
    "number": {
      "type": "integer",
      "minimum": 1,
      "maximum": 64,
      "description": "Hexagram number 1-64 in King Wen sequence."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "zh",
        "both"
      ],
      "default": "both"
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "If true, omit authorities (long classical commentary). Returns only structural fields."
    }
  },
  "required": [
    "number"
  ]
}

Look up the 焦氏易林 verse for a primary hexagram changing into another hexagram. This is a local classical-source lookup, not an AI reading.

{
  "type": "object",
  "properties": {
    "primary_number": {
      "type": "integer",
      "minimum": 1,
      "maximum": 64,
      "description": "Primary hexagram number 1-64."
    },
    "changing_number": {
      "type": "integer",
      "minimum": 1,
      "maximum": 64,
      "description": "Changing hexagram number 1-64."
    }
  },
  "required": [
    "primary_number",
    "changing_number"
  ]
}

Draw one upright Major Arcana card for reflection. Uses a deterministic one-card Waite-Smith Major Arcana method and returns a selected source excerpt from Arthur Edward Waite's public-domain 1910/1922 text. Pass `seed` to reproduce the same draw.

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "The question being reflected on (not used to influence the draw)."
    },
    "seed": {
      "type": [
        "string",
        "number"
      ],
      "description": "Optional deterministic draw seed."
    }
  },
  "required": []
}

Ask the I Ching. See your next step. Cast a hexagram, show the classical sources first, then offer a thoughtful reflection grounded in those sources. Sources first. Reflection, not prediction. The divine name remains stable for oracle/divination client compatibility. Supports English, Chinese, Japanese, Korean, Spanish, French, German, Portuguese, Italian, Russian, Arabic, Hindi, Indonesian, and English+Chinese bilingual output. Daily quota: 30 completed readings per device_id (or per anonymous IP if no device_id is supplied); timeout, provider failure, incomplete response, and cancellation do not consume it.

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "The question to consult on."
    },
    "method": {
      "type": "string",
      "enum": [
        "coins",
        "yarrow",
        "random"
      ],
      "default": "coins"
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "zh",
        "zh-Hant",
        "ja",
        "ko",
        "es",
        "fr",
        "de",
        "pt",
        "it",
        "ru",
        "ar",
        "hi",
        "id",
        "bilingual"
      ],
      "default": "en"
    },
    "device_id": {
      "type": "string",
      "description": "Optional opaque identifier for quota tracking. If omitted, IP-derived."
    },
    "seed": {
      "type": [
        "string",
        "number"
      ],
      "description": "Deterministic cast seed."
    }
  },
  "required": [
    "question"
  ]
}

Ask one real question through a single upright Waite-Smith Major Arcana card. Returns a direct calibrated answer first, the named card and bound Arthur Edward Waite 1910 source excerpt, a practical reality check, and one observable next step. No reversals, astrology, redraw loop, or guaranteed prediction. Daily quota is shared with completed divine and Two Lenses readings.

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "The real question to reflect on."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "zh",
        "zh-Hant",
        "ja",
        "ko",
        "es",
        "fr",
        "de",
        "pt",
        "it",
        "ru",
        "ar",
        "hi",
        "id",
        "bilingual"
      ],
      "default": "en"
    },
    "device_id": {
      "type": "string",
      "description": "Optional opaque identifier for quota tracking. If omitted, IP-derived."
    },
    "seed": {
      "type": [
        "string",
        "number"
      ],
      "description": "Deterministic Tarot draw seed."
    }
  },
  "required": [
    "question"
  ]
}

Bring one real question to two independent symbolic traditions: a source-first I-Ching cast and one upright Waite-Smith Major Arcana card. Returns a clear calibrated answer first, then five grounded sections covering the I Ching lens, Tarot lens, shared themes, different emphasis, and next step. Direction without guaranteed prediction or mutual-confirmation claims. Daily quota is shared with completed divine readings.

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "The same real question for both lenses."
    },
    "method": {
      "type": "string",
      "enum": [
        "coins",
        "yarrow",
        "random"
      ],
      "default": "coins"
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "zh",
        "zh-Hant",
        "ja",
        "ko",
        "es",
        "fr",
        "de",
        "pt",
        "it",
        "ru",
        "ar",
        "hi",
        "id",
        "bilingual"
      ],
      "default": "en"
    },
    "device_id": {
      "type": "string",
      "description": "Optional opaque identifier for quota tracking. If omitted, IP-derived."
    },
    "iching_seed": {
      "type": [
        "string",
        "number"
      ],
      "description": "Deterministic I-Ching cast seed."
    },
    "tarot_seed": {
      "type": [
        "string",
        "number"
      ],
      "description": "Deterministic Tarot draw seed."
    }
  },
  "required": [
    "question"
  ]
}