{"uid":"cap_RZQG4zayqT_aMSwAhnNe1","slug":"api-cn402-com-0032ff5a","name":"Chinese Calendar Daily Summary (今日宜忌)","description":"Chinese daily insight, today in Chinese calendar, 今日宜忌, today auspicious activities, today gan-zhi, today festival, today solar term. Comprehensive today summary: lunar date, gan-zhi pillars, zodiac, yi/ji activities, current festival if any, current solar term, dog days/coldest period flag. One-call snapshot of Chinese calendar context for today (or any date).","url":"https://api.cn402.com/today","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"format":{"type":"string","description":"Optional response format hint"}}},"responseSchema":null,"example":{"request":{"date":"2024-01-15"},"response":{"date":"2026-06-18","meta":{"tip":"For detailed almanac use /almanac","timezone":"Asia/Shanghai (UTC+8)","timestamp":"2026-06-18T05:09:56.510Z"},"_hint":"x402 paid endpoints for AI agents — x402node.dev (utilities) · cn402.com (Chinese culture)","jieqi":{"next":"夏至","current":null},"lunar":{"full":"二〇二六年五月初四","zodiac":"马","ganzhi_day":"癸亥","ganzhi_year":"丙午"},"almanac":{"ji":["嫁娶","开市","安葬","启钻","行丧"],"yi":["畋猎","捕捉","结网","取渔","祭祀","沐浴","馀事勿取"],"chong":"(丁巳)蛇","tianShenType":"黑道"},"weekday":"四","constellation":"双子","lucky_directions":{"fu":"艮","xi":"巽","cai":"离"}}},"exampleRequest":{"date":"2024-01-15"},"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_r9yC5LfkIDFvsAL03NPmk","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 a comprehensive Chinese calendar snapshot for today or any given date, including lunar date, gan-zhi pillars, zodiac, yi/ji (auspicious/inauspicious) activities, festivals, solar terms, and special period flags.","exampleAgentPrompt":"What does the Chinese almanac say about today — give me the full picture including the lunar date, gan-zhi pillars, zodiac, and which activities are auspicious (宜) or inauspicious (忌), plus any festival or solar term we're in.","exampleUseCases":null,"resultDescription":"A structured JSON snapshot containing: the Gregorian and lunar date, heavenly stem / earthly branch (gan-zhi) pillars for the year/month/day, the Chinese zodiac animal for the year, a list of auspicious (yi) activities, a list of inauspicious (ji) activities, any active Chinese festival, the current solar term (节气), and flags for special periods like dog days (三伏) or the coldest period (三九).","failureModes":["Invalid date format — API returns error if date string is malformed","Date out of supported range — very distant past or future dates may not be supported","Network timeout or HTTP 402 payment required if USDC payment not attached","Empty festival/solar-term fields when queried on a day with no active festival or term"],"whenToPreferThis":"Use this endpoint when you need a one-call, all-in-one Chinese calendar context for a specific date — covering lunar date, gan-zhi, zodiac, yi/ji activities, festivals, and solar terms together. Prefer over sibling endpoints (e.g. the festival-only or solar-term-only endpoints) when you need a comprehensive daily summary rather than a single piece of calendar data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:48:34.367Z","isFirstParty":false}