{"service":"Agent Time & Place","version":"0.1.0","tagline":"Geocoding, timezones, holidays, business days, sun times, FX and distances for AI agents. Deterministic, sub-cent, no API key: payment is authentication (x402).","payment":{"protocol":"x402","version":2,"mode":"mainnet","facilitator":"payai","networks":"Base + Solana mainnet","alsoAccepts":["MPP (Machine Payments Protocol): same routes answer with a WWW-Authenticate: Payment challenge"],"accepts":[{"network":"eip155:8453","asset":"USDC","payTo":"0xc42cbF077aF05D1a613d455067c201CA44e9CAFb"}],"howTo":"Call any endpoint. You get HTTP 402 with a PAYMENT-REQUIRED header. Sign the USDC payment with any x402 client (@x402/fetch, Coinbase Payments MCP, AgentCash, OpenClaw x402 skill), retry with PAYMENT-SIGNATURE, receive JSON. Failed requests (4xx/5xx) are never settled."},"endpoints":[{"method":"GET","path":"/v1/geocode","url":"https://time-place.agent-utils.workers.dev/v1/geocode","price":"$0.005","summary":"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.","tags":["geocoding","location","timezone","cities"],"example":"https://time-place.agent-utils.workers.dev/v1/geocode?q=Munich&country=DE&limit=3"},{"method":"GET","path":"/v1/reverse","url":"https://time-place.agent-utils.workers.dev/v1/reverse","price":"$0.005","summary":"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.","tags":["geocoding","reverse-geocoding","location","timezone"],"example":"https://time-place.agent-utils.workers.dev/v1/reverse?lat=40.4168&lon=-3.7038"},{"method":"GET","path":"/v1/timezone","url":"https://time-place.agent-utils.workers.dev/v1/timezone","price":"$0.005","summary":"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.","tags":["timezone","time","dst","scheduling"],"example":"https://time-place.agent-utils.workers.dev/v1/timezone?city=Tokyo"},{"method":"GET","path":"/v1/holidays","url":"https://time-place.agent-utils.workers.dev/v1/holidays","price":"$0.005","summary":"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.","tags":["holidays","calendar","scheduling","business-days"],"example":"https://time-place.agent-utils.workers.dev/v1/holidays?country=FR&year=2026"},{"method":"GET","path":"/v1/business-days","url":"https://time-place.agent-utils.workers.dev/v1/business-days","price":"$0.005","summary":"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').","tags":["business-days","calendar","sla","scheduling","holidays"],"example":"https://time-place.agent-utils.workers.dev/v1/business-days?country=US&from=2026-11-25&add=3"},{"method":"GET","path":"/v1/sun","url":"https://time-place.agent-utils.workers.dev/v1/sun","price":"$0.005","summary":"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.","tags":["sun","sunrise","sunset","astronomy","moon"],"example":"https://time-place.agent-utils.workers.dev/v1/sun?lat=59.9139&lon=10.7522&date=2026-06-21"},{"method":"GET","path":"/v1/convert","url":"https://time-place.agent-utils.workers.dev/v1/convert","price":"$0.005","summary":"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.","tags":["currency","fx","exchange-rate","finance","pricing"],"example":"https://time-place.agent-utils.workers.dev/v1/convert?from=USD&to=EUR&amount=100"},{"method":"GET","path":"/v1/distance","url":"https://time-place.agent-utils.workers.dev/v1/distance","price":"$0.005","summary":"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.","tags":["distance","geodesy","travel","logistics"],"example":"https://time-place.agent-utils.workers.dev/v1/distance?from=Lisbon&to=Sao+Paulo"}],"free":["https://time-place.agent-utils.workers.dev/health","https://time-place.agent-utils.workers.dev/openapi.json","https://time-place.agent-utils.workers.dev/llms.txt"],"coverage":{"cities":34135,"holidayCountries":"110+","currencies":"160+"},"attribution":["GeoNames (CC BY 4.0)","Nager.Date","open.er-api.com","European Central Bank via frankfurter.dev"]}