---
title: "Explicit-offset timestamp converter"
method: POST
path: "/api/agent-commerce/v1/services/timestamp_timezone_convert/execute"
tags: ["data_tools"]
---

# Explicit-offset timestamp converter

`POST /api/agent-commerce/v1/services/timestamp_timezone_convert/execute`

## Request

- Base URL: `https://www.tradepilotusa.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.tradepilotusa.com/api/agent-commerce/v1/services/timestamp_timezone_convert/execute`
- Auth: none declared

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.

## Request body

- object
  - `iso` string, required
  - `time_zone` string, required

## Response `200`

Successful response

- object
  - `result` object, required
    - `utc` string, required
    - `time_zone` string, required
    - `assumptions` string, required
    - `local_display` string, required
    - `unix_milliseconds` integer, required
  - `utility` 'timestamp_timezone_convert', required
  - `provenance` object, required
    - `execution` 'deterministic_local', required
    - `model_used` unknown, required
    - `network_request_performed` unknown, required
  - `request_id` string, required

## Other responses

- `402`: Payment Required

---

[API](https://skmtc.dev/tradepilotusa/apis/tradepilotusa-agent-commerce.md) · [All operations](https://skmtc.dev/tradepilotusa/apis/tradepilotusa-agent-commerce/llms.txt) · [OpenAPI document](https://skmtc.dev/tradepilotusa/apis/tradepilotusa-agent-commerce/revisions/1060778e0a57?raw)
