# Panama Canal Queue, Transit & Imbalance Monitor

> Panama Canal Queue, Transit & Imbalance Monitor 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).

Returns real-time vessel queue counts, side imbalance metrics, and transit flow data for the Panama Canal Pacific and Atlantic approaches

## Facts

- Endpoint: POST https://api.timzinin.com/api/panama-canal-queue-transit-imbalance
- 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/panama-canal-queue-transit-imbalance-monitor-64e6928a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Mp8HJ2UjthEsJbwHbA1oB

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 panama-canal-queue-transit-imbalance-monitor-64e6928a -d '<json body>'
```

Example prompt: What does the current Panama Canal vessel queue look like — how many ships are waiting on each side and is there a significant imbalance between the Pacific and Atlantic approaches?

## When to prefer this

Choose this endpoint when you need real-time, aggregated Panama Canal queue and congestion data with per-side (Pacific/Atlantic) vessel breakdowns and imbalance ratios, without needing raw AIS feeds or official Canal slot data. Ideal for supply chain monitoring agents, logistics dashboards, or shipping risk systems that need a single pay-per-call data point on Canal congestion without building their own AIS pipeline.

## Known failure modes

- Baseline metrics (meanQueue, queueRatio, previousQueue, percentDelta) may be null during bootstrap phase when insufficient history exists
- Dwell time statistics unavailable if AIS dwell data cannot be derived (DWELL_UNAVAILABLE limitation)
- Data freshness may lag up to 900 seconds (15 minutes)
- Status may be 'bootstrap' rather than 'operational' on initial calls with no historical baseline
- Payment failure or insufficient USDC balance will block the call via x402 protocol

## How this service works

Pay-per-call data & tool APIs

## Output

Returns a JSON report with vessel counts (new, slow, moving, stopped, unknown, departed) for both Pacific and Atlantic approaches, total queue size, side imbalance ratio, cross-side transitions, observed dwell time statistics (min/max/mean), flow events, data quality score with coverage and confidence rating, a baseline comparison section (when history is available), and source attribution from Datalastic-derived AIS aggregate data.

## 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,63})$"
  },
  "timeoutMs": {
   "type": "integer",
   "maximum": 30000,
   "minimum": 1000
  },
  "maxVessels": {
   "type": "integer",
   "maximum": 500,
   "minimum": 1
  },
  "sourceMode": {
   "enum": [
    "demo",
    "datalastic"
   ],
   "type": "string"
  },
  "baselineDays": {
   "type": "integer",
   "maximum": 365,
   "minimum": 7
  },
  "identitySalt": {
   "$ref": "#/definitions/bazaarShared0"
  },
  "schemaVersion": {
   "enum": [
    "1.0"
   ],
   "type": "string"
  },
  "datalasticApiKey": {
   "$ref": "#/definitions/bazaarShared0"
  },
  "maxTotalChargeUsd": {
   "type": "number",
   "maximum": 100,
   "minimum": 0.005
  },
  "maxProviderRequests": {
   "type": "integer",
   "maximum": 3,
   "minimum": 3
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "actor": "panama-canal-queue-transit-imbalance",
    "errors": [],
    "report": {
     "region": "panama_canal_approaches",
     "status": "bootstrap",
     "billing": {
      "tier": "FREE",
      "resultEvent": "result-found",
      "resultPriceUsd": 0.05,
      "baseResultPriceUsd": 0.05
     },
     "metrics": {
      "pacific": {
       "new": 4,
       "slow": 0,
       "moving": 3,
       "stopped": 1,
       "unknown": 0,
       "departed": 0,
       "queueCount": 4
      },
      "atlantic": {
       "new": 6,
       "slow": 0,
       "moving": 4,
       "stopped": 2,
       "unknown": 0,
       "departed": 0,
       "queueCount": 6
      },
      "flowEvents": 0,
      "totalQueue": 10,
      "observedDwell": {
       "samples": 0,
       "maxSeconds": null,
       "minSeconds": null,
       "meanSeconds": null
      },
      "sideImbalance": 0.2,
      "crossSideTransitions": 0,
      "crossZoneDeduplicated": 0
     },
     "signals": [],
     "sources": [
      {
       "mode": "datalastic",
       "provider": "Datalastic",
       "attribution": "Aggregate derived data; no raw AIS, official slots, official queue, or official Canal wait is returned.",
       "retrievedAt": "2026-08-07T23:45:00.000Z"
      }
     ],
     "baseline": {
      "meanQueue": null,
      "queueRatio": null,
      "sampleCount": 0,
      "previousQueue": null,
      "dwellAvailable": false,
      "queuePercentDelta": null
     },
     "reportId": "sha256:e32ed254150a2014910f86feb43733fa54ad573adb3a5a972d57f052a159ab47",
     "observedAt": "2026-08-08T00:00:00.000Z",
     "dataQuality": {
      "score": 100,
      "partial": false,
      "coverage": {
       "zonesComplete": 2,
       "zonesExpected": 2,
       "acceptedSamples": 10
      },
      "sourceOk": true,
      "confidence": "high",
      "limitations": [
       "DWELL_UNAVAILABLE",
       "INSUFFICIENT_HISTORY"
      ],
      "sampleCount": 10,
      "freshnessSeconds": 900
     },
     "nullReasons": {
      "baseline.meanQueue": "insufficient_history",
      "baseline.queueRatio": "insufficient_history",
      "metrics.sideImbalance": null,
      "baseline.previousQueue": "insufficient_history",
      "baseline.queuePercentDelta": "insufficient_history",
      "dataQuality.freshnessSeconds": null,
      "metrics.observedDwell.maxSeconds": "unavailable_dwell",
      "metrics.obs
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/panama-canal-queue-transit-imbalance-monitor-64e6928a/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)