Qimena Qi Men Dun Jia & BaZi

Cast an hour-based Qi Men Dun Jia (奇门遁甲) chart for a moment and place: four pillars, ju, Chief Star and Door, and for each of the nine palaces the deity, star, door, heaven/earth/hidden stems, void, horse star, punishment and door pressure, plus detected patterns, palace scores for the chosen focus and the lucky directions.

{
  "type": "object",
  "properties": {
    "datetime": {
      "type": "string",
      "description": "Local wall-clock time \"YYYY-MM-DDTHH:mm\" in `timezone`. Omit for now."
    },
    "timezone": {
      "type": "string",
      "description": "IANA time zone, e.g. \"Asia/Shanghai\", \"America/New_York\". Default Asia/Shanghai."
    },
    "longitude": {
      "type": "number",
      "description": "Longitude of the place in degrees, east positive, west negative. Default: the standard meridian of the time zone."
    },
    "focus": {
      "type": "string",
      "enum": [
        "general",
        "career",
        "wealth",
        "love"
      ],
      "description": "What the question is about; changes palace scores and lucky directions. Default general."
    }
  }
}

Four Pillars (八字) for a birth moment: converts the clock time with the zone rules for that date (daylight saving included) and the longitude to true solar time; the year follows Li Chun and the day changes at 23:00 true solar time. Returns the pillars, Day Master, five-element counts and the time conversion details.

{
  "type": "object",
  "properties": {
    "birth_datetime": {
      "type": "string",
      "description": "Birth wall-clock time \"YYYY-MM-DDTHH:mm\", as on the birth certificate."
    },
    "timezone": {
      "type": "string",
      "description": "IANA time zone of the birthplace, e.g. \"Asia/Shanghai\"."
    },
    "longitude": {
      "type": "number",
      "description": "Birthplace longitude, east positive. Default: the standard meridian of the time zone."
    }
  },
  "required": [
    "birth_datetime",
    "timezone"
  ]
}

Cast a Qi Men chart for every double-hour of the next few days and rank them for a goal, using the person's Day Master from the birth date. Returns the top windows with date, hour branch, true-solar-time range, score and the lucky direction at that time.

{
  "type": "object",
  "properties": {
    "birth_date": {
      "type": "string",
      "description": "Birth date \"YYYY-MM-DD\" (sets the Day Master)."
    },
    "focus": {
      "type": "string",
      "enum": [
        "general",
        "career",
        "wealth",
        "love"
      ],
      "description": "Goal to rank for. Default general."
    },
    "longitude": {
      "type": "number",
      "description": "Longitude of where the person is now, east positive. Default 120 (Beijing meridian)."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7,
      "description": "How many days ahead to scan, 1-7. Default 7."
    },
    "top": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many windows to return, 1-10. Default 5."
    }
  },
  "required": [
    "birth_date"
  ]
}

The 24 solar terms (节气) of a calendar year, 1900-2100, with UTC and Beijing-time instants from the same table the charts use (within about a minute of the Hong Kong Observatory).

{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "minimum": 1900,
      "maximum": 2100,
      "description": "Calendar year."
    }
  },
  "required": [
    "year"
  ]
}