x402basequality 0.78

Japanese public holidays by month via x402 — part of the Gotobi Calendar API

Price
per_call
Protocol
x402
Verified
no
Endpoint
https://gotobi.hugen.tokyo/gotobi/holidays

What it does

The `/gotobi/holidays` endpoint returns Japanese public holidays for a given month, with holiday names and dates. It is part of the Gotobi Calendar API, which is described as the only programmatic source for Japanese FX gotobi (五十日) dates, providing adjusted dates with holiday shifts through 2099 for algorithmic trading use cases.

This specific endpoint accepts an optional `month` query parameter in `YYYY-MM` format (defaults to the current month) and returns a JSON object containing the year, month, an array of holiday objects (each with date and name), a count, and a description string. The endpoint is gated via the x402 payment protocol at $0.01 USDC on Base per request. Alternative access methods include an MCP gateway, API key with free trial credit, or the `x402-pay` Python SDK.

The API is documented via an OpenAPI 3.1 spec served at `/openapi.json` and interactive Swagger docs at `/docs`. The broader API also offers endpoints for checking whether today is a gotobi date, finding the next gotobi date, listing gotobi dates for a month, and querying the next upcoming Japanese holiday. Coverage extends through 2099.

Capabilities

japanese-holidaysgotobi-calendarmonth-queryholiday-date-lookupx402-paymentusdc-base

Use cases

  • —Checking Japanese public holidays for a specific month to schedule FX trades around gotobi dates
  • —Building algorithmic trading systems that need to account for Japanese holiday-shifted settlement dates
  • —Integrating a Japanese holiday calendar into scheduling or compliance workflows
  • —Querying upcoming holidays for travel or business planning involving Japan

Fit

Best for

  • —FX and algorithmic traders needing gotobi-aware Japanese holiday data
  • —Developers building Japan-market financial tools
  • —Agents that need programmatic access to Japanese public holiday schedules

Not for

  • —General-purpose global holiday lookups (covers Japan only)
  • —Free or high-volume bulk holiday data needs (each call costs $0.01 USDC)

Quick start

pip install x402-pay
import x402_pay
r = x402_pay.get('https://gotobi.hugen.tokyo/gotobi/holidays?month=2026-05')
print(r.json())

Example

Response

{
  "year": 2026,
  "count": 4,
  "month": 5,
  "holidays": [
    {
      "date": "2026-05-03",
      "name": "Constitution Day"
    },
    {
      "date": "2026-05-05",
      "name": "Children's Day"
    }
  ],
  "description": "Japanese public holidays for 2026-05"
}

Endpoint

URLhttps://gotobi.hugen.tokyo/gotobi/holidays
Transporthttp
Protocolx402
Pay to0x29322Ea7EcB34aA6164cb2ddeB9CE650902E4f60
CurrencyUSD COIN

Quality

0.78/ 1.00

Full OpenAPI 3.1 schema with typed response models, live 402 challenge with sample response data, and clear pricing ($0.01 USDC on Base). Docs are auto-generated Swagger; no dedicated prose documentation or usage examples beyond the SDK one-liner. The sample response in the challenge shows count=4 but only 2 holidays in the array, which is a minor inconsistency.

Warnings

  • —Root URL returns 404 — no landing page, only /docs available
  • —Sample challenge response shows count=4 but only 2 holiday objects in the array — possible truncation or data inconsistency
  • —No dedicated pricing page; price inferred solely from x402 challenge header

Citations

Provenance

Indexed fromx402_bazaar
Enriched2026-04-22 01:21:34Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-21
Last seen2026-04-22

Agent access

JSONhttps://clawmart.sh/api/listings/pyTQRU
Japanese public holidays by month via x402 — part of the Gotobi Calendar API — Clawmart · Clawmart