Saju API

Send a birth date and time (plus gender and time zone) and get a Saju (Four Pillars of Destiny) calculation and its reading back as JSON right away. Saju is the Korean system that reads a person's life from four pillars — the year, month, day and hour of birth. The API runs the same Saju engine as the fortune app INTA – Life is Timing, and computes the natal chart from the solar terms (the seasonal markers of the East Asian solar calendar), the favorable element (Yongsin), chart structure (Gyeokguk), Day Master strength, 10-year and annual luck cycles, and Sinsal (symbolic stars) by the rules of classical Saju theory. One key calls every product, and you only pay for the calls you make, deducted from KRW credits.

Get Started guide Try it without a key Pricing

Calculation APIs and interpretation APIs

• Calculation APIs — Manseryeok, Zi Wei Dou Shu, Compatibility, Astrology Total, Fortune Flow, Today's Saju, Dream Interpretation and Tarot. They are computed by rules, without an LLM, so the same input always gives the same result. We recommend fetching once, storing the result in your database and reusing it.
• Interpretation APIs — Lifetime Saju (pre-written reading paragraphs per topic) and AI Saju Reading (the chart is calculated and an AI consults and interprets it to fit the question). AI Saju Reading also includes Zi Wei Dou Shu, astrology, Tarot and Dream Interpretation AIs, which you can call together or one at a time.

Endpoints

The base URL is https://api.hrum.ai/api/v1/partners/v1, and authentication uses the X-Partner-Api-Key header.

Path (reference)	Product (overview)	What it returns
POST /manseryeok	Manseryeok	The four natal pillars, Ten Gods, hidden stems, Twelve Life Stages, Sinsal, Yongsin, Gyeokguk, Day Master strength, 10-year and annual luck cycles, Saju Identity
POST /ziwei-chart	Zi Wei Dou Shu chart	12 palaces, major and minor stars, birth-year transformations, decade and annual periods (birth time required)
POST /compat	Compatibility	Saju and zodiac compatibility for two people, an overall score and reading paragraphs
POST /astrology	Astrology Total	10 planets, houses, aspects and dignities with pre-written reading paragraphs
POST /saju-flow	Fortune Flow	Numbers for charting 10-year, annual and monthly luck, plus a list of combinations, clashes and punishments
POST /today	Today's Saju	How today's day pillar relates to your Day Master, good hours and hours to avoid
POST /dream	Dream Interpretation	Symbol words found in a dream description (no charge when no symbol is found)
POST /tarot	Tarot	Cards drawn from a 78-card deck, upright or reversed, meanings and card image URLs
POST /lifetime	Lifetime Saju	Reading paragraphs on 7 topics: personality, wealth, career, love, health, relationships and advice
POST /reading	AI Saju Reading	AI consultation and interpretation tailored to a question (/reading/memory remembers past sessions)
POST /reading/report	Saju Report	A full interpretation by section in one go, no question needed

Request example

curl -X POST https://api.hrum.ai/api/v1/partners/v1/manseryeok \
  -H "X-Partner-Api-Key: $HRUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":5,"day":15,"hour":12,"minute":0,"timezone":"Asia/Seoul","gender":"male"}'

Responses look like {"success": true, "data": { … }}. Python and JavaScript examples and error handling are in the Get Started guide.

Pricing

Only the calls you make are deducted from prepaid credits. Calculation APIs cost a fixed amount per call; AI Saju Reading charges only for the tokens of the question and the answer, and the chart data fed to the AI is free. Prices shown exclude VAT.

Product	Price
See prices per product in the pricing table

Full pricing · Without a key, you can try the API in the Playground up to 5 times a month per IP. Sign-up credit terms are in the Get Started guide.

FAQ

What if the birth time is unknown?

Manseryeok leaves out only the hour pillar and true solar time, and calculates Yongsin, Gyeokguk, Day Master strength and the rest from the three pillars of year, month and day. The Zi Wei Dou Shu chart needs a birth time.

Can I store the results?

Yes. Calculation APIs and Lifetime Saju return the same result for the same input, so we recommend storing and reusing them. If you don't call again, you aren't charged again.

Where do I host the app I build?

Connect a GitHub repository to RIDM Apps app hosting in the same console and it is built and deployed, with a dedicated PostgreSQL database for each app.

Contact: contact@float.do · Operated by FLOAT Co., Ltd.