# China Lunar Calendar Lookup

> China Lunar Calendar Lookup is a paid API for AI agents from cn-holiday-x402.linholiday.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Returns Chinese lunar calendar data for a given Gregorian date, including lunar date, Ganzhi cycle, zodiac, festivals, and solar terms.

## Facts

- Endpoint: GET https://cn-holiday-x402.linholiday.workers.dev/lunar?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/china-lunar-calendar-lookup-332fb24c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vbBzCLnfCS-r5nSi-BNqs

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability china-lunar-calendar-lookup-332fb24c
```

Example prompt: What is the Chinese lunar calendar date for February 17, 2026? I need the lunar day, month, year, the Ganzhi cycle info, zodiac animal, any festivals, and whether it falls on a solar term.

## When to prefer this

Use this endpoint when you need accurate Chinese lunar calendar data — including lunar dates, Ganzhi cycle, zodiac, Chinese festivals, and solar terms — for a specific Gregorian date. It is purpose-built for the Chinese calendar domain and handles edge cases like leap lunar months and the Chinese New Year zodiac/year transition. Prefer this over generic calendar libraries when you need authoritative, structured Chinese calendar data accessible via a simple HTTP GET with per-call micropayment pricing.

## Known failure modes

- Missing or malformed 'date' query parameter returns an error
- Date out of supported range may return an error or no data
- Invalid date format (not YYYY-MM-DD) results in a validation error
- Payment not provided or insufficient USDC results in HTTP 402
- Network errors on Cloudflare Workers edge may cause transient 5xx responses

## How this service works

Each paid call costs 0.01 USDC on eip155:8453 via x402 (exact scheme). Free: /health, /, /openapi.json, /llms.txt, /.well-known/x402.

## Output

A JSON object containing: the queried Gregorian date, the lunar date (year, month, day, leap-month flag, and full Chinese text like 二〇二六年正月初一), the Ganzhi cycle (year, month, day in Chinese characters), the zodiac animal (in English and Chinese), an array of Chinese festivals occurring on that date, the solar term if applicable, and an explanatory note about year/zodiac transitions at Chinese New Year.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "date"
     ],
     "properties": {
      "date": {
       "type": "string",
       "description": "YYYY-MM-DD (Gregorian)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-02-17",
  "note": "Lunar year/zodiac switch at Chinese New Year (正月初一). Ganzhi year here also follows the lunar new year.",
  "lunar": {
   "day": 1,
   "text": "二〇二六年正月初一",
   "year": 2026,
   "month": 1,
   "isLeapMonth": false
  },
  "ganzhi": {
   "day": "壬戌",
   "year": "丙午",
   "month": "庚寅"
  },
  "zodiac": {
   "en": "Horse",
   "zh": "马"
  },
  "festivals": [
   "春节"
  ],
  "solarTerm": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/china-lunar-calendar-lookup-332fb24c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cn-holiday-x402.linholiday.workers.dev](https://www.zero.xyz/host/cn-holiday-x402.linholiday.workers.dev/llms.txt)