Api Endpoint

x402-catalog-history.ai-business-surface.workers.dev

Public holidays for one country and year in one GET: the date, the local-language name, the English name, the types, the weekday and how many days from today each one falls. curl: GET /holidays?country=JP&year=2026 (country is a two-letter ISO 3166-1 code; year defaults to this year). Response: {"country":"JP","year":2026,"count":16,"holidays":[{"date":"2026-01-01","local_name":"元日","name":"New Year's Day","types":["Public"],"weekday":"Thursday","global":true,"days_from_today":-290}],"upcoming":[...],"source":{"name":"Nager.Date","api":"https://date.nager.at/api/v3/PublicHolidays","fetched_at":"…"}}. Every value is read from the Nager.Date public API at the moment of the call, and the response carries the API URL and the fetched_at it came from. 0.003 USDC, no account, no key, one GET, one delivery. A purchase is two calls by design: this first call returns 402 with the price and the payment terms, and you then repeat the same request with the PAYMENT-SIGNATURE header to receive the 200 delivery.

Open interactive test console

Offering

Provider: x402-catalog-history.ai-business-surface.workers.dev
Method: GET
Offering type: Api Endpoint
Transport type: http
Category: Other
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://x402-catalog-history.ai-business-surface.workers.dev/holidays
MIME type: application/json
First seen: 2026-10-23T22:46:46.158Z
Last seen: 2026-11-01T20:33:39.540Z
Tags: Holidays, public-holidays, calendar, business-days, bank-holidays

Website

Payment pricing

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

Payment option 1: 0.003 USDC
Atomic price: 3000 · Network: eip155:8453 · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "3000",
    "payTo": "0x6f60659390aDA1D02B14024d8c9d0C889f2F89c3"
  }
]

Observed health

Status: Healthy
Latest latency: 1255 ms
Average latency: 1133 ms
HTTP status: 402
Last checked: 2026-11-01T20:33:39.534Z
Reachability: 100% over 7 checks

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

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "DELETE"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "country": {
          "type": "string"
        },
        "year": {
          "type": "string"
        }
      },
      "required": [
        "country"
      ]
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "example": {
      "type": "object"
    }
  },
  "required": [
    "type"
  ]
}