POST/api/astro/numerology/chinese/1 credit

Chinese numerology

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.

https://yogataraapi.prahlad.app/api/astro/numerology/chinese/

Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

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.

Example request

curl -X POST https://yogataraapi.prahlad.app/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}'

Response

{
  "data": {
    "chinese_name_number": 5,
    "five_element_balance": {
      "balance": {
        "Wood": {
          "count": 0,
          "percentage": 0,
          "meaning": "Growth, creativity, flexibility",
          "associated_numbers": [
            3,
            4
          ]
        },
        "Fire": {
          "count": 2,
          "percentage": 25,
          "meaning": "Passion, energy, transformation",
          "associated_numbers": [
            9
          ]
        },
        "Earth": {
          "count": 3,
          "percentage": 37.5,
          "meaning": "Stability, nourishment, groundedness",
          "associated_numbers": [
            2,
            5,
            8
          ]
        },
        "Metal": {
          "count": 1,
          "percentage": 12.5,
          "meaning": "Strength, determination, clarity",
          "associated_numbers": [
            6,
            7
          ]
        },
        "Water": {
          "count": 2,
          "percentage": 25,
          "meaning": "Wisdom, flow, adaptability",
          "associated_numbers": [
            1
          ]
        }
      },
      "interpretation": "The Five Elements show the distribution of energy in your chart. Wood represents growth, Fire is passion, Earth is stability, Metal represents strength, and Water represents wisdom."
    },
    "house_number": 0,
    "loshu_grid_arrows": {
      "arrow_of_determination": {
        "present": true,
        "meaning": "Indicates strong willpower and determination."
      },
      "arrow_of_emotional_balance": {
        "present": false,
        "meaning": "Indicates emotional stability and balance."
      },
      "arrow_of_practicality": {
        "present": false,
        "meaning": "Indicates a practical and grounded approach to life."
      },
      "arrow_of_intellect": {
        "present": false,
        "meaning": "Indicates strong intellectual capabilities and memory."
      }
    },
    "lucky_numbers": [
      2,
      3,
      6,
      7,
      8,
      9
    ],
    "personal_life_path_number": 6,
    "phone_number": 0,
    "unlucky_numbers": [
      1,
      4,
      5,
      6
    ],
    "vedic_personal_day": 2
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Captured from a real call using the exact request above. Results sit under data.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.