{"uid":"cap_vbBzCLnfCS-r5nSi-BNqs","slug":"china-lunar-calendar-lookup-332fb24c","name":"China Lunar Calendar Lookup","description":"Each paid call costs 0.01 USDC on eip155:8453 via x402 (exact scheme). Free: /health, /, /openapi.json, /llms.txt, /.well-known/x402.","url":"https://cn-holiday-x402.linholiday.workers.dev/lunar?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__5oLf_kEFoCqoQiwuFn5n","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Chinese lunar calendar data for a given Gregorian date, including lunar date, Ganzhi cycle, zodiac, festivals, and solar terms.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Convert birthday to lunar calendar","prompt":"My grandmother was born on March 8, 1955 — what was her Chinese lunar calendar date, including the Ganzhi year and zodiac animal?"},{"title":"Check Chinese festival date","prompt":"Is January 29, 2025 a Chinese festival day? What is its lunar date and does it fall on a solar term?"},{"title":"Ganzhi day for contract signing","prompt":"I'm signing a business contract on October 4, 2024 — what is the Ganzhi day, lunar date, and zodiac year for that date according to the Chinese calendar?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:03:20.493Z","isFirstParty":false,"canonicalSlug":"china-lunar-calendar-lookup-332fb24c"}