Skip to main content
POST
Qi Men Dun Jia chart

Authorizations

Authorization
string
header
required

Use the raw API key as the Bearer token, or send X-API-Key instead.

Body

application/json

Optional white-label AI voice controls for endpoints that generate LLM interpretation text.

date
string<date>
required
Example:

"1992-04-15"

time
string
required
Pattern: ^\d{2}:\d{2}(:\d{2})?$
Example:

"08:30:00"

latitude
number
required
Required range: -90 <= x <= 90
longitude
number
required
Required range: -180 <= x <= 180
timezoneOffsetMinutes
integer
required
Required range: -840 <= x <= 840
ayanamsa
enum<string>
default:lahiri
Available options:
lahiri
brand_name
string
Required string length: 1 - 60
Example:

"Moon & Co"

tone
enum<string>
Available options:
professional,
casual,
mystical,
playful,
formal
audience
enum<string>
Available options:
consumer,
employee,
manager,
customer,
community
safety_mode
enum<string>
Available options:
default,
workplace,
financial_wellness,
entertainment
type
enum<string>
default:hour
Available options:
hour,
day,
month,
year
gender
enum<string>
default:unknown
Available options:
male,
female,
unknown
interpret
boolean
default:false
language
enum<string>
default:zh
Available options:
zh,
zh-cn,
en,
th

Response

Qi Men Dun Jia chart (+ optional interpretation).

type
enum<string>
required
Available options:
hour,
day,
month,
year
dun_type
enum<string>
required
Available options:
yang,
yin
ju
integer
required
Required range: 1 <= x <= 9
ju_label
string
required

Chinese ju label, e.g. 阳遁三局.

season
string
required

Governing solar term (Chinese).

season_en
string
required

Governing solar term (romanized).

year_pillar
string
required
month_pillar
string
required
day_pillar
string
required
hour_pillar
string
required
xun_shou
string
required
zhi_fu_star
string
required
zhi_shi_door
string
required
palace5_lodge
integer
required

Palace where the center-palace star lodges.

palaces
object[]
required
ge_ju
string[]
required

Detected auspicious/inauspicious patterns (Chinese).

ge_ju_en
string[]
required
interpretation
string | null
required

LLM interpretation when interpret=true; otherwise null.