Check whether today is a Japanese public holiday, with name and description.
What it does
The `/gotobi/holidays/today` endpoint is part of the Gotobi Calendar API, a specialized service focused on Japanese FX gotobi (五十日) dates and Japanese public holidays. This specific endpoint returns whether today's date is a Japanese public holiday, and if so, provides the holiday name and a description. The API covers holiday data through 2099 and accounts for holiday shifts (observed holidays moved due to weekends).
The endpoint is an x402-gated GET request priced at $0.01 USDC on Base per call. It requires no query parameters — simply issue a GET and receive a JSON response with the date, a boolean `is_holiday` flag, the `holiday_name` (or null if not a holiday), and a textual `description`. The broader Gotobi Calendar API also offers endpoints for checking gotobi dates, listing holidays by month, and finding the next upcoming holiday or gotobi date.
Alternative access methods include an MCP gateway at `mcp.hugen.tokyo/mcp`, a free API key with $0.05 credit via the discovery service, or the `x402-pay` Python SDK for wallet-free one-line access.
Capabilities
Use cases
- —Checking if today is a Japanese public holiday before executing FX trades
- —Building trading bots that need to know Japanese market closures
- —Integrating Japanese holiday awareness into scheduling or calendar applications
- —Automating notifications about upcoming Japanese holidays for remote teams
Fit
Best for
- —Algorithmic FX traders needing Japanese holiday awareness
- —Agents or bots that must respect Japanese market schedules
- —Applications requiring programmatic Japanese public holiday data through 2099
Not for
- —Looking up holidays for countries other than Japan
- —Historical holiday research (API is forward-looking through 2099, unclear on past dates)
- —Free bulk holiday data downloads — each call costs $0.01
Quick start
pip install x402-pay
import x402_pay
r = x402_pay.get('https://gotobi.hugen.tokyo/gotobi/holidays/today')
print(r.json())Example
Response
{
"date": "2026-05-05",
"is_holiday": true,
"description": "Today, 2026-05-05, is a Japanese public holiday: Children's Day.",
"holiday_name": "Children's Day"
}Endpoint
Quality
Full OpenAPI schema with typed response models, live 402 challenge with sample response data, clear pricing ($0.01 USDC on Base), and multiple access alternatives documented. Docked slightly because there is no dedicated docs page beyond the auto-generated Swagger UI, and the description field content in the response is inferred from the sample.
Warnings
- —Root URL returns 404 — no landing page; docs only at /docs
- —No dedicated pricing page; price inferred solely from x402 challenge header
- —Response description field content is inferred from the sample challenge, not from explicit documentation
Citations
- —The API is described as the only programmatic source for Japanese FX gotobi dates with holiday shifts through 2099https://gotobi.hugen.tokyo/docs
- —The endpoint is priced at $0.01 USDC on Base per callhttps://gotobi.hugen.tokyo/gotobi/holidays/today
- —Sample response includes date, is_holiday, holiday_name, and description fieldshttps://gotobi.hugen.tokyo/gotobi/holidays/today
- —Alternative access via MCP gateway, API key, or x402-pay SDKhttps://gotobi.hugen.tokyo/gotobi/holidays/today