{"uid":"cap_8WJQ-QcyksnjuZ3p-N6W2","slug":"gotobi-hugen-tokyo-92591b71","name":"Japanese Public Holidays by Month","description":"Japanese public holidays for a given month — national holidays, substitute holidays (振替休日), and Golden Week. These holidays shift gotobi dates and close Tokyo markets, affecting JPY liquidity. Complete coverage through 2099 with substitute holiday rules. Accepts USDC payments on Base and Solana","url":"https://gotobi.hugen.tokyo/gotobi/holidays","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"required":["method"]}}},"responseSchema":null,"example":{"request":{"month":"2024-05"},"response":{"year":2024,"count":4,"month":5,"holidays":[{"date":"2024-05-03","name":"憲法記念日"},{"date":"2024-05-04","name":"みどりの日"},{"date":"2024-05-05","name":"こどもの日"},{"date":"2024-05-06","name":"こどもの日 振替休日"}],"description":"Japanese public holidays for 2024-05."}},"exampleRequest":{"month":"2024-05"},"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YF7JjJzdLvGbivMt1pjcL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all Japanese national and substitute public holidays for a specified month, including Golden Week, through 2099","exampleAgentPrompt":"What Japanese public holidays are in May 2025? I need the full list including any substitute holidays so I know which days the Tokyo market will be closed.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the year, month, total holiday count, and an array of holiday objects. Each holiday includes its date, Japanese and English name, and whether it is a substitute holiday (振替休日). Returns an empty array if no holidays fall in that month.","failureModes":["Invalid month format (not YYYY-MM) returns an error","Month outside supported range may return empty or error","Missing month parameter returns a 400 or default response","Payment not provided or insufficient USDC triggers a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need a programmatic, authoritative list of Japanese public holidays for a specific month — especially when building gotobi date calculators, Tokyo market trading calendars, or JPY liquidity models where holiday-adjusted business days matter. Covers through 2099 with full substitute holiday logic, which most public calendar APIs lack.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:42:42.814Z","isFirstParty":false}