Name: timezone-lookup
Price: 0.001 USDC
Availability: InStock

$ man timezone-lookup

agentutility / locale / timezone-lookup

PRICE / CALL

$0.001

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

locale

CATEGORY

uncategorized

STATUS

● live

NAME

timezone-lookup — timezone lookup / iana tz / utc offset / dst status / local time at lat-lng / which timezone

SYNOPSIS

POST https://x402.org/v1/timezone-lookup
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Timezone lookup / IANA tz / UTC offset / DST status / local time at lat-lng / which timezone. Resolves the current local time, IANA timezone name, UTC offset (seconds), and DST status either by IANA timezone string (e.g. 'America/Los_Angeles') or by latitude/longitude coordinates. Wraps the public TimeAPI.io endpoint — no auth, commercial-OK.

INPUT — request schema

property	type	description	req?
latitude	number	Decimal degrees, range [-90, 90]. Required if no timezone provided.	optional
longitude	number	Decimal degrees, range [-180, 180]. Required if no timezone provided.	optional
timezone	string	IANA timezone identifier (e.g. 'America/Los_Angeles', 'Europe/Berlin'). Either this or lat+lon required.	optional
datetime_utc	string	Optional UTC datetime to evaluate at (ISO8601). Reserved for future use; current API returns now.	optional

OUTPUT — response shape

field	type	description
timezone	string	IANA timezone name resolved for the input, like 'America/Los_Angeles' or 'Europe/Berlin'.
utc_offset_seconds	string	Current offset from UTC in seconds, including any active DST adjustment.
abbreviation	string	Short timezone abbreviation currently in effect, such as PST, PDT, CET, or CEST.
is_dst	string	Boolean flag (as string) indicating whether daylight saving time is currently active at the location.
current_local_time	string	Current wall-clock time at the resolved timezone in ISO 8601 format.
source	string	Upstream data provider used for the lookup, typically 'timeapi.io'.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.org/v1/timezone-lookup \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the timezone-lookup tool to ..."

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: localetimezoneiana-tzutc-offsetdstlocal-timegeo-timezone
methods: POST
cluster: locale
price: $0.001 USDC per call

ADJACENT — other endpoints in locale

endpoint	description	price
timezone-convert	Timezone convert / IANA tz conversion / DST-aware time arithmetic / wall-clock to UTC / convert across cities.	$0.001
astro-times	sunrise-sunset / golden-hour / civil twilight / nautical dusk / day-length / solar-noon / dawn-dusk / astronomy times.	$0.002
country-info	Country info / ISO 3166 / country code lookup / capital city lookup / currencies by country / population / region resolver.	$0.002
earthquakes-recent	Earthquake feed / seismic activity / USGS / recent quakes / quake monitor / tremor data / fault line activity / tsunami alerts.	$0.002
holiday-lookup	Public holidays / bank holidays / national holidays / federal holidays / holiday calendar / per-country dates.	$0.002
sunrise-sunset	Sunrise sunset times.	$0.002
iata-airport-info	IATA / ICAO airport code lookup.	$0.005
satellite-tile	Satellite imagery tile / lat-lon to satellite PNG / Sentinel-2 tile API / cloud-free satellite snapshot / agent-callable satellite imagery.	$0.005

/timezone-lookup(1)