Pulse

Use for trend questions ("how did USD/EUR move this quarter?") and for back-dated conversions: returns daily ECB reference rates for each working day between start and end (max 366 days) for the requested currencies, re-based to any base, with per-currency first, last, min, max and percent change.

Use to see what the tech/startup community is reading right now or to monitor launches: returns up to 30 stories from one Hacker News list (top = front page, new, best, ask, show, job) via the official HN API, each with title, external URL and domain, score, comment count, posted time and the news.ycombinator.com discussion link. Usernames are omitted (non-personal data).

Use for trip planning, logistics, event or outdoor decisions: returns the forecast for a location from the Norwegian Meteorological Institute (global coverage): current temperature, wind, humidity, cloud cover, pressure and symbol, an hourly series for the next N hours, and daily summaries (min/max temperature, total precipitation, dominant symbol). Give lat/lon, or a place name resolved via Wikidata. Times are UTC. Licensed CC BY 4.0: credit MET Norway.

Use for scheduling across time zones: takes a wall-clock time in a source zone (or an ISO instant with offset) and returns the same instant in each target zone with date, weekday, UTC offset and DST flag, plus the UTC instant. Handles daylight-saving transitions correctly (times in a spring-forward gap move to the first valid instant and are flagged).

Use when an agent needs the real current time somewhere (models do not know "now"): returns the authoritative current UTC instant and, for each requested IANA time zone, the local date/time, weekday, UTC offset, abbreviation and whether daylight saving time is in effect. Computed from the IANA tz database, no upstream dependency.

Use to convert money amounts for quotes, invoices, expense reports or price comparisons: converts an amount from one currency to another at the ECB reference rate of the latest working day or of a given past date (rates since 1999-01-04; weekends/holidays fall back to the previous working day). Returns the converted amount, the rate used and the rate date.

Use when you need a current, citable exchange rate: returns the latest European Central Bank reference rates (published once per working day around 16:00 CET) for about 30 major currencies, re-based to any supported currency, optionally filtered to the symbols you need. Includes the rate date so you know how fresh it is. Not for trading; for pricing, reporting, invoicing and conversions.

Use when an agent has a city, landmark or postal address and needs lat/lon for maps, weather, distance or logistics: returns the best match with latitude, longitude, display name, country/countryCode, optional admin hierarchy, street/house number, OSM ids and bounding box. Public OpenStreetMap-derived data via Photon (Komoot), with Nominatim fallback. Not found = 404, not charged. Attribute OpenStreetMap when redistributing.

Use when an agent has coordinates (from GPS, a map click or another API) and needs a human-readable place: returns the nearest OSM feature with display name, country, city, street when available, and lat/lon of the matched feature. Public OpenStreetMap-derived data via Photon, Nominatim fallback. Empty ocean / unknown = 404, not charged.

Use for autocomplete-style place pickers or when the query is ambiguous: returns up to limit matches (default 5, max 10), each with lat/lon, display name, type and country. Same OpenStreetMap-derived sources as /v1/geocode. Empty result = 404, not charged.

Use for scheduling, payroll calendars, travel planning or "is the office closed?": returns every public holiday for a country (e.g. LT, US, DE, JP) in a given year from Nager.Date (~100 countries). Each holiday has date, English name, local name, whether it is nationwide (global) or limited to counties/states, fixed vs movable, and types (Public, Bank, School, Optional, Authority). Public, non-personal data.

Use before booking meetings, shipping deadlines or marketplace cut-offs: given a country and a date, returns isHoliday true/false, the matching holiday record(s) if any, and the next public holiday on or after that date in the same country (looks ahead into the following year if needed). Public calendar data only.

Use before calling /v1/holidays or /v1/holidays/check to discover supported country codes: returns every country Nager.Date covers (~100), each with countryCode and English name. No personal data.

Use for travel or leave planning: returns long-weekend windows for a country and year where a public holiday creates 3+ consecutive days off, including whether a bridge day is needed and which dates to take off. From Nager.Date LongWeekend.

Use to answer "when is the next public holiday in Germany?" or to build a short upcoming-holiday list for agents: returns the next public holidays for a country from today via Nager.Date NextPublicHolidays (typically the remainder of the year plus into the next). Optional limit caps the list.