Follow cargo and congestion, port by port.

teleon.dev/docs/maritime joins customs bills of lading with AIS vessel telemetry, and measures congestion at each port from the ships waiting to berth.

v32.0teleon.dev/docs/maritimeShipping feedhttpsjson

Read the docs Copy the agent prompt

Ships waiting at Meridian Port

Ships at anchorDay

Ships waiting90-day median

AIS positions count the ships waiting each day. The queue passed twice its 90-day median on day 10, which raised the congestion alert.

What it does

Who ships what

Customs bills of lading name the shipper, consignee, goods and vessel for each cargo.

Where vessels are

AIS telemetry tracks each vessel's position, course and speed.

Port congestion

Ships waiting at anchor are counted each day and compared with the port's usual range.

The contract

A shipment names the shipper, consignee, goods and vessel, with the customs record, license and read time behind it.

StoreS112, added in v32.0

SourcesCustoms bills of lading, AIS telemetry

SignalPort congestion

RecordsEach record carries its source, license and read time

Identifiers

maritime.shipment
maritime.port_congestion

Execution contracts

Request and responseCopy

GET /v1/maritime/shipments?consignee=ent_4410&after=2026-10-01&limit=2
Host: api.teleon.dev

# Response
{
  "shipments": [
    {"id": "bol_552190", "consignee": "Meridian Holdings Ltd",
     "shipper": "Meridian Components Co", "goods": "circuit boards",
     "containers": 14, "vessel": "Meridian Star", "port": "Meridian Port",
     "arrived": "2026-10-19", "source": "customs bill of lading",
     "license": "terms:customs", "read_at": "2026-10-21T04:44:10Z"},
    {"id": "bol_552377", "consignee": "Meridian Holdings Ltd",
     "shipper": "Meridian Metals Co", "goods": "aluminum sheet",
     "containers": 6, "vessel": "Meridian Dawn", "port": "Meridian Port",
     "arrived": "2026-10-23", "source": "customs bill of lading",
     "license": "terms:customs", "read_at": "2026-10-24T05:02:37Z"}
  ],
  "port": {"name": "Meridian Port", "waiting": 31, "median_90d": 12},
  "next_cursor": "c_b770"
}

Endpoints

Method	Path	Access	What it does
`GET`	`/v1/maritime/shipments`	RING-3	List shipments by consignee, shipper, port or goods
`GET`	`/v1/maritime/shipments/{id}`	RING-3	Read one shipment with its vessel track
`GET`	`/v1/maritime/changes?since={cursor}`	RING-3	Stream new shipments and congestion readings since a cursor
`POST`	`/v1/maritime/watches`	RING-2	Alert when congestion at a port passes a level

Listed paths appear in the service’s published files today. This surface comes from the Teleon Omnibus Codex v1.0 to v50.0, Oct 25, 2026. In the one-host plan every path here is served under api.teleon.dev/v1/maritime.

How it connects

Reads from

Serials and liensteleon.dev/docs/serials Satelliteteleon.dev/docs/satellite Macro and tradeteleon.dev/docs/macro

Feeds into

Supply chainteleon.dev/docs/supplychain Earnings and realityteleon.dev/docs/transcripts Catalyst fusionteleon.dev/docs/catalysts

Queuesaq261-aq350

StoresS112 Bills of Lading, Vessel Telemetry and Port Congestion

For agents

Give your agent the read-only guide first. It reports back before any write.

Agent prompt

Read https://teleon.dev/docs/maritime.md and show congestion at one port with its recent shipments. Read only.

Copy

llms.txt Agent card

Words on this page

Full glossary

Bill of lading: The shipping document for a cargo: it names the shipper, the consignee, the goods and the vessel.
AIS: Automatic Identification System: radio messages that ships broadcast with their identity, position, course and speed.
SPC chart: A statistical process control chart: a running measure with limits that flag unusual change.
Change cursor: A position in a feed's change stream. A reader sends the last cursor it saw and gets every change after it, in order.