API CanalIQ

Sin API key. Los mismos datos que alimentan el dashboard, en JSON.

• GET/v1/ops

  Cola oficial del Canal según el Daily Customer Report de la ACP: lectura actual por categoría de buque, proyecciones a 24 y 48 horas, y serie histórica de hasta 60 filas diarias.

  {
    "latest": {
      "date": "2026-06-09",
      "queue_total": 60,
      "queue_neopanamax": 22,
      "queue_panamax_plus": 9,
      "queue_super": 14,
      "queue_regular": 15,
      "queue_proj_24h": 58,
      "queue_proj_48h": 55,
      "arrivals_total": 31,
      "transits_total": 34
    },
    "history": [ /* … */ ]
  }

• GET/v1/lake

  Nivel del lago Gatún (y Alhajuela cuando está disponible), últimos 60 días. Cota en pies sobre el nivel del mar.

  {
    "levels": [
      { "date": "2026-06-08", "gatun_ft": 85.17, "alhajuela_ft": 218.43 },
      { "date": "2026-06-07", "gatun_ft": 85.21, "alhajuela_ft": 218.51 }
    ]
  }

• GET/v1/draft

  Calado máximo autorizado vigente en las esclusas neopanamax, extraído del último advisory de calado de la ACP, con fecha de vigencia y enlace al documento de origen. max_draft_ft es null cuando no hay restricción publicada.

  {
    "max_draft_ft": 50.0,
    "advisory_number": "ADV-12-2026",
    "effective_date": "2026-05-28",
    "source_url": "https://pancanal.com/…"
  }

• GET/v1/advisories?limit=25

  Advisories de la ACP estructurados: número, tipo de documento, nivel de impacto y resúmenes propios en español e inglés, con enlace al documento oficial.

  {
    "advisories": [
      {
        "advisory_number": "ADV-29-2025",
        "doc_type": "advisory",
        "impact_level": "high",
        "summary_es": "Reducción temporal de tránsitos en…",
        "summary_en": "Temporary transit reduction at…",
        "source_url": "https://pancanal.com/…"
      }
    ]
  }

• GET/v1/queue · /v1/queue/history · /v1/waits

  Agregados derivados de AIS: snapshots de buques en fondeaderos, historia de la cola observada y tiempos de espera. Muestreo cada 15 minutos — no son posiciones crudas.

• GET/health

  Latido del servicio. Útil para monitoreo.

  { "ok": true }

Charts citables del Canal para tu artículo, blog o dashboard: dos formatos que se actualizan solos.

• SVG/v1/embed/queue.svg · /v1/embed/lake.svg

  Una imagen que se redibuja con cada lectura; ideal para artículos, READMEs y newsletters.

  <img src="https://canaliq-api.luis-hersom.workers.dev/v1/embed/queue.svg?theme=light" width="640" alt="Cola del Canal de Panamá — CanalIQ">

• IFRAME/embed/queue · /embed/lake

  La versión compacta del dashboard, en vivo dentro de tu página.

  <iframe src="https://canaliq.koomodo.app/embed/queue?theme=light" width="640" height="360" frameborder="0"></iframe>

Variantes para el lago Gatún: sustituye queue por lake (/v1/embed/lake.svg y /embed/lake). Parámetros: ?theme=light|dark y ?lang= (13 idiomas).

Embeber es gratis; al citar en artículos: «según datos de CanalIQ».

Vista previa en vivo

# Gratuito — cola oficial del Canal
curl https://canaliq-api.luis-hersom.workers.dev/v1/ops

# Gratuito — advisories estructurados
curl "https://canaliq-api.luis-hersom.workers.dev/v1/advisories?limit=10"

# Gratuito — calado máximo vigente
curl https://canaliq-api.luis-hersom.workers.dev/v1/draft

# Pro — historia completa de la cola (CSV con ?format=csv)
curl -H "Authorization: Bearer ciq_xxxxxxxxxxxx" \
  "https://canaliq-api.luis-hersom.workers.dev/v1/pro/ops?days=3650&format=csv"

# Pro — pronóstico de cola a 7 días
curl -H "Authorization: Bearer ciq_xxxxxxxxxxxx" \
  https://canaliq-api.luis-hersom.workers.dev/v1/pro/forecast

Fair use: los datos provienen de fuentes públicas de la ACP y de muestreo AIS propio; CanalIQ no está afiliado a la Autoridad del Canal de Panamá. Las series se actualizan a ritmo diario o cada 15 minutos según la fuente — cachea las respuestas al menos 15 minutos y enlaza el documento oficial al citar advisories.