Port Congestion API

Port congestion, ETA delay and demurrage signals — live line-ups for Brazilian ports, reference seed elsewhere.

Congestion is a fast-moving signal, and Brazilian ports now feed real operational data. Santos (BRSSZ) and Paranaguá (BRPNG) pull live line-ups from APPA Paranaguá, the Porto de Santos operations panel and Lachmann schedules; the remaining ports serve a reference seed. Every response carries data_source (live:appa+santos+lachmann or static_reference_seed) and as_of so you know exactly what you are looking at.

What a port congestion score tells you

Congestion score (0.0–1.0) — normalized risk of operational congestion at the port.
ETA delay (days) — expected delay applied to incoming vessels.
Waiting vessels — ships anchored or queued.
Freight volatility index — pressure indicator for freight pricing.
Daily demurrage exposure (USD) — modeled cost for a vessel queued at the port.

One API call

A single REST request returns the full signal for a port:

HTTP

GET /v1/port-risk?port_id=BRSSZ

Example response

{
  "port_id": "BRSSZ",
  "port_name": "Santos",
  "country": "Brasil",
  "congestion_score": 0.25,
  "eta_delay_days": 0.2,
  "waiting_vessels": 0,
  "freight_volatility_index": 0.4,
  "estimated_daily_demurrage_usd": 42000,
  "updated_at": "2026-09-19 13:17:10",
  "as_of": "2026-09-19 13:17:10",
  "data_source": "live:santos+santos_painel",
  "data_source_label": "Live line-up from Porto de Santos + Painel de operações de Santos.",
  "live_detail": "{\"ao_largo\": 0, \"esperados\": 0, \"atracados\": 593, \"programados\": 135}",
  "validation": {
    "source": "antaq_estatistico_aquaviario",
    "ano": 2026,
    "mes": "jan",
    "n_atracacoes": 500,
    "n_com_imo": 491,
    "espera_atracacao_h_avg": 51.4,
    "espera_atracacao_h_med": 10.2,
    "espera_atracacao_h_p90": 151.1,
    "atracado_h_avg": 50.1,
    "estadia_h_avg": 101.3,
    "validado_em": "2026-09-19 01:49:06"
  },
  "live": {
    "ao_largo": 0,
    "esperados": 0,
    "atracados": 593,
    "programados": 135
  }
}

Try it in under 3 minutes

Install the typed Python SDK and call a port by its UN/LOCODE:

Python

pip install --upgrade aetherx-oracle

from aetherx import OracleClient

client = OracleClient(api_key="YOUR_RAPIDAPI_KEY")
risk = client.get_port_risk("BRSSZ")
print(risk.congestion_score)
print(risk.estimated_daily_demurrage_usd)

Get a free key on the RapidAPI listing (Free Developer Tier, $0.00).

Get a free API key

MCP server for AI agents

The same signal is exposed over the Model Context Protocol, so agents call get_port_risk, get_ports_risk and get_port_trend directly:

Claude Desktop / Cursor / any MCP client

{"mcpServers": {"aetherx-oracle": {"command": "uvx", "args": ["aetherx-mcp"]}}}

Or use the hosted remote endpoint (no install): https://aetherx.aether-grid.io/mcp. Published in the Official MCP Registry as io.github.belegante-byte/aetherx-mcp.