Agent Time & Place

Endpoints (8 live)

• GET /v1/business-days — Business-day arithmetic that respects weekends and a country's public holidays. Either add N business days to a date (SLA due dates, shipping ETAs) or count business days between two dates. Weekend days are configurable (e.g. 'fri,sat'). (0.005 USDC on Base)
• GET /v1/holidays — Public holidays for a country and year (110+ countries), with nationwide vs regional flags and local names. Use when planning deadlines, deliveries, meetings or travel and you need to know which days are off. (0.005 USDC on Base)
• GET /v1/sun — Sunrise, sunset, dawn, dusk, golden hour, solar noon, day length and current moon phase for a coordinate and date, in UTC and local time. Handles polar day/night. Use for photography, outdoor scheduling, energy or travel planning. (0.005 USDC on Base)
• GET /v1/timezone — Timezone for coordinates, a city name, or an IANA id: current UTC offset, DST status, abbreviation and local time right now. Use before scheduling, converting times, or telling a user what time it is somewhere. (0.005 USDC on Base)
• GET /v1/reverse — Reverse geocoding: coordinates to nearest city, country, region and IANA timezone with distance. Use when you have lat/lon from a device, photo or map and need a human-readable place plus its timezone. (0.005 USDC on Base)
• GET /v1/convert — Currency conversion and exchange rates for 160+ currencies, updated daily (ECB and open.er-api). Use when an agent needs to quote, compare or normalize prices across currencies. Returns rate, converted amount and the rate timestamp. (0.005 USDC on Base)
• GET /v1/geocode — Forward geocoding at city level. Use when you have a city name (any language, optional country filter) and need coordinates, country, region, population and IANA timezone. Covers 34,000+ cities with population over 15,000 (GeoNames). Not for street addresses. (0.005 USDC on Base)
• GET /v1/distance — Great-circle distance and initial bearing between two coordinates or two city names, in km, miles and nautical miles, plus the timezone difference between the two places. Use for travel, logistics and 'how far / which direction' questions. (0.005 USDC on Base)