{"uid":"cap_-GzFr_qYCDfdGrh_qyaRc","slug":"cn-data-chinese-lunar-calendar-fb97eb26","name":"CN Data – Chinese Lunar Calendar","description":"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.","url":"https://cn-data-x402.cn-data-x402-worker.workers.dev/cn/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","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"}}}}},"responseSchema":{"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"}},"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_6cJ0NDVW4nYueqJ4eFM5N","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 one or more dates, including lunar day/month, ganzhi stems-and-branches, zodiac, solar terms, and lunar festivals, as machine-readable JSON.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Upcoming Chinese festival alert","prompt":"Check the next 7 days starting from today and tell me which Chinese lunar festivals are coming up, like Spring Festival or Lantern Festival."},{"title":"Lunar date conversion for event planning","prompt":"I'm planning an event on March 15, 2026 — what is that date in the Chinese lunar calendar, and is it a lucky or notable day according to traditional Chinese timekeeping?"},{"title":"Daily ganzhi and solar term briefing","prompt":"What are today's ganzhi heavenly stems and earthly branches, and is there a solar term happening today or in the next day or two?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:42:55.811Z","isFirstParty":false,"canonicalSlug":"cn-data-chinese-lunar-calendar-fb97eb26"}