openephemeris-com · Schema

BaZiAnnualPillarRequest

Request for the Liu Nian (流年) annual pillar. Supply year alone for the sexagenary label of that Gregorian year, or add month/day (and optionally hour) to classify a specific moment under the chosen year_boundary.

CompanyAstrologyArtificial IntelligenceAstronomyData

Properties

Name Type Description
day integer Optional day of month. When supplied together with month, the moment is classified under year_boundary and the resolved BaZi year is returned. Must be supplied together with month.
hour integer Optional hour (0–23), only meaningful when month and day are supplied. Defaults to 12 (noon).
month integer Optional month (1–12). When supplied together with day, the moment is classified under year_boundary and the resolved BaZi year is returned. Must be supplied together with day.
year integer Gregorian year for the Liu Nian calculation. When month and day are supplied, the response echoes the resolved BaZi year, which may differ from this value.
year_boundary object Year-pillar boundary convention used when month and day are supplied. Accepted and ignored when they are absent, because the sexagenary label of a whole Gregorian year is boundary-independent — the bo
View JSON Schema on GitHub

JSON Schema

openephemeris-com-ba-zi-annual-pillar-request-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/openephemeris-com/json-schema/openephemeris-com-ba-zi-annual-pillar-request-schema.json",
  "title": "BaZiAnnualPillarRequest",
  "description": "Request for the Liu Nian (流年) annual pillar. Supply year alone for the sexagenary label of that Gregorian year, or add month/day (and optionally hour) to classify a specific moment under the chosen year_boundary.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/openephemeris-com-chinese-api-openapi.yml#/components/schemas/BaZiAnnualPillarRequest",
  "properties": {
    "day": {
      "description": "Optional day of month. When supplied together with month, the moment is classified under year_boundary and the resolved BaZi year is returned. Must be supplied together with month.",
      "maximum": 31,
      "minimum": 1,
      "type": "integer"
    },
    "hour": {
      "default": 12,
      "description": "Optional hour (0–23), only meaningful when month and day are supplied. Defaults to 12 (noon).",
      "maximum": 23,
      "minimum": 0,
      "type": "integer"
    },
    "month": {
      "description": "Optional month (1–12). When supplied together with day, the moment is classified under year_boundary and the resolved BaZi year is returned. Must be supplied together with day.",
      "maximum": 12,
      "minimum": 1,
      "type": "integer"
    },
    "year": {
      "description": "Gregorian year for the Liu Nian calculation. When month and day are supplied, the response echoes the resolved BaZi year, which may differ from this value.",
      "maximum": 9999,
      "minimum": 1,
      "type": "integer"
    },
    "year_boundary": {
      "$ref": "#/$defs/BaZiYearBoundaryEnum",
      "default": "lichun",
      "description": "Year-pillar boundary convention used when month and day are supplied. Accepted and ignored when they are absent, because the sexagenary label of a whole Gregorian year is boundary-independent — the boundary only matters when classifying a moment."
    }
  },
  "required": [
    "year"
  ],
  "type": "object",
  "$defs": {
    "BaZiYearBoundaryEnum": {
      "description": "Year-pillar boundary convention. lichun rolls the year pillar at the Lichun (立春) solar term, around 4 February; cny rolls it at Chinese New Year.",
      "enum": [
        "lichun",
        "cny"
      ],
      "title": "BaZiYearBoundaryEnum",
      "type": "string"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/openephemeris-com-ba-zi-annual-pillar-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.