{"uid":"cap_cYWaEhGY36jjdSGTx-5lV","slug":"api-cn402-com-92b6fc42","name":"Chinese Auspicious Hours Selector (黄道吉时)","description":"Chinese auspicious hour selection, 择时, 时辰吉凶, 黄道吉时, lucky hours, best time of day, 嫁娶吉时. Returns all 12 shichen (two-hour periods) of a date, each with its 宜 (favorable), 忌 (taboo) activities and 黄道/黑道 quality. Optional activity param returns the best hours for that activity. Pairs with /almanac/select: which day, then which hour. For AI agents handling event timing, wedding/ceremony hour selection.","url":"https://api.cn402.com/almanac/hours","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"date":{"type":"string","description":"Date YYYY-MM-DD (required)"},"activity":{"type":"string","description":"Activity (optional)"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","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.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_YTxZYWxRvp6Hajo9BKryY","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 all 12 two-hour shichen periods for a given date, each rated with favorable/taboo activities and auspicious/inauspicious quality, with optional filtering for the best hours for a specific activity.","exampleAgentPrompt":"What are the luckiest hours on June 14, 2025 for a wedding ceremony (嫁娶)? I want to know which shichen periods are 黄道 auspicious and specifically which ones list 嫁娶 as a 宜 favorable activity.","exampleUseCases":null,"resultDescription":"A list of all 12 shichen (two-hour time blocks) for the requested date, each with its name, start/end time, 黄道 or 黑道 classification, list of 宜 (favorable) activities, and list of 忌 (taboo) activities. If an activity parameter is provided, the response highlights or filters to the best hours for that specific activity.","failureModes":["Invalid or missing date parameter returns an error","Unrecognized activity type string returns no filtered results or an error","Dates far outside supported range may return empty or error","Malformed POST body causes 400 error","Payment not included or insufficient returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need hour-level auspicious timing within a day, as a complement to /almanac/select which picks the lucky day. Ideal for wedding ceremony time selection, business opening hour, travel departure, or any event where traditional Chinese almanac hour quality matters. Prefer this over generic scheduling APIs when the user specifically asks about 黄道吉时, shichen, or Chinese auspicious hours.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:51:04.720Z","isFirstParty":false}