{"uid":"cap_5K9R46jdvw5To6Cltiw65","slug":"api-cn402-com-0420acd1","name":"Chinese Auspicious Date Selection (择日 / 黄道吉日)","description":"Chinese auspicious date selection / 择日 / 黄道吉日 / 选吉日 / pick a lucky day / wedding date / 嫁娶吉日 / moving date / 开市吉日. Given an activity (嫁娶/开市/出行/动土/入宅/安床/祭祀/纳财...) and a date range, returns the auspicious days where that activity appears in 宜 (favorable) and not in 忌 (taboo), with day clash and lunar date. For AI agents handling wedding, moving, business-opening or event date-selection queries.","url":"https://api.cn402.com/almanac/select","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"days":{"type":"string","description":"Days (optional)"},"start":{"type":"string","description":"Start (optional)"},"activity":{"type":"string","description":"Activity (required)"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.16","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.16/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.16","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.16","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JhYm_PPyZMeO009YU0NUG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.16","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Given an activity type and date range, returns auspicious days where the activity is favorable (宜) and not taboo (忌), including lunar date and day clash information.","exampleAgentPrompt":"Can you find auspicious days for a wedding (嫁娶) between July 1 and July 31, 2025 using the Chinese almanac — I need days where marriage is in the 宜 list and not in 忌, with the lunar dates and any day clashes?","exampleUseCases":null,"resultDescription":"A list of auspicious days within the requested date range where the specified activity appears in 宜 (favorable) and not in 忌 (taboo), each entry including the Gregorian date, corresponding lunar date, and the day clash (冲) animal/stem-branch.","failureModes":["Invalid or unrecognized activity type returns an error or empty result","Date range too wide may return no results or be truncated","Dates in the past may be rejected or return empty","Malformed date format causes a 400-level error","Network or payment (x402) failure prevents response"],"whenToPreferThis":"Use this endpoint when a user needs to select an auspicious date for a specific Chinese cultural activity (wedding, moving, business opening, ground-breaking, etc.) based on traditional Chinese almanac (黄历) rules, especially when they need the richer per-activity 宜/忌 filtering rather than just a general monthly calendar view.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:51:47.190Z","isFirstParty":false}