{"uid":"cap_PNzemKM0154G5QqXIPOkK","slug":"x402-portdwell-port-chokepoint-congestion-index-5ded6246","name":"x402-portdwell Port/Chokepoint Congestion Index","description":"Port/chokepoint congestion index (daily & live, computed from public AIS)","url":"https://x402-portdwell.nobodytools.com/index","method":"GET","headers":{},"bodySchema":{"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 provenance"}},"description":"result is a point, a list (range/dates), or null when no data (GAP; free, not charged)."}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zkSDPv7m1iObW7I_8ou95","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:39:15.288Z","isFirstParty":false}