2s

List the official holidays for a country and year, with exact observed dates including substitute days (e.g. a Saturday July 4th observed on Friday). Query: country (ISO 3166-1 alpha-2, 200+ supported), year, optional region (subdivision code like CA for US-California or BY for DE-Bavaria), optional types filter (public, bank, school, optional, observance — comma-separated), optional lang (ISO 639-1) for localized names. Returns one item per holiday: { date (YYYY-MM-DD), name, type, substitute, rule }. Dates are computed from maintained per-country rules — including movable feasts and lunar-calendar holidays — so they stay correct year over year. Use for scheduling, delivery estimates, payment terms, and SLA math.

Resource: 2s.io/api/calendar/holidays

Network: eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x2b6D4988Db4723E6908Db86Ab2b8dFBc51FC32C5

Payment methods: — · Last validation: 2026-09-13 23:22:34.205+00

{
  "input": {
    "type": "object",
    "required": [
      "type",
      "method",
      "queryParams"
    ],
    "properties": {
      "type": {
        "const": "http"
      },
      "method": {
        "const": "GET"
      },
      "queryParams": {
        "required": [
          "country",
          "year"
        ],
        "properties": {
          "lang": {
            "type": "string",
            "description": "Optional ISO 639-1 language for holiday names."
          },
          "year": {
            "type": "string",
            "description": "Calendar year, e.g. 2026."
          },
          "types": {
            "type": "string",
            "description": "Optional comma-separated filter: public, bank, school, optional, observance."
          },
          "region": {
            "type": "string",
            "description": "Optional subdivision code, e.g. CA (US-California), BY (DE-Bavaria)."
          },
          "country": {
            "type": "string",
            "description": "ISO 3166-1 alpha-2 country code, e.g. US, DE, JP."
          }
        }
      }
    }
  },
  "output": null,
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0x2b6D4988Db4723E6908Db86Ab2b8dFBc51FC32C5",
        "amount": "2500",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 60
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x2b6D4988Db4723E6908Db86Ab2b8dFBc51FC32C5",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "2500"
    },
    {
      "raw": {
        "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "extra": {
          "name": "USDC",
          "version": "1",
          "feePayer": "GVJJ7rdGiXr5xaYbRwRbjfaJL7fmwRygFi1H6aGqDveb"
        },
        "payTo": "TW6ntaGzvj63ZgPjszd4FCGmVTGfzv1MAYZbjYcyWhn",
        "amount": "2500",
        "scheme": "exact",
        "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
        "maxTimeoutSeconds": 60
      },
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "payTo": "TW6ntaGzvj63ZgPjszd4FCGmVTGfzv1MAYZbjYcyWhn",
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "amountAtomic": "2500"
    }
  ]
}

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.