{"uid":"cap_L0EYp36yD4wRN_NWMDNUu","slug":"japan-traditional-calendar-koyomi-api-b889fe8b","name":"Japan Traditional Calendar (Koyomi) API","description":"Japanese traditional calendar for a date: rokuyo (taian/butsumetsu... lucky days used for weddings, funerals, contracts), Japanese era (Reiwa) date, old lunisolar calendar date incl. leap months, 24 solar terms (sekki) and year eto. Verified against the National Astronomical Observatory of Japan.","url":"https://japan-business-day-api.matchan962.workers.dev/v1/koyomi?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":["date"],"properties":{"date":{"type":"string","format":"date"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_y4_nycT5qkMoN2rgHpqda","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns full Japanese traditional calendar data for a given date, including rokuyo lucky-day rating, Japanese era date, lunisolar calendar date, 24 solar terms, and year eto.","exampleAgentPrompt":"What's the traditional Japanese calendar info for March 15, 2025? I need the rokuyo lucky-day rating, the Reiwa era date, the lunisolar date, the solar term, and the year eto.","exampleUseCases":[{"title":"Wedding date auspiciousness check","prompt":"We're planning a Japanese wedding and want to check if October 18, 2025 is a taian day — can you look up the rokuyo and full koyomi details for that date?"},{"title":"Business contract signing timing","prompt":"My Japanese business partner wants to sign the deal on a lucky day — can you check the rokuyo for November 3, 2025 so we know whether it's taian or one of the unlucky days like butsumetsu?"},{"title":"Traditional calendar conversion for cultural content","prompt":"I'm writing about Japanese seasonal culture — what are the traditional calendar details for the winter solstice, December 22, 2025? I'd love the sekki solar term, the eto, and the lunisolar date."}],"resultDescription":"Returns a structured object for the queried date containing: the rokuyo category (e.g. taian, butsumetsu, sensho, tomobiki, shakku, senbu), the Japanese era name and year (e.g. Reiwa 7), the lunisolar calendar month and day including leap month status, the applicable 24 solar term (sekki) if any, and the year eto (heavenly stem and earthly branch zodiac designation).","failureModes":["Missing or malformed 'date' query parameter returns a 400 error","Dates outside the supported historical or future range may return empty or error responses","Network timeout on the Cloudflare Worker edge function","Dates before the Meiji era or far future dates may have limited era/rokuyo accuracy"],"whenToPreferThis":"Use this endpoint when you need authoritative traditional Japanese calendar data for a specific date, particularly rokuyo for ceremony/event planning (weddings, funerals, contract signings), era-based date display for Japanese audiences, lunisolar date conversion, or seasonal solar term annotation. Prefer this over generic calendar APIs when Japanese cultural accuracy is required and results are verified against the National Astronomical Observatory of Japan.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:34:30.502Z","isFirstParty":false,"canonicalSlug":"japan-traditional-calendar-koyomi-api-b889fe8b"}