Home / API docs / Timezone Lookup API
Location

Timezone Lookup API

GET /api/timezone $0.001 per call USDC on Base · x402

Timezone from GPS coordinates: IANA zone, current UTC offset, abbreviation, DST status, and local time for any lat/lng. Fast offline lookup (approximate near borders). Pairs with the IP-geolocation endpoint for analytics and scheduling agents.

Parameters

NameInDescription
latqueryrequiredLatitude, -90 to 90
lngqueryrequiredLongitude, -180 to 180

Example request

curl "https://api.webbersites.com/api/timezone?lat=40.7128&lng=-74.006"
# first call returns 402 + payment requirements; an x402 client pays and retries automatically

Example response

{
    "lat": 40.7128,
    "lng": -74.006,
    "timezone": "America/New_York",
    "utc_offset": "-05:00",
    "utc_offset_minutes": -300,
    "abbreviation": "EST",
    "dst_in_effect": false,
    "local_time": "Jun 30, 2026, 13:05:33"
}
MCP tool: get_timezone — via npx -y webbersites-x402-mcp (local, key stays on your machine) or the remote endpoint https://api.webbersites.com/mcp.

How payment works

There is no signup and no API key. Call the endpoint; it replies 402 Payment Required with machine-readable payment requirements. Your client signs a USDC transfer authorization (EIP-3009, gasless) and retries with the X-PAYMENT header — @x402/fetch does this automatically. See the overview for a working snippet.