{"uid":"cap_woCKipxM6TC0fmpfkDXLV","slug":"chinese-lunar-date-converter-5145c536","name":"Chinese Lunar Date Converter","description":"Convert a Gregorian date to the Chinese lunar date (with leap month) or back, plus zodiac animal and year name.","url":"https://chinese-culture.x402tookit.com/lunar-date?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":[],"properties":{"date":{"type":"string","description":"Gregorian YYYY-MM-DD (1930 to 2100) to convert to lunar"},"lunar":{"type":"string","description":"Lunar YYYY-MM-DD to convert to Gregorian; add an L after the month for a leap month: 2023-02L-01"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"source":{"type":["null","string"]},"element":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"lunarDay":{"type":["null","number"]},"gregorian":{"type":["null","string"]},"leapMonth":{"type":["boolean","null"]},"lunarYear":{"type":["null","number"]},"monthName":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"lunarMonth":{"type":["null","number"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"yearPillar":{"type":["null","string"]},"zodiacAnimal":{"type":["null","string"]},"isNewYearsDay":{"type":["boolean","null"]},"monthLengthDays":{"type":["null","number"]},"yearPillarPinyin":{"type":["null","string"]},"leapMonthOfThatYear":{}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CCzl3GFQNNyDVyddd58J7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a Gregorian date to its Chinese lunar calendar equivalent (or back), returning the lunar year, month, day, zodiac animal, heavenly stem-earthly branch year name, and leap-month flag.","exampleAgentPrompt":"What is the Chinese lunar calendar date for March 15, 2025? I'd also like to know the zodiac animal and the year pillar name in pinyin.","exampleUseCases":[{"title":"Birthday zodiac and year pillar lookup","prompt":"My friend was born on September 8, 1988 — what is their Chinese lunar birthday, zodiac animal, and what is the year pillar called in pinyin?"},{"title":"Convert lunar anniversary to Gregorian","prompt":"Our traditional anniversary falls on the 15th day of the 7th lunar month of 2024 — what is the Gregorian date for that so I can put it in my calendar?"},{"title":"Check if a date falls in a leap lunar month","prompt":"Is February 20, 2023 in a leap month on the Chinese lunar calendar, and if so, what is the full lunar date including the leap-month indicator?"}],"resultDescription":"Returns the Chinese lunar year number, lunar month number, lunar day, a boolean flag for whether the month is a leap month, the number of days in that lunar month, the traditional month name, the year pillar (heavenly stem + earthly branch in Chinese characters and pinyin), the zodiac animal, the corresponding Gregorian date, and a flag indicating whether the date is Chinese New Year's Day.","failureModes":["Date out of supported range (1930–2100) returns an error or empty result","Malformed date string (wrong format, invalid day/month) causes a validation error","Leap-month suffix used for a month that is not actually a leap month in that year returns an error","Missing both 'date' and 'lunar' query parameters results in an error response","Network or service degradation flag set to true in the response indicating partial/unreliable data"],"whenToPreferThis":"Choose this endpoint when you need authoritative bidirectional conversion between the Gregorian and Chinese lunar calendar, including correct handling of leap months, the sexagenary (stems-and-branches) year cycle, and zodiac animal — especially when the output will be used for traditional Chinese cultural events, birthday calculations, or holiday scheduling between 1930 and 2100.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:32:49.057Z","isFirstParty":false,"canonicalSlug":"chinese-lunar-date-converter-5145c536"}