# TradepilotUSA Timestamp & Timezone Converter

> TradepilotUSA Timestamp & Timezone Converter is a paid API for AI agents from www.tradepilotusa.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-29).

Converts an ISO 8601 timestamp to a target IANA timezone, returning UTC, local display, and Unix milliseconds deterministically without external network calls.

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/timestamp_timezone_convert/execute?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradepilotusa-timestamp-timezone-converter-9097e827
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oGum5SIJX22uzB2MLb4KK

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 tradepilotusa-timestamp-timezone-converter-9097e827 -d '<json body>'
```

Example prompt: Convert 2026-01-15T18:00:00.000Z to America/Chicago time and show me the local display string and Unix millisecond value.

## When to prefer this

Choose this endpoint when you need a lightweight, deterministic, zero-latency timezone conversion without relying on an AI model or external API — ideal for normalizing timestamps for display, logging, scheduling, or cross-timezone comparisons. It is especially suitable when reproducibility and auditability matter, since the provenance block confirms no model or network is involved.

## Known failure modes

- Invalid or malformed ISO 8601 string returns an error
- Unrecognized IANA timezone identifier causes a failure
- Input exceeding maxLength (40 chars for iso, 80 for time_zone) may be rejected
- Missing required fields (iso or time_zone) produce a bad request error
- Ambiguous offsets near DST transitions may produce unexpected results per assumptions note

## How this service works

Convert an ISO timestamp with an explicit offset to UTC, Unix milliseconds and an IANA timezone display. Rejects ambiguous offset-free local times, invalid dates and leap seconds. Display uses runtime timezone data; years 1900–9999 only.

## Output

Returns a JSON object containing the UTC representation of the input timestamp, the target IANA timezone name, a human-readable local display string (e.g. '15/01/2026, 06:00:00 GMT-06:00'), the Unix timestamp in milliseconds, and an assumptions note about leap seconds and IANA/ICU data usage. Also includes a provenance block confirming execution is fully deterministic and local (no model or external network used).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "iso": {
   "type": "string",
   "maxLength": 40
  },
  "time_zone": {
   "type": "string",
   "maxLength": 80
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "utc": "2026-01-15T12:00:00.000Z",
   "time_zone": "America/Chicago",
   "assumptions": "Input offset defines the instant; display uses runtime IANA/ICU timezone data; leap seconds unsupported",
   "local_display": "15/01/2026, 06:00:00 GMT-06:00",
   "unix_milliseconds": 1768478400000
  },
  "utility": "timestamp_timezone_convert",
  "provenance": {
   "execution": "deterministic_local",
   "model_used": false,
   "network_request_performed": false
  },
  "request_id": "example_timestamp_timezone_convert"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-timestamp-timezone-converter-9097e827/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.tradepilotusa.com](https://www.zero.xyz/host/www.tradepilotusa.com/llms.txt)
