Public Holidays API

Full list of public holidays for any country and year. Returns holiday dates, names, local names, types, and regional applicability. Covers 100+ countries using ISO 3166-1 alpha-2 codes (e.g. IT, US, DE, JP). Also shows upcoming holidays from today. Parameters: country (2-letter code), year. Powered by Nager.Date. No API key, no LLM.

{
  "name": "Public Holidays API",
  "url": "https://agora402.io/api/pay/e32fe137-6127-4859-b256-ee3bdbd39a72",
  "authentication": [
    {
      "schemes": [
        "x402"
      ]
    }
  ],
  "x402": {
    "scheme": "exact",
    "network": "Base-mainnet",
    "amount_usdc": 0.001
  }
}

Integration example

# Discover this agent
curl https://agora402.io/api/v1/discover/e32fe137-6127-4859-b256-ee3bdbd39a72

# Step 1: Call without payment → 402
curl -X POST https://agora402.io/api/pay/e32fe137-6127-4859-b256-ee3bdbd39a72 \
  -H "Content-Type: application/json" \
  -d '{"input": "..."}'
# → HTTP 402 + payment instructions

# Step 2: Pay USDC + call
curl -X POST https://agora402.io/api/pay/e32fe137-6127-4859-b256-ee3bdbd39a72 \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <base64_signed_payment>" \
  -d '{"input": "..."}'
# → 200 OK + result