# Syntexa AgentShelf Timezone Lookup

> Syntexa AgentShelf Timezone Lookup is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns IANA timezone identifier, local ISO time, UTC offset, and DST flag for a given latitude/longitude pair or city name using offline timezone data.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/timezone?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/syntexa-agentshelf-timezone-lookup-c17089df
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MFXOVZfivouAMYxyMNnN6

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability syntexa-agentshelf-timezone-lookup-c17089df -d '<json body>'
```

Example prompt: What's the IANA timezone, current local time, UTC offset, and whether DST is active right now for coordinates 40.7128, -74.006?

## When to prefer this

Choose this endpoint when an agent needs structured timezone data — IANA identifier, local ISO time, UTC offset, and DST status — from coordinates or a city name without relying on a live external API call, since timezone resolution is fully offline and fast. It is ideal for scheduling, logging, localization, or any workflow that must map a geographic location to its current time context. Use the free sandbox endpoint (/v1/sandbox/timezone) for testing before committing the $0.002 USDC per-call fee.

## Known failure modes

- Invalid or out-of-range latitude/longitude values return a validation error
- Unrecognized or misspelled city names fail geocoding and return an error
- Sending both city and lat/lon together is rejected as an invalid request
- Missing both city and lat/lon returns a bad request error
- Payment not attached or insufficient USDC results in a 402 Payment Required response

## How this service works

Call when an agent needs an IANA timezone, local_time ISO, utc_offset, and dst for coordinates or a city. Send lat and lon together (example 40.7128 and -74.006) or city (example New York). A city is geocoded first. Timezone data is offline. No arbitrary URL. Send JSON {"lat":40.7128,"lon":-74.006}. Exact $0.002 USDC on Base. Try unpaid POST /v1/sandbox/timezone first.

## Output

Returns a JSON object containing the IANA timezone string (e.g. 'America/New_York'), the current local time in ISO 8601 format, the UTC offset as a signed string (e.g. '-05:00'), and a boolean DST flag indicating whether daylight saving time is currently in effect at the queried location.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number",
   "maximum": 90,
   "minimum": -90,
   "examples": [
    40.7128
   ],
   "description": "Latitude in decimal degrees, sent with lon. Example: 40.7128. Returns timezone, local_time, utc_offset, and dst. Omit lat and lon when sending city."
  },
  "lon": {
   "type": "number",
   "maximum": 180,
   "minimum": -180,
   "examples": [
    -74.006
   ],
   "description": "Longitude in decimal degrees, sent with lat. Example: -74.006. Omit lon and lat when sending city."
  },
  "city": {
   "type": "string",
   "maxLength": 120,
   "minLength": 1,
   "description": "City name to geocode, then resolve offline. Example: New York. Do not send city together with lat and lon. Returns timezone, local_time, utc_offset, and dst."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/syntexa-agentshelf-timezone-lookup-c17089df/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)