🧧 ✨

B2B REST API · Singapore

Chinese metaphysics,
as verified computation.

BaZi four pillars, the Chinese Almanac, Eight Mansions and Xuan Kong Flying Stars — classical systems implemented as tested engines, served over one clean REST API. Built for property, dating, lifestyle and fintech products across Southeast Asia.

Request an API key Read the docs

Live Engine · 玄空飞星 Flying Stars

320° facing

巽山乾向 · 旺山旺向Period 8 · drag the dial — every chart computed by the same engine the API serves

Facing palace Wealth stars 8·9

Four engines, one API.

Every engine is verified against published reference charts before release. No scraped horoscope text — deterministic computation your product can build on.

命

BaZi Four Pillars

Year, month, day and hour pillars from an ISO datetime, with day master and element. /v1/bazi/four-pillars

飞

Flying Stars

Full 24-mountain chart for any facing and period, with 旺山旺向 / 上山下水 pattern detection. /v1/fengshui/flying-stars

宅

Eight Mansions

Kua number, the eight personal directions, and two-person compatibility. /v1/fengshui/bazhai

通

Almanac

Day pillar, day officer (建除十二神) and clash zodiac for any date. /v1/almanac/day

Two minutes to first call.

Authenticate with the X-API-Key header. JSON in, JSON out.

# The chart in the hero, from the live API
curl "https://api.huatday.com/v1/fengshui/flying-stars\
?facing_degrees=320&period=8" \
  -H "X-API-Key: hd_your_key"

# →
{
  "name": "巽山乾向",
  "pattern": "旺山旺向",
  "palaces": { "C": {"mountain":7,"facing":9}, … }
}

# Compatibility for a couple
curl "https://api.huatday.com/v1/fengshui/couple-compatibility\
?year_a=1968&gender_a=male&year_b=1975&gender_b=female" \
  -H "X-API-Key: hd_your_key"

# Today's almanac
curl "https://api.huatday.com/v1/almanac/day?date=2026-06-11" \
  -H "X-API-Key: hd_your_key"

Endpoint	Returns
`GET /v1/fengshui/flying-stars`	9-palace chart, sitting/facing mountains, pattern
`GET /v1/fengshui/bazhai`	Kua, trigram, East/West group, 8 directions
`GET /v1/fengshui/couple-compatibility`	Two profiles + shared auspicious directions
`GET /v1/bazi/four-pillars`	四柱, day master, element, zodiac
`GET /v1/bazi/luoshu`	Luo Shu natal star
`GET /v1/almanac/day`	Day pillar, officer, clash zodiac

Pricing.

Start free, scale when your product does. All tiers hit the same engines.

Explorer

100 calls / month

All endpoints
Community support
For evaluation & prototypes

Start free

MOST HUAT 發

Starter

$19

10,000 calls / month

All endpoints
Email support
Commercial use

Get Starter

Pro

$99

100,000 calls / month

All endpoints
Priority support
Custom engine requests

Get Pro

恭喜發財 · 萬事如意

Get your API key.

Keys are issued personally while HuatDay is in early access — tell us what you're building and we'll reply within one business day.

[email protected]

Chinese metaphysics,as verified computation.