# gotobi.hugen.tokyo Japanese Public Holiday Today Check

> gotobi.hugen.tokyo Japanese Public Holiday Today Check 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 whether today is a Japanese national public holiday, including the holiday name in Japanese and English, using JST timezone.

## Facts

- Endpoint: GET https://gotobi.hugen.tokyo/gotobi/holidays/today
- 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-ba608f36
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CN9lSFdfPMdqc1DFdW4Fq

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-ba608f36
```

Example prompt: Is today a Japanese public holiday? I need to know if the Tokyo market is open today before placing a USDJPY trade.

## When to prefer this

Use this endpoint when you need a real-time, JST-accurate check of whether today is a Japanese national holiday, substitute holiday, or special observance — especially for FX trading session validation, USDJPY scheduling, or any Japan-market-aware workflow that needs to run daily.

## Known failure modes

- Service unavailable — returns HTTP 5xx if the upstream is down
- Payment required — returns HTTP 402 if USDC payment via x402 is not included
- No holiday today — returns a non-holiday status with empty holiday name fields

## How this service works

Is today a Japanese public holiday? Returns holiday name in Japanese and English. Uses JST timezone for accurate date determination. Covers all national holidays, substitute holidays, and special observances. Essential for FX trading session validation and holiday-aware scheduling. Accepts USDC payments on Base and Solana

## Output

Returns whether today (in JST) is a Japanese public holiday, the holiday name in Japanese (e.g. 元日), and the holiday name in English (e.g. New Year's Day). Also covers substitute holidays and special observances.

## Example request

```json
{}
```

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gotobi-hugen-tokyo-ba608f36/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)