POST /api/developer/v1/calculate-chart

Returns a Zi Wei Dou Shu chart. This is a free endpoint and mirrors the core calculate_chart MCP tool input shape.

Request Body

Field	Type	Required	Description
birthDate	string	Yes	Birth date in YYYY-MM-DD or DD/MM/YYYY format.
birthTime	string	Yes	Birth time in HH:mm 24-hour format.
gender	enum	Yes	Biological gender: "male" or "female".
timezone	string	Yes	IANA timezone such as Asia/Singapore or America/New_York.
language	enum	No	Response language: "en" or "zh". Defaults to "en".

{
  "birthDate": "1995-10-15",
  "birthTime": "08:30",
  "gender": "female",
  "timezone": "Asia/Singapore",
  "language": "en"
}

Response Body

{
  "accessTier": "basic",
  "chart": {
    "palaces": [
      {
        "id": 0,
        "name": { "en": "soul", "zh": "命宮" },
        "stars": [
          {
            "name": { "english": "emperor", "chinese": "紫微" },
            "type": "major",
            "brightness": "廟",
            "mutagen": null
          }
        ],
        "description": "The soul palace represents your core personality, potential, and innate characteristics.",
        "oppositePalace": {
          "name": { "en": "surface", "zh": "遷移" },
          "stars": []
        },
        "ageRange": [2, 11]
      }
    ],
    "sign": {
      "zh": "天秤座",
      "en": "libra"
    }
  }
}

Developer responses intentionally omit several chart-level summary fields plus palace-level branch and stem metadata to keep the payload compact.

Errors

• 400 for invalid request data with validation issues in details.issues
• 401 for missing or invalid Bearer authentication
• 429 when the API key exceeds 10 calls per second