AsterNym

Sun sign, Chinese animal and element, BaZi day master and pillars, Life Path and the AsterNym identity, from the same engine as every page on the site. The same thing over HTTP: POST https://asternym.com/api/v1/reading.

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Local civil date, YYYY-MM-DD. Required."
    },
    "time": {
      "type": "string",
      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
      "description": "Local clock time, HH:MM. Omit if unknown; nothing is assumed and noon is never substituted."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Decimal degrees."
    },
    "lng": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Decimal degrees."
    },
    "tz": {
      "type": "string",
      "description": "IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given."
    },
    "agent": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified."
    }
  },
  "required": [
    "date"
  ]
}

Pillars, day master, hidden stems (藏干) with their ten gods (十神), element counts, dominant and missing elements, na yin, the twelve stages and the void branches. The year turns at Li Chun, not at 1 January or Lunar New Year. Without a time there is no hour pillar and the response says so. The same thing over HTTP: POST https://asternym.com/api/v1/bazi.

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Local civil date, YYYY-MM-DD. Required."
    },
    "time": {
      "type": "string",
      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
      "description": "Local clock time, HH:MM. Omit if unknown; nothing is assumed and noon is never substituted."
    },
    "tz": {
      "type": "string",
      "description": "IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given."
    },
    "sexCategory": {
      "type": "string",
      "enum": [
        "F",
        "M",
        "both"
      ],
      "description": "Echoed back. Only the luck-pillar cycle reads it, and this endpoint does not return luck pillars."
    },
    "agent": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified."
    }
  },
  "required": [
    "date"
  ]
}

The twelve 時辰 of a day, each with its hour pillar, hidden stems, ten god and the element counts of the whole chart at that hour. The 23:00-00:00 slot is returned separately as lateZi: from 23:00 the hour pillar has already turned to the next day's 子 (早子時) while the day pillar has not, so it differs from the 00:00-01:00 slot on the same date. These are the Chinese double-hours, not the Western planetary hours. The same thing over HTTP: POST https://asternym.com/api/v1/bazi/hours.

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Local civil date, YYYY-MM-DD. Required."
    },
    "tz": {
      "type": "string",
      "description": "IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given."
    },
    "element": {
      "type": "string",
      "enum": [
        "Wood",
        "Fire",
        "Earth",
        "Metal",
        "Water"
      ],
      "description": "Optional: rank the hours by how much of this element the chart carries."
    },
    "agent": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified."
    }
  },
  "required": [
    "date"
  ]
}

Pythagorean numerology: Life Path, birthday number and its components, and with a name the expression, soul urge, personality, cornerstone, capstone and hidden passion. Master numbers are kept where the position allows. The same thing over HTTP: POST https://asternym.com/api/v1/numerology.

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Local civil date, YYYY-MM-DD. Required."
    },
    "name": {
      "type": "string",
      "maxLength": 120,
      "description": "Optional given name. Without it the name numbers are omitted rather than guessed. Used and discarded; never stored."
    },
    "surname": {
      "type": "string",
      "maxLength": 120,
      "description": "Optional surname, used with the given name where the method uses the full name."
    },
    "agent": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified."
    }
  },
  "required": [
    "date"
  ]
}

The Sun's sign from its apparent ecliptic longitude, with a cusp reported rather than resolved by assuming noon, and the Chinese animal, element and polarity with the Lunar New Year boundary. Note the two calendars differ on purpose: the Chinese year here turns at Lunar New Year, while the BaZi year pillar turns at Li Chun. The same thing over HTTP: POST https://asternym.com/api/v1/zodiac.

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Local civil date, YYYY-MM-DD. Required."
    },
    "time": {
      "type": "string",
      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
      "description": "Local clock time, HH:MM. Omit if unknown; nothing is assumed and noon is never substituted."
    },
    "tz": {
      "type": "string",
      "description": "IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Decimal degrees."
    },
    "lng": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Decimal degrees."
    },
    "agent": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified."
    }
  },
  "required": [
    "date"
  ]
}

Ten planets with sign, degree, whole-sign house and retrograde flag; the Ascendant, midheaven and their opposites; the twelve whole-sign houses; the mean lunar nodes; the five major aspects with orb and whether each is applying or separating; plus stelliums, retrogrades and the Moon's phase. Tropical zodiac, geocentric apparent positions, astronomy-engine. This is the one endpoint that requires lat, lng and tz: the angles and houses are a place on the Earth meeting the sky. A time is optional, and without one the angles and houses are null rather than taken from noon, and the Moon is a noon estimate the notes warn about. The same thing over HTTP: POST https://asternym.com/api/v1/natal.

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Local civil date, YYYY-MM-DD. Required."
    },
    "time": {
      "type": "string",
      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
      "description": "Local clock time, HH:MM. Omit if unknown; nothing is assumed and noon is never substituted."
    },
    "tz": {
      "type": "string",
      "description": "IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Decimal degrees."
    },
    "lng": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Decimal degrees."
    },
    "agent": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified."
    }
  },
  "required": [
    "date",
    "lat",
    "lng",
    "tz"
  ]
}