--- name: gotobi.hugen.tokyo description: gotobi.hugen.tokyo provides calendar data specific to Japan, covering two distinct concepts: Gotobi days (corporate USD settlement dates falling on multiples of 5 in each month) and Japanese public holidays. All five skills return structured date and status information with no inputs required for today-focused queries and a month string for forward-looking queries. host: gotobi.hugen.tokyo --- # gotobi.hugen.tokyo This host serves agents operating in Japanese financial, logistics, or scheduling contexts that need to distinguish between Gotobi settlement dates and Japanese public holidays. It covers both real-time (today) and forward-looking (by month or next occurrence) queries for these two calendar types. It does not cover general business calendars, non-Japanese holidays, or market data beyond date classification. ## When to use this host Use this host when an agent needs to classify Japanese calendar dates as Gotobi settlement days, public holidays, or both — particularly for FX scheduling, logistics, or business day validation in Japan. For today-scoped queries with no inputs, use fetch-gotobi-today or fetch-today-holiday-status. For month-scoped planning, use fetch-gotobi-dates or fetch-japanese-holidays-by-month with a month string. Do not use this host for: holidays outside Japan (use a country-specific holiday API), real-time market prices or FX rates (use a market data provider), general business hours or corporate closures beyond national holidays, or historical date lookups beyond what the month-based endpoints support. ## Capabilities ### Gotobi Settlement Dates Identifies which dates in a given period are Gotobi days — Japanese corporate USD settlement dates on multiples of 5 — relevant for anticipating USDJPY buying pressure around the 9:55 JST Nakane fixing. - **`fetch-gotobi-today`** — Returns whether today is a Gotobi day (5th/10th of the month in Japan) along with the current date and a plain-text description. - **`fetch-gotobi-dates`** — Returns the list of gotobi dates (Japanese corporate USD settlement days) for a given month, including a description of their USDJPY fixing significance. ### Japanese Public Holiday Lookup Determines whether today is a Japanese public holiday, retrieves the next upcoming holiday, or lists all holidays in a specific month, including holiday names in Japanese. - **`fetch-today-holiday-status`** — Returns whether today is a Japanese holiday via the Gotobi API, including the holiday name and a brief market-closure note. - **`fetch-next-public-holiday`** — Returns the next upcoming Japanese public holiday name, date, and days-until count from today's date. - **`fetch-japanese-holidays-by-month`** — Returns a list of Japanese public holidays for a given month, including dates and holiday names in Japanese. ## Workflows ### Business Day Viability Check for Today *Use when an agent needs to determine whether today is suitable for scheduling a Japanese financial transaction by checking both Gotobi settlement activity and public holiday status simultaneously.* 1. **`fetch-gotobi-today`** — Determine if today is a Gotobi day, which signals elevated USDJPY settlement activity. 2. **`fetch-today-holiday-status`** — Determine if today is a Japanese public holiday that may close markets or suspend normal business operations. ### Forward Calendar Planning for a Given Month *Use when an agent needs to plan Japanese business or financial activity for a specific month by identifying both Gotobi settlement dates and public holidays to avoid or account for.* 1. **`fetch-gotobi-dates`** — Retrieve all Gotobi settlement dates for the target month to flag elevated FX activity windows. 2. **`fetch-japanese-holidays-by-month`** — Retrieve all public holidays in the same month to identify non-business days that may affect scheduling. ### Next Disruption Horizon Check *Use when an agent needs a near-term outlook on upcoming calendar disruptions, combining the next public holiday date with today's Gotobi status to assess the immediate settlement environment.* 1. **`fetch-gotobi-today`** — Confirm whether today itself carries Gotobi settlement pressure. 2. **`fetch-next-public-holiday`** — Identify how many days until the next Japanese public holiday to assess the near-term business day window. ## Skill reference ### `fetch-gotobi-today` **Gotobi Today** — Returns whether today is a Gotobi day (5th/10th of the month in Japan) along with the current date and a plain-text description. *Use when:* Use when an agent needs to determine if today is a Gotobi day (a Japanese payment/settlement date falling on multiples of 5) before scheduling financial transactions or logistics in Japan. *Not for:* Do not use for checking future or past Gotobi dates; use a month-dates or next-gotobi endpoint instead. Not suitable for Japanese public holiday lookups — use a holiday endpoint for that. **Returns:** Returns the current date, a boolean is_gotobi flag, and a plain-text description stating whether today is a Gotobi day. **Example:** `GET https://gotobi.hugen.tokyo/gotobi/today` --- ### `fetch-today-holiday-status` **Gotobi Holidays Today** — Returns whether today is a Japanese holiday via the Gotobi API, including the holiday name and a brief market-closure note. *Use when:* Use when an agent needs to determine if the current date is a Japanese public holiday, retrieve the holiday name, or check whether Japanese markets may be closed today. *Not for:* Do not use for querying holidays on a specific past or future date, or for retrieving a full month's holiday list; use the appropriate month-based Gotobi endpoint instead. **Returns:** Returns a JSON object with today's date, a boolean holiday flag, the Japanese holiday name (or null), and a brief description noting potential market closures. **Example:** `GET https://gotobi.hugen.tokyo/gotobi/holidays/today` --- ### `fetch-next-public-holiday` **NextHoliday Finder** — Returns the next upcoming Japanese public holiday name, date, and days-until count from today's date. *Use when:* Use when an agent needs to know the next Japanese public holiday relative to today, including the holiday name, its date, and how many days away it is. *Not for:* Do not use for checking whether today is a holiday (use a today-holiday endpoint instead), for listing all holidays in a month, or for non-Japanese regional calendars. **Returns:** Returns today's reference date, the next Japanese public holiday name and date, the number of days until it, and a human-readable description string. **Example:** `GET https://gotobi.hugen.tokyo/gotobi/holidays/next` --- ### `fetch-gotobi-dates` **Gotobi Dates** — Returns the list of gotobi dates (Japanese corporate USD settlement days) for a given month, including a description of their USDJPY fixing significance. *Use when:* Use when an agent needs to identify gotobi dates for a specific month to anticipate Japanese corporate USD settlement activity and associated USDJPY buying pressure around the 9:55 JST Nakane fixing. *Not for:* Do not use for general Japanese public holiday lookups or broad calendar event data; the response contains only gotobi settlement dates, not holidays or observances. **Inputs:** - `month` (string) — Month in YYYY-MM format (e.g., 2026-03). Defaults to current month. **Returns:** Returns year, month, an array of gotobi date strings, a count, and a description explaining USDJPY fixing significance for the requested month. **Example:** `GET https://gotobi.hugen.tokyo/gotobi/dates?month=2026-05` --- ### `fetch-japanese-holidays-by-month` **Gotobi Holiday Calendar** — Returns a list of Japanese public holidays for a given month, including dates and holiday names in Japanese. *Use when:* Use when an agent needs to know which days are public holidays in Japan for a specific month, such as to schedule tasks, check business day availability, or display a calendar. *Not for:* Do not use for public holidays in countries other than Japan; use a country-specific holiday API instead. Not suitable for real-time business hours or closures beyond national holidays. **Inputs:** - `month` (string) — Month in YYYY-MM format (e.g., 2026-05). Defaults to the current month if omitted. **Returns:** Returns year, month, count, a description string, and a holidays array of objects each with a date (YYYY-MM-DD) and Japanese holiday name for the requested month. **Example:** `GET https://gotobi.hugen.tokyo/gotobi/holidays?month=2026-05` ---