{"uid":"cap_KC3fIHeHtlx3BeIriY84A","slug":"api-cn402-com-c00fd2f0","name":"Chinese Almanac (老黄历) Daily Calendar API","description":"Chinese almanac (老黄历, Tong Sheng, 黄历) for daily date selection. Returns lunar date, ganzhi heavenly stems and earthly branches (天干地支), na yin (纳音), yi ji auspicious activities (宜忌), zodiac day clash, 28 lunar mansions (二十八宿), 12 day officers (建除十二神), pengzu taboos (彭祖百忌). For Chinese cultural queries, wedding date picking, business date picking, traditional astrology. Accepts payment on Base or Solana — either network works.","url":"https://api.cn402.com/almanac","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"date":{"type":"string","description":"Date YYYY-MM-DD (required)"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","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.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xOl5AYoAzqOnxYoIivLbo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns traditional Chinese almanac data for a given date, including auspicious/inauspicious activities, deity directions, lunar mansions, and 15+ classical calendar fields","exampleAgentPrompt":"What does the Chinese almanac (老黄历) say for July 18, 2025? I need the auspicious and inauspicious activities, deity directions, lunar mansion, and all the traditional calendar fields for that day.","exampleUseCases":null,"resultDescription":"A structured response containing 15+ traditional Chinese almanac fields for the requested date, including: auspicious activities (宜), inauspicious activities (忌), lucky deity directions, lunar mansion (宿), day conflict (冲), solar term, ten-thousand-year calendar stem-branch cycle for year/month/day/hour, nine star (九星), twelve day officer (十二建), and other classical Chinese calendar metadata — all in Beijing time context.","failureModes":["Invalid date format returns an error — must use YYYY-MM-DD","Missing date parameter defaults to today in Beijing time, which may not be intended","Dates far outside supported range may return empty or error responses","Payment failure (402) if USDC balance or x402 header is missing or insufficient","Network timeout for slow connections"],"whenToPreferThis":"Use this endpoint when you need authoritative traditional Chinese almanac (老黄历) data for a specific date, especially for cultural event planning, wedding date selection, business launch timing, content localization for Chinese audiences, or any application that needs the full set of classical Chinese calendar fields. Prefer this over generic lunar calendar converters when you need auspicious/inauspicious activity lists, deity directions, lunar mansions, and the complete stem-branch cycle.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:31:00.908Z","isFirstParty":false}