Api Endpoint

Gotobi Holiday Calendar

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

Open interactive test console

Offering

Provider: gotobi.hugen.tokyo
Method: GET
Offering type: Api Endpoint
Transport type: http
Category: General Utilities
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://gotobi.hugen.tokyo/gotobi/holidays
MIME type: application/json
First seen: 2026-10-16T01:58:26.121Z
Last seen: 2026-11-01T21:01:45.838Z
Tags: Search, Utility

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1: 0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2: 0.01 USDC
Atomic price: 10000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "payTo": "0x29322Ea7EcB34aA6164cb2ddeB9CE650902E4f60"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "10000",
    "payTo": "4du4AfkjJEwch2zk3shkPJVZfyJHNDnNjEWC6AboaS5Z"
  }
]

Observed health

Status: Healthy
Latest latency: 1134 ms
Average latency: 982 ms
HTTP status: 402
Last checked: 2026-11-01T21:01:45.834Z
Reachability: 92.9% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "http",
  "method": "GET",
  "queryParams": {
    "month": "2026-05"
  }
}

Output schema

{
  "type": "json",
  "example": {
    "year": 2026,
    "month": 5,
    "holidays": [
      {
        "date": "2026-05-03",
        "name": "憲法記念日"
      },
      {
        "date": "2026-05-04",
        "name": "みどりの日"
      },
      {
        "date": "2026-05-05",
        "name": "こどもの日"
      },
      {
        "date": "2026-05-06",
        "name": "振替休日"
      }
    ],
    "count": 4,
    "description": "Japanese public holidays for 2026-05."
  }
}