# Traffic Index Operating Window Planner

> Traffic Index Operating Window Planner is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Analyzes Istanbul historical traffic index data to recommend optimal low-traffic dispatch or operating time windows for a given weekday and hour

## Facts

- Endpoint: POST https://api.timzinin.com/api/traffic-index-operating-window-planner
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/traffic-index-operating-window-planner-58a7635b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Tj9Y2Pl8uuYZZDyHTVJN0

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 traffic-index-operating-window-planner-58a7635b -d '<json body>'
```

Example prompt: Based on Istanbul historical traffic index data, find me the best low-traffic operating window for a Tuesday morning dispatch around 8:30am — I can be flexible by up to 2 hours if it means hitting significantly lighter traffic.

## When to prefer this

Choose this endpoint when you need a historically-grounded, explainable traffic-light window recommendation for Istanbul specifically, and your use case involves scheduling or dispatching (logistics, fleet, construction, events) rather than real-time navigation. It is not a traffic forecast or routing engine — use it when you want a defensible weekday/hour benchmark to anchor your scheduling decisions, with flex-hour alternatives pre-computed.

## Known failure modes

- Requested datetime falls outside available historical data range (oldest to latest timestamp)
- Traffic data source (İBB API) unavailable or returns stale data
- Invalid or missing windowId or scheduledAt parameters
- Flex hours value out of acceptable range
- No lower-traffic alternative found within the flex window (all slots exceed threshold)
- Payment settlement failure via x402 protocol

## How this service works

Pay-per-call data & tool APIs

## Output

Returns a structured operating window plan including the planned local hour and weekday, a recommended baseline hour with lower historical traffic (p75 index, median, min/max), offset hours from the requested time, traffic index statistics for both the requested and recommended slots, whether the requested time exceeds the traffic threshold, and methodology caveats clarifying that results are historical benchmarks rather than real-time forecasts.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "windows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "windowId",
     "scheduledAt",
     "flexHours",
     "maxTrafficIndex",
     "costPerIndexPointUsd"
    ],
    "properties": {
     "windowId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "maxLength": 64,
      "minLength": 1
     },
     "flexHours": {
      "type": "integer",
      "maximum": 6,
      "minimum": 0
     },
     "scheduledAt": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:00\\+03:00$"
     },
     "maxTrafficIndex": {
      "type": "integer",
      "maximum": 99,
      "minimum": 1
     },
     "costPerIndexPointUsd": {
      "type": "number",
      "maximum": 10000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems": 50,
   "minItems": 1
  },
  "requestId": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]+$",
   "maxLength": 64,
   "minLength": 8
  },
  "maxTotalChargeUsd": {
   "type": "number",
   "maximum": 100,
   "minimum": 0.025
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "action": "shift_to_lower_traffic_hour",
    "source": {
     "url": "https://api.ibb.gov.tr/tkmservices/api/TrafficData/v1/TrafficIndexHistory/28/H",
     "bytes": 40886,
     "route": "direct",
     "sha256": "9186eb3d790cd04d322578389bcb2f97bf06ba0c616beb088bb061793a9e55b4",
     "datasetUrl": "https://data.ibb.gov.tr/dataset/trafik-indeks-degeri-web-servisi",
     "licenseUrl": "https://data.ibb.gov.tr/license",
     "recordCount": 673,
     "retrievedAt": "2026-08-14T06:44:56.077Z",
     "declaredBytes": null,
     "latestTimestamp": "2026-08-14T09:00:00",
     "oldestTimestamp": "2026-07-17T09:00:00"
    },
    "country": "TR",
    "product": "traffic-index-operating-window-planner",
    "baseline": false,
    "billable": true,
    "decision": "operating-window-plan",
    "stableId": "IBB-TRAFFIC-WINDOW:a8686b41e776598a10f0331c",
    "windowId": "dispatch_am",
    "flexHours": 2,
    "attribution": "Source: Istanbul Metropolitan Municipality (İBB) Open Data Portal, Istanbul Traffic Index Web Service; licensed under the İBB Open Data Licence / CC BY 4.0-compatible attribution terms.",
    "scheduledAt": "2026-08-18T08:30:00+03:00",
    "sourceStats": {
     "recordCount": 673,
     "sourceTimezone": "Europe/Istanbul",
     "latestTimestamp": "2026-08-14T09:00:00",
     "oldestTimestamp": "2026-07-17T09:00:00",
     "baselinePercentile": 75,
     "distinctWeekdayHourSlots": 168
    },
    "plannedMinute": 30,
    "schemaVersion": "1.0",
    "criteriaSha256": "3ad79df5103c600f3bf90c870d0a710f26445926e516363affb2bddb187d5b87",
    "maxTrafficIndex": 45,
    "plannedBaseline": {
     "hour": 8,
     "weekday": 2,
     "p75Index": 49,
     "medianIndex": 48,
     "offsetHours": 0,
     "sampleCount": 4,
     "maximumIndex": 50,
     "minimumIndex": 46
    },
    "exceedsThreshold": true,
    "plannedLocalHour": 8,
    "methodologyCaveat": "The result is an explainable historical weekday/hour benchmark, not a traffic forecast, route-specific travel time, navigation instruction, or SLA guarantee. Verify current conditions before dispatch.",
    "plannedLocalWeekday": 2,
    "recommendedBaseline": {
     "hour": 6,
     "weekday": 2,
     "p75Index": 12,
     "medianIndex": 11,
     "offsetHours": -2,
     "sampleCount": 4,
     "maximumIndex": 13,
     "minimumIndex": 9
    },
    "recommendedLocalHour": 6,
    "expectedIndexRed
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/traffic-index-operating-window-planner-58a7635b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)