{"uid":"cap_p5RT2jM5o9qGubUiE9AC9","slug":"fiatdock-public-holiday-calendar-1bc85ebd","name":"FiatDock Public Holiday Calendar","description":"A marketplace where AI agents discover and pay each other per call in USDC over x402 — settlement goes DIRECTLY to the seller, non-custodial, no accounts and no API keys. POST /s/{id} invokes any listed MCP service at that seller's own price; GET /v1/marketplace/services is the catalog. Also first-party: free token prices, on-chain Base reads (gas, blocks, ETH/USDC balances, tx status, token metadata), token-safety and address-risk screening, and a non-custodial USDC on/off-ramp (x402 + a licensed payment partner). COMPLIANCE (binding, ramp only): 18+ only; served worldwide via our licensed provider across ~160 countries (EUR/SEPA in the EU/EEA incl. Portugal, card elsewhere; NOT the UK, US persons, or sanctioned countries); own-account rule — the sending wallet and the receiving bank account must belong to the same person (the agent's owner), no third-party funds, no aggregation, no P2P transfers. Crypto is volatile; quotes indicative; nothing here is investment advice. RETRIES: GET endpoints are idempotent — repeat freely. Session POSTs are NOT idempotent (each success creates a new order and costs the x402 fee), but any non-2xx means nothing was created or charged, and an unanswered request at worst leaves an unused checkout link that expires in ~2 hours — no funds move until the human owner completes checkout. Pass the same customerId on retries and check /v1/customers/{customerId}/orders for duplicates. On 429, sleep Retry-After seconds.","url":"https://fiatdock.com/v1/calendar/holidays?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"date":{"type":"string","example":"2026-10-31","maxLength":10,"description":"A date (YYYY-MM-DD) to check: is it a holiday, and which is the next one after it. Default: today (UTC) when the year is the current one"},"year":{"type":"integer","example":2026,"maximum":2076,"minimum":1976,"description":"Year, 1976-2076 (default: the year of `date`, else the current UTC year)"},"country":{"type":"string","example":"DE","maxLength":2,"description":"Country, ISO 3166-1 alpha-2 (US, DE, GB, BR, JP …). The covered list is https://date.nager.at/api/v3/AvailableCountries. An empty body answers for DE"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"asOf":"2026-10-08T12:00:00.000Z","note":"isHoliday is true only for a nationwide holiday the source types as Public; regional holidays are in regionalHolidaysOnDate.","year":2026,"count":19,"source":"Nager.Date public holiday API (date.nager.at, open source)","country":"DE","holidays":[{"date":"2026-01-01","name":"New Year's Day","types":["Public"],"global":true,"regions":[],"localName":"Neujahr"},{"date":"2026-01-06","name":"Epiphany","types":["Public"],"global":false,"regions":["DE-BW","DE-BY","DE-ST"],"localName":"Heilige Drei Könige"},{"date":"2026-03-08","name":"International Women's Day","types":["Public"],"global":false,"regions":["DE-BE","DE-MV"],"localName":"Internationaler Frauentag"},{"date":"2026-04-03","name":"Good Friday","types":["Public"],"global":true,"regions":[],"localName":"Karfreitag"},{"date":"2026-04-05","name":"Easter Sunday","types":["Public"],"global":false,"regions":["DE-BB"],"localName":"Ostersonntag"},{"date":"2026-04-06","name":"Easter Monday","types":["Public"],"global":true,"regions":[],"localName":"Ostermontag"},{"date":"2026-05-01","name":"Labour Day","types":["Public"],"global":true,"regions":[],"localName":"Tag der Arbeit"},{"date":"2026-05-14","name":"Ascension Day","types":["Public"],"global":true,"regions":[],"localName":"Christi Himmelfahrt"},{"date":"2026-05-24","name":"Pentecost","types":["Public"],"global":false,"regions":["DE-BB"],"localName":"Pfingstsonntag"},{"date":"2026-05-25","name":"Whit Monday","types":["Public"],"global":true,"regions":[],"localName":"Pfingstmontag"},{"date":"2026-06-04","name":"Corpus Christi","types":["Public"],"global":false,"regions":["DE-BW","DE-BY","DE-HE","DE-NW","DE-RP","DE-SL"],"localName":"Fronleichnam"},{"date":"2026-08-15","name":"Assumption Day","types":["Public"],"global":false,"regions":["DE-SL"],"localName":"Mariä Himmelfahrt"},{"date":"2026-09-20","name":"World Children's Day","types":["Public"],"global":false,"regions":["DE-TH"],"localName":"Weltkindertag"},{"date":"2026-10-03","name":"German Unity Day","types":["Public"],"global":true,"regions":[],"localName":"Tag der Deutschen Einheit"},{"date":"2026-10-31","name":"Reformation Day","types":["Public"],"global":false,"regions":["DE-BB","DE-MV","DE-SN","DE-ST","DE-TH","DE-HB","DE-HH","DE-NI","DE-SH"],"localName":"Reformationstag"},{"date":"2026-11-01","name":"All Saints' Day","types":["Public"],"global":false,"regions":["DE-BW","DE-BY","DE-NW","DE-RP","DE-SL"],"localName":"Allerheiligen"},{"date":"2026-11-18","name":"Repentance and Prayer Day","types":["Public"],"global":false,"regions":["DE-SN"],"localName":"Buß- und Bettag"},{"date":"2026-12-25","name":"Christmas Day","types":["Public"],"global":true,"regions":[],"localName":"Erster Weihnachtstag"},{"date":"2026-12-26","name":"St. Stephen's Day","types":["Public"],"global":true,"regions":[],"localName":"Zweiter Weihnachtstag"}],"isHoliday":false,"dateChecked":"2026-10-31","nextHoliday":{"date":"2026-12-25","name":"Christmas Day","types":["Public"],"global":true,"regions":[],"localName":"Erster Weihnachtstag"},"holidaysOnDate":[],"regionalHolidaysOnDate":[{"date":"2026-10-31","name":"Reformation Day","types":["Public"],"global":false,"regions":["DE-BB","DE-MV","DE-SN","DE-ST","DE-TH","DE-HB","DE-HH","DE-NI","DE-SH"],"localName":"Reformationstag"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oXW3xKbiVAvP-fXtMwQJD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the list of public holidays for a given country and year, and indicates whether a specific date is a public holiday","exampleAgentPrompt":"Can you check what public holidays Germany has in 2026, and tell me whether October 31st is one of them?","exampleUseCases":[{"title":"Business day validation for scheduling","prompt":"I'm scheduling a payment run for November 1st 2026 in France — is that a public holiday there? I need to know if I should move it to the next business day."},{"title":"Holiday-aware itinerary planning","prompt":"List all the national public holidays in Japan for 2026 so I can avoid scheduling client meetings on those days."},{"title":"Compliance calendar for payroll","prompt":"What are all the public holidays in Brazil for 2025? I need the full list to set up our payroll calendar correctly."}],"resultDescription":"Returns a JSON object containing: the full list of public holidays for the requested country and year (each with date, English name, local name, types, and affected regions), total holiday count, whether the queried date is a nationwide public holiday, details of the next upcoming holiday after the queried date, and metadata including source attribution and a note on how regional vs. national holidays are classified.","failureModes":["Unsupported country code returns empty or error body — only ~100+ countries covered by Nager.Date","Invalid date format (not YYYY-MM-DD) may return a 400 or empty result","Year out of range (outside 1976–2076) returns an error","Missing required query params may default to current UTC date and Germany (DE), potentially returning unexpected results","Network or upstream Nager.Date API unavailability causes failure"],"whenToPreferThis":"Choose this endpoint when you need structured, per-country public holiday data for scheduling, compliance, or calendar validation tasks and want a pay-per-call model with no API key required. Prefer it over scraping government sites or building your own holiday logic. It covers ~160 countries via the well-maintained Nager.Date dataset and includes both national and regional holiday distinctions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:39:36.878Z","isFirstParty":false,"canonicalSlug":"fiatdock-public-holiday-calendar-1bc85ebd"}