# Japanese Public Holidays by Month

> Japanese Public Holidays by Month is a paid API for AI agents from gotobi.hugen.tokyo, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns all Japanese national and substitute public holidays for a specified month, including Golden Week, through 2099

## Facts

- Endpoint: GET https://gotobi.hugen.tokyo/gotobi/holidays
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gotobi-hugen-tokyo-92591b71
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8WJQ-QcyksnjuZ3p-N6W2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gotobi-hugen-tokyo-92591b71
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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

## Output

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.

## Example request

```json
{
 "month": "2024-05"
}
```

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "required": [
    "method"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gotobi-hugen-tokyo-92591b71/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gotobi.hugen.tokyo](https://www.zero.xyz/host/gotobi.hugen.tokyo/llms.txt)