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.
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 |
JSON Schema
{
"$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.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-schemas/openephemeris-com-ba-zi-annual-pillar-request"
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.