# x402-portdwell Port/Chokepoint Congestion Index

> x402-portdwell Port/Chokepoint Congestion Index is a paid API for AI agents from x402-portdwell.nobodytools.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns daily or live port congestion index metrics (waiting vessels, anchor counts, vessel sizes) computed from public AIS data for major shipping ports and chokepoints.

## Facts

- Endpoint: GET https://x402-portdwell.nobodytools.com/index
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-portdwell-port-chokepoint-congestion-index-5ded6246
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PNzemKM0154G5QqXIPOkK

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 x402-portdwell-port-chokepoint-congestion-index-5ded6246
```

Example prompt: What's the latest congestion situation at LALB — how many merchant vessels are currently waiting, how many are at anchor, and what's the data quality look like?

## When to prefer this

Use this endpoint when you need quantitative port congestion metrics derived from AIS vessel positioning data — specifically waiting/anchored vessel counts and size breakdowns at major port/chokepoint sites. Prefer this over general shipping news APIs when you need structured, time-series-compatible numeric data for logistics analytics, supply chain monitoring, or shipping delay forecasting. Choose the 'current' flag for real-time snapshot; 'latest' for most recent completed day; date/range for historical analysis.

## Known failure modes

- No data available for requested date — returns result:null with explanatory note (not charged)
- Data quality is SPARSE or GAP — returned but flagged
- Invalid port site code — error or empty response
- Conflicting selectors provided (e.g. both date and latest) — schema violation
- live/current query on a port without today's rollup yet — may return null
- Payment failure via x402 — 402 response, no data returned
- Future dates or pre-AIS coverage dates — null result

## How this service works

Port/chokepoint congestion index (daily & live, computed from public AIS)

## Output

Returns a JSON object with port code, query type, and a result object (or array for ranges) containing: date/timestamp, count of waiting merchant vessels, at-anchor count, cargo vessel count, tanker count, counts of large vessels (>=150m and >=200m LOA), total vessel length in km, data quality rating (USABLE/SPARSE/GAP), and regime (historical vs live). Returns null result with a note if no data exists for the requested day (that case is free).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "to": {
     "type": "string",
     "format": "date",
     "description": "Range end (inclusive), with 'from'"
    },
    "date": {
     "type": "string",
     "format": "date",
     "description": "One completed day; no data -> free result:null"
    },
    "from": {
     "type": "string",
     "format": "date",
     "description": "Range start (inclusive), with 'to'"
    },
    "port": {
     "type": "string",
     "default": "LALB",
     "description": "Site code (GET /sites)"
    },
    "dates": {
     "type": "string",
     "description": "Comma list of days YYYY-MM-DD,..."
    },
    "latest": {
     "type": "boolean",
     "description": "Most recent completed day with data (PAID 0.01 USDC; default)"
    },
    "current": {
     "type": "boolean",
     "description": "Live 'right now' value from today's rollup (PAID; flat premium 0.05 USDC)"
    }
   },
   "description": "Query params: port + EXACTLY ONE selector (latest | current | date | from&to | dates)."
  },
  "output": {
   "type": "object",
   "properties": {
    "note": {
     "type": "string",
     "description": "present when result is null: why no data (that day is free)"
    },
    "port": {
     "type": "string"
    },
    "query": {
     "type": "string"
    },
    "result": {
     "type": [
      "object",
      "array",
      "null"
     ],
     "properties": {
      "date": {
       "type": "string"
      },
      "as_of": {
       "type": "string",
       "description": "UTC ts for live"
      },
      "cargo": {
       "type": "integer"
      },
      "ge150": {
       "type": "integer",
       "description": ">=150m LOA"
      },
      "ge200": {
       "type": "integer",
       "description": ">=200m LOA"
      },
      "len_km": {
       "type": "number",
       "description": "sum of lengths, km"
      },
      "regime": {
       "type": "string",
       "description": "merchant=historical, live/live-rollup=today"
      },
      "tanker": {
       "type": "integer"
      },
      "waiting": {
       "type": "integer",
       "description": "all waiting merchant vessels, any size"
      },
      "at_anchor": {
       "type": "integer"
      },
      "data_quality": {
       "type": "string",
       "description": "USABLE|SPARSE|GAP"
      }
     }
    },
    "source": {
     "type": "string",
     "description": "data provenan
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "port": "LALB",
  "query": "point",
  "result": {
   "date": "2025-11-15",
   "cargo": 39,
   "ge150": 54,
   "ge200": 38,
   "len_km": 14.63,
   "regime": "merchant",
   "tanker": 19,
   "waiting": 58,
   "at_anchor": 14,
   "data_quality": "USABLE"
  },
  "source": "NOAA/MarineCadastre AIS"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-portdwell-port-chokepoint-congestion-index-5ded6246/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-portdwell.nobodytools.com](https://www.zero.xyz/host/x402-portdwell.nobodytools.com/llms.txt)