# Touchstone Time API

> Touchstone Time API is a paid API for AI agents from touchstone.locomot.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Performs timezone conversions, time diffs, business day calculations, holiday lookups, and epoch conversions for a given instant or date range

## Facts

- Endpoint: GET https://touchstone.locomot.io/time
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/touchstone-time-api-7efbcf5d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RjlJjovUYYoTpyleaNtRU

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 touchstone-time-api-7efbcf5d
```

Example prompt: What time is it right now in Tokyo, and can you also tell me what that maps to in New York? Use the convert operation with America/New_York as the target timezone and Asia/Tokyo as the source.

## When to prefer this

Use this endpoint when you need reliable timezone conversion, business day counting, holiday detection, or epoch parsing without building your own time library. Particularly useful for scheduling, calendar math, or internationalizing timestamps across IANA zones for any country.

## Known failure modes

- Invalid or unknown IANA timezone string returns an error
- Malformed ISO-8601 'when' parameter causes parse failure
- Missing required query parameters for the selected operation (e.g. no 'to_tz' for convert)
- Invalid country code for holidays lookup
- Year or date out of supported range
- Payment not attached or insufficient — x402 payment required response

## How this service works

Deterministic time/timezone truth: DST-aware zone conversion, transition times, business-day & holiday math, epoch<->ISO. Free sample, no payment required: GET /play/time

## Output

Returns a JSON object with the computed result depending on the operation: for conversions, includes 'from' and 'to' timezone objects with local times, 'utc', 'same_instant' flag, 'unix_epoch_seconds', and 'tz_database_version'; for diffs or business_days, numeric counts; for holidays, whether the given date is a holiday; for epoch, the parsed timestamp details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "op": {
       "enum": [
        "convert",
        "zone",
        "diff",
        "business_days",
        "holidays",
        "epoch"
       ],
       "type": "string",
       "description": "operation; default convert"
      },
      "tz": {
       "type": "string",
       "description": "zone/epoch: IANA zone"
      },
      "end": {
       "type": "string",
       "description": "diff/business_days: end"
      },
      "date": {
       "type": "string",
       "description": "holidays: single date to test"
      },
      "when": {
       "type": "string",
       "description": "instant: ISO-8601, epoch, or now"
      },
      "year": {
       "type": "integer",
       "description": "holidays: year"
      },
      "epoch": {
       "type": "number",
       "description": "epoch: seconds or millis"
      },
      "start": {
       "type": "string",
       "description": "diff/business_days: start"
      },
      "to_tz": {
       "type": "string",
       "description": "convert: target IANA zone"
      },
      "country": {
       "type": "string",
       "description": "ISO-3166 alpha-2 (US, GB, …)"
      },
      "from_tz": {
       "type": "string",
       "description": "convert: source IANA zone"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "op": {
     "type": "string"
    },
    "to": {
     "type": "object"
    },
    "utc": {
     "type": "string"
    },
    "from": {
     "type": "object"
    },
    "engine": {
     "type": "string"
    },
    "same_instant": {
     "type": "boolean"
    },
    "deterministic": {
     "type": "boolean"
    },
    "input_instant": {
     "type": "string"
    },
    "unix_epoch_seconds": {
     "type": "integer"
    },
    "tz_database_version": {
     "type": "string"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/touchstone-time-api-7efbcf5d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from touchstone.locomot.io](https://www.zero.xyz/host/touchstone.locomot.io/llms.txt)