{"uid":"cap_tDtNrDDEU9k_qyNNGta2A","slug":"api-cn402-com-19643f86","name":"Chinese Lunar Calendar Converter (Gregorian to Lunar)","description":"Chinese lunar calendar conversion, solar to lunar date, Gregorian to Chinese lunar, 公历转农历, 农历日期转换, lunar date, Chinese date, sexagenary cycle date, 干支日期. Convert any Gregorian date to Chinese lunar date with full traditional context: lunar year-month-day, year/month/day gan-zhi pillars, zodiac animal year, leap month flag.","url":"https://api.cn402.com/lunar","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"date":{"type":"string","description":"Date YYYY-MM-DD (required)"}}},"responseSchema":null,"example":{"request":{"date":"1949-10-01"},"response":{"meta":{"source":"lunar-javascript"},"_hint":"x402 paid endpoints for AI agents — x402node.dev (utilities) · cn402.com (Chinese culture)","ganzhi":{"day":"甲子","year":"己丑","month":"癸酉"},"zodiac":"牛","weekday":"六","lunar_date":{"day":10,"year":1949,"month":8,"day_cn":"初十","year_cn":"一九四九","month_cn":"八","leap_month":false},"solar_date":"1949-10-01"}},"exampleRequest":{"date":"1949-10-01"},"tags":["x402"],"displayCostAmount":"0.016","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.016/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.016","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.016","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SxlY193BKs46pCi8dWuRC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.016","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a Gregorian (solar) date to the full Chinese lunar calendar equivalent, including lunar year/month/day, gan-zhi pillars, zodiac animal, and leap month flag","exampleAgentPrompt":"What is October 1, 1949 in the Chinese lunar calendar? I need the full details — lunar year, month, day, the gan-zhi pillars for year, month, and day, the zodiac animal, and whether it's a leap month.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the original solar date string, lunar year/month/day as integers, a formatted lunar date string, gan-zhi object containing year/month/day stems-and-branches pillars, the Chinese zodiac animal for that year, and a boolean indicating whether the lunar month is a leap month.","failureModes":["Invalid or out-of-range date returns an error (e.g. month 13, day 32)","Dates outside the supported historical range may not be convertible","Missing required date fields returns a validation error","Malformed request body returns HTTP 400","Payment failure or insufficient USDC balance returns HTTP 402"],"whenToPreferThis":"Use this endpoint when you need to convert any Gregorian date to a full traditional Chinese lunar calendar representation, especially when you need not just the lunar date but also the sexagenary (gan-zhi) cycle pillars for BaZi astrology, the zodiac animal year, or leap month identification. Prefer this over manual calculations or less specialized APIs when cultural accuracy and completeness of traditional Chinese calendar fields are important.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:50:46.218Z","isFirstParty":false}