# torii — x402 Japan Data Factory

> Pay-per-call HTTP APIs for Japanese public data. Every endpoint below is metered with x402
> (HTTP 402 + PAYMENT-SIGNATURE): send a plain GET, receive 402 with the price and payment
> requirements, then resend with a signed payment. Only 2xx responses are charged; 4xx and 5xx
> are free. All endpoints are GET-only and return JSON.

## Discovery

- [/.well-known/x402](https://torii-gateway-staging.ichis-lab.workers.dev/.well-known/x402): machine-readable list of every paid resource (JSON).
- [/catalog.json](https://torii-gateway-staging.ichis-lab.workers.dev/catalog.json): full catalog with pricing, licence, update cadence, and the last successful liveness probe per source (JSON).
- [/llms.txt](https://torii-gateway-staging.ichis-lab.workers.dev/llms.txt): this document.

## Japan Business Calendar (jp-biz-calendar)

Japanese national holidays and business-day calculations derived from the Cabinet Office official CSV. Returns holidays for a given year, plus business-day arithmetic used by invoicing, logistics and HR systems in Japan.

- Category: practical. Freshness: static. Status: active.
- Source: 内閣府「国民の祝日について」 — PDL-1.0, commercial use allowed, attribution required: "出典:内閣府ウェブサイト(https://www8.cao.go.jp/chosei/shukujitsu/gaiyou.html)を加工して作成". Terms: https://www.cao.go.jp/notice/rule.html
- Free tier: 10 free calls per day per ip_hash; opt in with `?free=1` or the `X-Torii-Free: 1` header.
- [GET /v1/jp-biz-calendar/holidays](https://torii-gateway-staging.ichis-lab.workers.dev/v1/jp-biz-calendar/holidays): List Japanese national holidays for a year — $0.01 per successful call. Query: year (integer, required). Example: `curl -i "https://torii-gateway-staging.ichis-lab.workers.dev/v1/jp-biz-calendar/holidays?year=2026"`
- [GET /v1/jp-biz-calendar/is-business-day](https://torii-gateway-staging.ichis-lab.workers.dev/v1/jp-biz-calendar/is-business-day): Tell whether a given date is a Japanese business day — $0.01 per successful call. Query: date (string, required). Example: `curl -i "https://torii-gateway-staging.ichis-lab.workers.dev/v1/jp-biz-calendar/is-business-day?date=2026-01-05"`
- [GET /v1/jp-biz-calendar/add-business-days](https://torii-gateway-staging.ichis-lab.workers.dev/v1/jp-biz-calendar/add-business-days): Add or subtract business days from a given date — $0.01 per successful call. Query: date (string, required); n (integer, required). Example: `curl -i "https://torii-gateway-staging.ichis-lab.workers.dev/v1/jp-biz-calendar/add-business-days?date=2026-01-05&n=5"`
- [GET /v1/jp-biz-calendar/wareki](https://torii-gateway-staging.ichis-lab.workers.dev/v1/jp-biz-calendar/wareki): Convert a Gregorian date to the Japanese imperial era (wareki) — $0.01 per successful call. Query: date (string, required). Example: `curl -i "https://torii-gateway-staging.ichis-lab.workers.dev/v1/jp-biz-calendar/wareki?date=2026-01-05"`