# Strait of Hormuz Tanker Flow Recovery

> Strait of Hormuz Tanker Flow Recovery is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-21).

Returns real-time or near-real-time tanker movement metrics and zone counts for the Strait of Hormuz, with baseline recovery tracking and data quality signals.

## Facts

- Endpoint: POST https://api.timzinin.com/api/strait-of-hormuz-tanker-flow-recovery?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/strait-of-hormuz-tanker-flow-recovery-bfeb685d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yRu57Dxs_eWV420o9MWzX

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 strait-of-hormuz-tanker-flow-recovery-bfeb685d -d '<json body>'
```

Example prompt: Can you pull the latest tanker flow recovery report for the Strait of Hormuz — I want to see how many tankers are moving vs stopped, the zone breakdown across eastern approach, transit corridor, and western approach, and whether traffic levels are recovering toward baseline?

## When to prefer this

Use this endpoint when you need a structured, pay-per-call maritime intelligence report specifically for the Strait of Hormuz with built-in baseline recovery tracking, zone-level granularity, and data quality scoring. Prefer it over generic AIS dashboards when you need machine-readable confidence signals and historical delta comparisons for automated decision-making or geopolitical risk pipelines.

## Known failure modes

- Bootstrap status returned when fewer than 7 observations are available — baseline metrics will be null
- Synthetic fixture mode active in demo — production data requires live AIS or commercial maritime data license
- Incomplete zone coverage may reduce data quality score below threshold
- Payment settlement failure via x402 protocol results in no response
- Source freshness exceeded — retrievedAt timestamp may be stale if upstream AIS feed is delayed

## How this service works

Pay-per-call data & tool APIs

## Output

A JSON object containing a report ID, observed timestamp, tanker count, movement breakdown (slow/moving/stopped/unknown), zone counts for eastern approach, transit corridor, and western approach, baseline ratio and percent delta vs historical windows (7-obs and 30-obs means), a confidence rating, data quality score and coverage metadata, source provenance details, and a bootstrap/active status indicating whether enough observations exist to compute a reliable baseline.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "watchId": {
   "type": "string",
   "pattern": "^[a-z0-9][a-z0-9._-]{2,63}$"
  },
  "requestId": {
   "type": "string",
   "pattern": "^(auto|[a-z0-9][a-z0-9._:-]{2,127})$"
  },
  "maxVessels": {
   "type": "integer",
   "maximum": 500,
   "minimum": 1
  },
  "sourceMode": {
   "enum": [
    "demo",
    "datalastic"
   ],
   "type": "string"
  },
  "identitySalt": {
   "$ref": "#/definitions/bazaarShared0"
  },
  "schemaVersion": {
   "enum": [
    "1.0"
   ],
   "type": "string"
  },
  "datalasticApiKey": {
   "$ref": "#/definitions/bazaarShared0"
  },
  "maxTotalChargeUsd": {
   "type": "number",
   "maximum": 100,
   "minimum": 0.055
  },
  "maxProviderRequests": {
   "type": "integer",
   "maximum": 4,
   "minimum": 4
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "actor": "strait-of-hormuz-tanker-flow-recovery",
    "region": "strait-of-hormuz",
    "status": "bootstrap",
    "actions": [
     {
      "actionId": "sha256:801d216247d7d6e0e83d902e41bb1fe3755bf304ca12b2cd6bf341626dcf96ab",
      "not_sent": true,
      "instruction": "Review the evidence and source freshness before making an operational decision.",
      "review_required": true
     }
    ],
    "metrics": {
     "movement": {
      "slow": 0,
      "moving": 2,
      "stopped": 1,
      "unknown": 0
     },
     "zoneCounts": {
      "eastern_approach": 1,
      "transit_corridor": 1,
      "western_approach": 1
     },
     "tankerCount": 3,
     "transitions": {
      "exits": null,
      "entries": null,
      "nullReasons": {
       "exits": "no_prior_observation",
       "entries": "no_prior_observation",
       "crossZoneTransitions": "no_prior_observation"
      },
      "crossZoneTransitions": null
     }
    },
    "signals": [],
    "sources": [
     {
      "mode": "demo",
      "calls": 0,
      "license": "synthetic",
      "endpoint": "synthetic_fixture",
      "provider": "synthetic_fixture",
      "retrievedAt": "2026-08-08T00:00:00.000Z"
     }
    ],
    "watchId": "hormuz-tanker-flow",
    "baseline": {
     "ratio": null,
     "status": "bootstrap",
     "coverage": {
      "minimum": 7,
      "preferred": 30,
      "observations": 0
     },
     "nullReasons": {
      "ratio": "insufficient_observations",
      "percentDelta": "insufficient_observations",
      "selectedWindow": "insufficient_observations",
      "sevenObservationMean": "insufficient_observations",
      "thirtyObservationMean": "insufficient_observations"
     },
     "percentDelta": null,
     "selectedWindow": null,
     "observationCount": 0,
     "previousReportId": null,
     "minimumObservations": 7,
     "sevenObservationMean": null,
     "thirtyObservationMean": null
    },
    "reportId": "sha256:bb8beb4bfeb750d16a517f0499650a931216ca0a0ba92052750c0e12f7c73019",
    "confidence": "high",
    "observedAt": "2026-08-08T00:00:00.000Z",
    "dataQuality": {
     "score": 100,
     "partial": false,
     "coverage": {
      "sample": 3,
      "expected": 3,
      "freshness": 3
     },
     "sourceOk": true,
     "confidence": "high",
     "limitations": [
      "Complete paid delivery requires all fixed zones, a non-empty aggre
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/strait-of-hormuz-tanker-flow-recovery-bfeb685d/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)