{"ok":true,"service":"yitarot","version":1,"description":"Deterministic divination. The same (system, question, seed, moment, opts) always returns the same chart. No auth, no state on the server.","systems":[{"id":"iching","description":"I Ching, 64 hexagrams, coins or yarrow stalks.","endpoint":"/api/iching","example":"/api/iching?question=Should+I+take+this+new+project%3F&seed=42&format=json","params":{"values":[{"name":"coins","description":"Six line values, bottom first (6,7,8,9). Omit to toss with the seed."}],"switches":[{"name":"yarrow","description":"Use the 大衍筮法 yarrow distribution instead of coins. Pass 1; mutually exclusive with coins."}]}},{"id":"tarot","description":"78-card tarot with five spreads.","endpoint":"/api/tarot","example":"/api/tarot?question=Should+I+take+this+new+project%3F&seed=42&format=json","params":{"values":[{"name":"spread","description":"Spread id; the accepted values depend on the system."}],"switches":[]}},{"id":"liuyao","description":"Six-line (Liu Yao) with eight palaces, host/guest lines and six kin.","endpoint":"/api/liuyao","example":"/api/liuyao?question=Should+I+take+this+new+project%3F&seed=42&format=json","params":{"values":[{"name":"coins","description":"Six line values, bottom first (6,7,8,9). Omit to toss with the seed."},{"name":"day-stem","description":"Day stem 甲..癸, used for the six-kin markers in liuyao."}],"switches":[{"name":"yarrow","description":"Use the 大衍筮法 yarrow distribution instead of coins. Pass 1; mutually exclusive with coins."}]}},{"id":"meihua","description":"Plum Blossom numerology from two numbers.","endpoint":"/api/meihua","example":"/api/meihua?question=Should+I+take+this+new+project%3F&seed=42&format=json&numbers=12%2C7","params":{"values":[{"name":"numbers","description":"Two numbers: upper,lower trigram seeds (e.g. 12,7)."}],"switches":[]}},{"id":"geomancy","description":"Sixteen-figure geomancy shield chart.","endpoint":"/api/geomancy","example":"/api/geomancy?question=Should+I+take+this+new+project%3F&seed=42&format=json&mothers=0%2C1%2C2%2C3","params":{"values":[{"name":"mothers","description":"Four figures 0..15, comma separated."}],"switches":[]}},{"id":"lenormand","description":"36 Lenormand cards, three to grand tableau.","endpoint":"/api/lenormand","example":"/api/lenormand?question=Should+I+take+this+new+project%3F&seed=42&format=json","params":{"values":[{"name":"spread","description":"Spread id; the accepted values depend on the system."}],"switches":[]}},{"id":"virgil","description":"Sortes Virgilianae: a line of the Aeneid.","endpoint":"/api/virgil","example":"/api/virgil?question=Should+I+take+this+new+project%3F&seed=42&format=json","params":{"values":[],"switches":[{"name":"with-english","description":"Add an English translation for the drawn line or verse."}]}},{"id":"bible","description":"Sortes Biblicae: a verse of the Chinese Union Version.","endpoint":"/api/bible","example":"/api/bible?question=Should+I+take+this+new+project%3F&seed=42&format=json","params":{"values":[],"switches":[{"name":"with-english","description":"Add an English translation for the drawn line or verse."}]}},{"id":"bazi","description":"Four Pillars (Ba Zi) from a birth moment.","endpoint":"/api/bazi","example":"/api/bazi?question=Should+I+take+this+new+project%3F&seed=42&format=json&date=2004-11-19+09%3A58&tz=480","params":{"values":[{"name":"date","description":"Local date and time, YYYY-MM-DD HH:MM."},{"name":"tz","description":"Timezone offset in minutes; UTC+8 is 480."},{"name":"day-boundary","description":"zi (day starts at 23:00) or midnight."},{"name":"longitude","description":"Birth longitude in degrees; east is positive."},{"name":"gender","description":"男 or 女."}],"switches":[{"name":"true-solar","description":"Correct the hour pillar with longitude and the equation of time."}]}},{"id":"ziwei","description":"Zi Wei Dou Shu from a lunar birthday.","endpoint":"/api/ziwei","example":"/api/ziwei?question=Should+I+take+this+new+project%3F&seed=42&format=json&lunar=1990-6-15","params":{"values":[{"name":"lunar","description":"Lunar birthday, YYYY-M-D; prefix the month with R for a leap month."},{"name":"hour-branch","description":"Hour branch 子..亥."},{"name":"gender","description":"男 or 女."}],"switches":[]}},{"id":"qimen","description":"Qi Men Dun Jia chart for a moment.","endpoint":"/api/qimen","example":"/api/qimen?question=Should+I+take+this+new+project%3F&seed=42&format=json&date=2004-11-19+09%3A58&tz=480","params":{"values":[{"name":"date","description":"Local date and time, YYYY-MM-DD HH:MM."},{"name":"tz","description":"Timezone offset in minutes; UTC+8 is 480."},{"name":"method","description":"Qi Men setup; only chaibu is implemented."}],"switches":[]}},{"id":"daliuren","description":"Da Liu Ren: four lessons, three transmissions.","endpoint":"/api/daliuren","example":"/api/daliuren?question=Should+I+take+this+new+project%3F&seed=42&format=json&date=2004-11-19+09%3A58&tz=480","params":{"values":[{"name":"date","description":"Local date and time, YYYY-MM-DD HH:MM."},{"name":"tz","description":"Timezone offset in minutes; UTC+8 is 480."}],"switches":[]}},{"id":"horary","description":"Horary astrology from the chart of the moment asked.","endpoint":"/api/horary","example":"/api/horary?question=Should+I+take+this+new+project%3F&seed=42&format=json&date=2004-11-19+09%3A58&tz=480&lat=25.03&lon=121.56&kind=career","params":{"values":[{"name":"date","description":"Local date and time, YYYY-MM-DD HH:MM."},{"name":"tz","description":"Timezone offset in minutes; UTC+8 is 480."},{"name":"lat","description":"Latitude in degrees; north is positive."},{"name":"lon","description":"Longitude in degrees; east is positive."},{"name":"kind","description":"Question type: other, relationship, money, career, health, travel, legal, missing."},{"name":"houses","description":"House system; only placidus is implemented."}],"switches":[]}},{"id":"runes","description":"Elder Futhark runes, five spreads.","endpoint":"/api/runes","example":"/api/runes?question=Should+I+take+this+new+project%3F&seed=42&format=json","params":{"values":[{"name":"spread","description":"Spread id; the accepted values depend on the system."}],"switches":[{"name":"reversals","description":"Allow reversed runes."}]}},{"id":"omikuji","description":"Japanese omikuji paper fortune.","endpoint":"/api/omikuji","example":"/api/omikuji?question=Should+I+take+this+new+project%3F&seed=42&format=json","params":{"values":[],"switches":[]}},{"id":"yilin","description":"Jiao's Yi Lin, 4096 four-character verses.","endpoint":"/api/yilin","example":"/api/yilin?question=Should+I+take+this+new+project%3F&seed=42&format=json","params":{"values":[{"name":"coins","description":"Six line values, bottom first (6,7,8,9). Omit to toss with the seed."}],"switches":[{"name":"yarrow","description":"Use the 大衍筮法 yarrow distribution instead of coins. Pass 1; mutually exclusive with coins."}]}}],"common":{"question":{"type":"string","maxLength":500,"description":"The question, verbatim. Omit for systems that ignore it."},"seed":{"type":"string","maxLength":40,"description":"Integer seed. Omit to use the current millisecond; the same seed reproduces the cast."},"format":{"type":"string","enum":["json","md","prompt"],"default":"json","description":"json for programs, md for people, prompt for a model with the interpretation contract."}},"envelope":{"ok":"boolean","reading":"system-specific object; always carries reading.interpretation_contract with role / must_use / must_not / limits","state":"replay inputs; pass this back unchanged to follow up instead of re-drawing","error":"present only when ok is false"},"openapi":"/api/openapi.json","notes":["Readings are Chinese by design; use format=prompt when handing them to a model.","Rate limit: 60 requests per minute per IP."]}