Check whether today is a Japanese FX gotobi (五十日) date, with holiday-adjusted calendar through 2099.
What it does
The Gotobi Calendar API is the only known programmatic source for Japanese FX gotobi (五十日) dates — the 5th, 10th, 15th, 20th, 25th, and last day of each month that are significant in USD/JPY trading due to corporate settlement flows. When a gotobi date falls on a Japanese public holiday or weekend, it shifts to the preceding business day. This API computes those adjusted dates through 2099, making it useful for algorithmic trading systems and FX strategy automation.
The `/gotobi/today` endpoint returns whether the current date is a gotobi day, along with contextual information such as the next Tokyo fixing time and expected USD/JPY bias. The broader API also offers `/gotobi/next` (days until the next gotobi), `/gotobi/dates?month=YYYY-MM` (all gotobi dates in a given month), and Japanese public holiday lookup endpoints (`/gotobi/holidays`, `/gotobi/holidays/today`, `/gotobi/holidays/next`). All responses are JSON.
Payment is handled via the x402 protocol at $0.01 USDC per call on Base. Alternative access methods include an MCP gateway, a free API key with $0.05 credit, and a Python SDK (`x402-pay`). The API ships a full OpenAPI 3.1 spec and Swagger docs at `/docs`.
Capabilities
Use cases
- —Determine if today is a gotobi day to anticipate USD/JPY buy pressure around the 9:55 JST Tokyo fixing
- —Build an algorithmic trading bot that adjusts FX positions on gotobi dates
- —Retrieve all holiday-adjusted gotobi dates for a given month for backtesting or scheduling
- —Check upcoming Japanese public holidays that may shift gotobi settlement dates
- —Integrate gotobi awareness into an LLM-based financial assistant via MCP
Fit
Best for
- —FX algorithmic traders focused on USD/JPY
- —Quantitative researchers backtesting gotobi-based strategies
- —Financial agents needing a machine-readable Japanese business calendar
Not for
- —General-purpose global holiday calendars unrelated to FX
- —Real-time USD/JPY price data or order execution
- —Non-financial calendar applications
Quick start
pip install x402-pay
import x402_pay
resp = x402_pay.get('https://gotobi.hugen.tokyo/gotobi/today')
print(resp.json())Example
Response
{
"date": "2026-03-05",
"is_gotobi": true,
"description": "Today is a gotobi date."
}Endpoint
Quality
Full OpenAPI 3.1 schema with well-defined response models, live 402 challenge with sample response, multiple access methods documented, and Swagger UI available. Docked slightly because there is no standalone documentation site, no explicit rate-limit info, and the sample response fields (next_fixing, usdjpy_bias) shown in the 402 challenge don't appear in the TodayResponse schema, suggesting the schema may be incomplete.
Warnings
- —The 402 challenge sample includes fields (next_fixing, usdjpy_bias) not present in the OpenAPI TodayResponse schema — actual response shape may differ from spec.
- —No dedicated pricing or rate-limit documentation page exists (returns 404).
- —Root URL returns 404; docs are only at /docs.
Citations
- —The API describes itself as 'the only programmatic source for Japanese FX gotobi (五十日) dates' with holiday shifts through 2099.https://gotobi.hugen.tokyo/docs
- —Payment is $0.01 USDC on Base per call via x402.https://gotobi.hugen.tokyo/gotobi/today
- —Alternative access via MCP gateway, API key with $0.05 credit, or x402-pay Python SDK.https://gotobi.hugen.tokyo/gotobi/today
- —OpenAPI 3.1 spec available with defined schemas for TodayResponse, NextGotobiResponse, MonthDatesResponse, etc.https://gotobi.hugen.tokyo/docs