POSThttps://api.occultapi.com/api/astro/numerology/chinese/

Chinese numerology

Request bodyJSON

Paste an API key above to send.

Code snippet

curl -X POST https://api.occultapi.com/api/astro/numerology/chinese/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-08-15T10:30:00+05:30","name":"Ajeet Kumar","day":15,"month":8,"year":1990}'

Chinese numerology: the Lo Shu grid and the five elements. `loshu_grid_arrows` reads the arrows of strength and absence across the 3×3 grid of birth-date digits; `five_element_balance` reports Wood, Fire, Earth, Metal and Water as counts and percentages. Lucky and unlucky numbers follow the homophone tradition — 8 for prosperity, 4 avoided. `house_number` and `phone_number` reduce a number you supply. Both default to 0 if you omit them, so the call still succeeds. Returns 9 calculations. Send a name and a date of birth. The system is fixed by the route, so a `system` field in the body is ignored — this endpoint cannot return another system's numbers. The parent /api/astro/numerology/ carries all 34 calculations behind a `system` field, and asking for a key that belongs to a different system returns a 400 that fails the WHOLE request. These routes remove that: each asks only for the keys its own system supports.

Request fields

Field	Type	Required	Notes
date_time	string (date-time)	required	The moment to calculate for, ISO 8601. ALWAYS include an offset or a trailing Z - a value with no zone is read as Asia/Kolkata (UTC+05:30), not UTC, and can return the previous day's result with a 200. '2026-09-01T06:00:00Z' and '2026-09-01 06:00:00' are different instants and give different answers.
name	string	required
day	integer	optional	Day of the month as a number, 1-31.
house_number	string	optional
keys	array	optional	Which calculations to return, as a list of names. See the key table for this endpoint; an unrecognised name rejects the whole request. One call costs one credit however many keys you ask for, so request everything you need at once rather than making several calls.
month	integer	optional	Month of birth as a number, 1-12. January is 1.
phone_number	string	optional
system	string	optional
year	integer	optional	Year of birth as a number, e.g. 1990. Four digits.

Full reference for this endpoint