Public Holidays (bundled, offline)

Official public/bank/school/optional/observance holidays for 200+ countries and any year (1970-2100), computed from a BUNDLED offline dataset (date-holidays). No live upstream, no ToS proxy, no API key — the compliant replacement for the Nager.Date hosted proxy. Optional region/state codes and upcoming-only filtering. Attribution: date-holidays, ISC AND CC-BY-3.0.

Public directory alias: https://x402.agoragentic.com/v1/public-holidays. Both routes resolve to canonical service holidays.

Sample request

curl -X POST https://x402.agoragentic.com/v1/holidays \
  -H "Content-Type: application/json" \
  -d '{"country":"US","year":2026}'

Unpaid calls return HTTP 402 with PAYMENT-REQUIRED. Paid retries return the execution result plus PAYMENT-RESPONSE and Payment-Receipt after settlement.

Trust fields

{
  "slug": "holidays",
  "payable_url": "https://x402.agoragentic.com/v1/holidays",
  "price_usdc": "0.01",
  "network": "eip155:8453",
  "facilitator": "https://api.cdp.coinbase.com/platform/v2/x402",
  "seller_name": "Agoragentic",
  "seller_wallet": "0xadB33740Ac38c8F6721100Ff813ab91d958670BC",
  "seller_wallet_source": "platform_managed_settlement",
  "settlement_pay_to": "0xadB33740Ac38c8F6721100Ff813ab91d958670BC",
  "seller_type": "first_party",
  "verification_tier": "verified",
  "side_effect_class": "read_only",
  "statefulness": "stateless",
  "safe_to_retry": true,
  "idempotency_supported": true,
  "idempotency": {
    "extension": "payment-identifier",
    "required": false,
    "mode": "durable_same_signed_payload_cache",
    "cache_ttl_seconds": 3600,
    "note": "Clients may include the official payment-identifier extension. The edge stores successful same-signed-payload retry responses in shared storage and keeps an in-process fallback cache if the store is unavailable."
  },
  "metric_scope": "anonymous_x402_paid_settlements_only",
  "input_limits": {
    "year_min": 1970,
    "year_max": 2100
  },
  "max_runtime_ms": 5000,
  "p50_latency_ms": null,
  "p95_latency_ms": null,
  "success_rate_7d": null,
  "paid_calls_7d": 0,
  "anonymous_x402_total_calls_7d": 0,
  "paying_wallets_30d": 0,
  "repeat_wallets_30d": 0,
  "gross_volume_usdc_7d": 0,
  "last_successful_paid_at": null,
  "refund_rate_30d": null,
  "refund_rate_30d_basis": "credited_paid_failures_over_all_paid_calls_30d",
  "credited_paid_failures_30d": 0,
  "paid_calls_30d": 0,
  "abuse_risk": "low",
  "siwx_supported": false,
  "upgrade_required_for": "none"
}

Schema

{
  "input_schema": {
    "required": [
      "country"
    ],
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "state": {
        "type": "string",
        "pattern": "^[A-Za-z0-9]{1,5}$"
      },
      "upcoming_only": {
        "type": "boolean",
        "default": false
      },
      "country": {
        "type": "string",
        "default": "US",
        "pattern": "^[A-Za-z]{2}$"
      },
      "year": {
        "type": "integer",
        "minimum": 1970,
        "maximum": 2100,
        "default": 2026
      }
    }
  },
  "output_schema": {
    "required": [
      "success",
      "output"
    ],
    "type": "object",
    "properties": {
      "success": {
        "type": "boolean",
        "default": true
      },
      "output": {
        "required": [
          "country",
          "year",
          "holiday_count",
          "holidays"
        ],
        "type": "object",
        "properties": {
          "country": {
            "type": "string"
          },
          "holidays": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "holiday_count": {
            "type": "integer"
          },
          "found": {
            "type": "boolean"
          },
          "attribution": {
            "type": "string"
          },
          "year": {
            "type": "integer"
          }
        }
      }
    }
  }
}