Japanese public holidays for a given month — national holidays, substitute holidays (振替休日)
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
10000 (raw units)
price
4
calls / 30d
2
unique payers
2026-09-01
updated
Provider
gotobi.hugen.tokyo · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x29322Ea7EcB34aA6164cb2ddeB9CE650902E4f60",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "4du4AfkjJEwch2zk3shkPJVZfyJHNDnNjEWC6AboaS5Z",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "10000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"category": "finance-calendar",
"discoverable": true,
"info": {
"input": {
"method": "GET",
"queryParams": {
"month": "2026-05"
},
"type": "http"
},
"output": {
"example": {
"count": 4,
"description": "Japanese public holidays for 2026-05.",
"holidays": [
{
"date": "2026-05-03",
"name": "憲法記念日"
},
{
"date": "2026-05-04",
"name": "みどりの日"
},
{
"date": "2026-05-05",
"name": "こどもの日"
},
{
"date": "2026-05-06",
"name": "振替休日"
}
],
"month": 5,
"year": 2026
},
"type": "json"
}
},
"schema": {
"properties": {
"input": {
"required": [
"method"
]
}
}
},
"tags": [
"fx",
"japan",
"calendar",
"gotobi"
]
}
}Use it
curl
curl "https://gotobi.hugen.tokyo/gotobi/holidays" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://gotobi.hugen.tokyo/gotobi/holidays");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://gotobi.hugen.tokyo/gotobi/holidays")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/14160.json, and this resource appears in /discovery/resources and /discovery/search.