# CN Data – Chinese Lunar Calendar

> CN Data – Chinese Lunar Calendar is a paid API for AI agents from cn-data-x402.cn-data-x402-worker.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-16).

Returns Chinese lunar calendar data for one or more dates, including lunar day/month, ganzhi stems-and-branches, zodiac, solar terms, and lunar festivals, as machine-readable JSON.

## Facts

- Endpoint: GET https://cn-data-x402.cn-data-x402-worker.workers.dev/cn/lunar?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cn-data-chinese-lunar-calendar-fb97eb26
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-GzFr_qYCDfdGrh_qyaRc

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 cn-data-chinese-lunar-calendar-fb97eb26
```

Example prompt: What is the Chinese lunar calendar information for February 17, 2026 — give me the lunar date, ganzhi, zodiac sign, any solar terms, and upcoming festivals for the next 3 days.

## When to prefer this

Choose this endpoint when you need structured, machine-readable Chinese lunar calendar data — especially lunar dates, ganzhi, solar terms, or festival information — without setting up an account or API key, and when you want multi-day lookups (up to 31 days) in a single call. It is particularly useful when official Chinese sources are only available as web pages and you need clean JSON. Prefer this over generic calendar libraries when you need accurate Chinese-specific festival and solar term data with timezone handling for Asia/Shanghai.

## Known failure modes

- Invalid date format returns an error response
- Days parameter out of range (outside 1-31) may return an error or be clamped
- Payment not completed results in HTTP 402 with payment terms and no data
- Network or worker downtime returns 5xx error
- Dates far in the future or past may have reduced accuracy for solar term predictions

## How this service works

Chinese market and China-focused public data over the x402 protocol. No API key and no signup: call any endpoint, receive HTTP 402 with payment terms, pay the listed amount in USDC on Base and retry. Every response is JSON. Some Chinese-language sources are published only as web pages — these endpoints return them as clean, machine-readable JSON.

## Output

A JSON object containing an array of daily calendar entries for the requested date range, each with the Gregorian date, full lunar date string, lunar day and month (in Chinese characters), ganzhi for day/month/year, zodiac animal, weekday, ISO weekday number, leap month flag, any solar term for that day, and any lunar festivals. Also includes timezone (Asia/Shanghai), the next upcoming solar term with days away, and the next upcoming lunar festival with days away.

## 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",
     "properties": {
      "date": {
       "type": "string",
       "description": "起始日期 YYYY-MM-DD，默认今天"
      },
      "days": {
       "type": "integer",
       "description": "往后推几天 1-31，默认 1"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "days": 1,
   "from": "2026-02-17",
   "calendar": [
    {
     "date": "2026-02-17",
     "lunar": {
      "day": 1,
      "year": 2026,
      "dayCn": "初一",
      "month": 1,
      "monthCn": "正月",
      "isLeapMonth": false
     },
     "ganzhi": {
      "day": "壬戌",
      "year": "丙午",
      "month": "庚寅"
     },
     "zodiac": "马",
     "weekday": "周二",
     "lunarDate": "正月初一",
     "solarTerm": null,
     "isoWeekday": 2,
     "lunarFestivals": [
      "春节"
     ]
    }
   ],
   "timezone": "Asia/Shanghai",
   "nextSolarTerm": {
    "date": "2026-02-18",
    "name": "雨水",
    "daysAway": 1
   },
   "nextLunarFestival": {
    "date": "2026-02-17",
    "name": "春节",
    "daysAway": 0
   }
  },
  "endpoint": "/cn/lunar"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cn-data-chinese-lunar-calendar-fb97eb26/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cn-data-x402.cn-data-x402-worker.workers.dev](https://www.zero.xyz/host/cn-data-x402.cn-data-x402-worker.workers.dev/llms.txt)