# agent402.tools Add Time

> agent402.tools Add Time is a paid API for AI agents from agent402.tools, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Adds or subtracts a human-readable duration string to a given date and returns the resulting UTC ISO timestamp.

## Facts

- Endpoint: POST https://agent402.tools/api/add-time
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-add-time-41195a82
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LWtBnn1zG2j4CjEM2j5KU

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 agent402-tools-add-time-41195a82 -d '<json body>'
```

Example prompt: What UTC timestamp do I get if I add 1 week and 2 days to March 15, 2025 at 09:00 UTC? Use a duration like '1w 2d'.

## When to prefer this

Use this endpoint when you need to arithmetically offset a date or time by a human-friendly duration string (e.g. '2d', '-3h', '1w 2d', '90m') and get back a precise UTC ISO timestamp. Prefer this over manual date math or building duration parsers yourself, especially for agents handling scheduling, expiry calculations, or relative time offsets.

## Known failure modes

- Invalid or unrecognized duration format returns an error (e.g. '2x' or empty string)
- Malformed base date string causes a parse error
- Missing duration parameter results in a validation error
- Negative duration that produces a date before Unix epoch may cause issues

## How this service works

Add (or subtract) a duration to a date. duration like "2d", "-3h", "1w 2d", "90m". Returns the resulting UTC ISO timestamp.

## Output

A UTC ISO 8601 timestamp string representing the computed date and time after applying the specified duration offset to the base date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "description": "Base date (default now)"
  },
  "duration": {
   "type": "string",
   "description": "e.g. \"2d\", \"-3h\", \"1w\""
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": "2026-06-13T15:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-add-time-41195a82/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)