API Marés, Clima & Oceano global

Q: Posso obter previsões de maré em coordenadas exatas (não apenas portos predefinidos)?

Sim. Passe ?lat=&lon= a /api/v1/tides e o TidesAtlas escolhe automaticamente a melhor fonte: se uma estação calibrada estiver a até 50 km, retorna a sua previsão; caso contrário, usa o modelo oceânico global FES2022 nas suas coordenadas exatas. Para uma resposta exclusivamente do modelo (sem fallback para uma estação), use /api/v1/tides/point. Ambos funcionam em qualquer ponto dos oceanos do mundo, sem estação necessária.

Q: Existem SDKs ou bibliotecas para Python, Node.js ou outras linguagens?

Sim. Instale pip install tidesatlas (Python) ou npm install tidesatlas (Node.js). Também publicamos um servidor MCP em tidesatlas.com/mcp para agentes de IA, e a API é REST padrão — utilizável a partir de qualquer linguagem com HTTP. Código-fonte disponível no GitHub sob @TidesAtlas.

Q: A API fornece a temperatura do mar (água)?

Sim. O endpoint /api/v1/marine devolve a temperatura da superfície do mar (água) em °C, hora a hora (sea_surface_temperature_c), juntamente com a altura das ondas, ondulação, ondas de vento e estado do mar. Dados do modelo NOAA WaveWatch III.

Q: Posso obter as alturas de maré para traçar uma curva, não apenas os horários de preia-mar/baixa-mar?

Sim. Chame /api/v1/tides/point com ?heights=1&interval=30 para obter uma série de alturas amostrada ({ datetime, height_m } a cada 5–60 minutos), tudo o que precisa para desenhar uma curva de maré suave. Sem esse parâmetro, obtém apenas os extremos (preia-mar/baixa-mar).

Q: Fornecem previsões de ondas e ondulação?

Sim. O endpoint /api/v1/marine devolve, hora a hora e por dia, a altura das ondas, período e direção, ondulação, ondas de vento, estado do mar (escala de Douglas) e temperatura da superfície do mar — dos modelos oceânicos NOAA GFS-Wave / WaveWatch III (temperatura da água: MUR SST, NASA JPL).

Marés, meteorologia, ondas, ondulação, temperatura da água, sol e lua para 13,441+ estações em 180 países. 13 endpoints REST. Uma única chave API. Baseado em TICON-4, NOAA e modelos FES2022.

Obter chave API50 créditos grátis ao registrar Ver documentaçãoVer doc Preços

Experimente agora

// Fetch today's tides in San Francisco
const res = await fetch(
  'https://tidesatlas.com/api/v1/tides?port=san-francisco&days=3',
  { headers: { 'X-API-Key': 'YOUR_KEY' } }
);
const { extremes } = await res.json();
// [{ datetime: "2026-03-27T05:12:00-07:00", height_m: 1.82, type: "high" }, ...]

13,441+

Estações de maré

180

Países

99.9%

Disponibilidade

<200ms

Tempo de resposta

Roteamento inteligente

Estações calibradas quando próximas, modelo global FES2022 caso contrário. Automático e transparente.

Marés em qualquer ponto do mar

NEW

Previsões em coordenadas exatas, sem estação necessária. Feito para navegação oceânica e pesquisa.

Observações em tempo real

Sensores REFMAR/SHOM ao vivo fundidos com as previsões para portos franceses.

Pronto para produção

Cache agressivo, webhooks, rate limiting, 99,9% de uptime.

Concebido para todos os usos de marés

De aplicações meteorológicas pessoais a plataformas marinhas empresariais.

Navegação marítima

Planeamento de entrada/saída de porto, cálculos de calado e timing de passagem.

Apps de pesca

Janelas de pesca ideais baseadas na fase de maré, altura e corrente.

Surf e desportos aquáticos

Relatórios de surf com dados de maré, planificadores de kayak e guias de atividades de praia.

Imobiliário costeiro

Análise de risco de inundação, dados de propriedades costeiras e avaliações de seguros.

Investigação e ciência

Conjuntos de dados oceanográficos, trabalho de campo em biologia marinha e modelação climática.

Meteorologia e viagens

Integre marés em painéis meteorológicos, planificadores de viagem e dispositivos IoT.

13 endpoints, possibilidades infinitas

Respostas JSON limpas. Sem XML, sem SOAP, sem complicações.

Pack Marés

GET /api/v1/tides Horários e alturas de maré

Retorna os horários de preia-mar e baixa-mar com alturas. Use um slug de estação para uma previsão calibrada de porto, ou passe coordenadas e o TidesAtlas escolhe automaticamente a melhor fonte.

Parâmetro	Tipo	Descrição
`port`	string	Slug da estação, ex. `aberdeen`. Use /ports para pesquisar.
`country`	string	Optional ISO-2 country code to disambiguate a slug shared by several cities (e.g. `port=san-juan&country=PH`). When a slug is ambiguous, the response sets `tide_source.slug_ambiguous: true` and names the country served. Also accepted on `/history` and `/observations`.
`lat` / `lon`	float	Roteamento inteligente: se uma estação calibrada estiver a até 50 km, retorna sua previsão (`data_source: "ticon"`). Caso contrário, usa o modelo oceânico global FES2022 nas suas coordenadas exatas (`data_source: "fes2022"`). Sem redirecionamento silencioso para estações distantes.
`date`	YYYY-MM-DD	Start date (default: today).
`days`	int	1-14 days (default: 1).
`format`	string	Formato de resposta: json, csv ou geojson (padrão: json).

Estações francesas — coeficientes de maré incluídos. As respostas para estações em França incluem um objeto coefficients (manhã/tarde/máx por dia, de 2026-01-01 a 2035-12-29) e um campo coefficient em cada preia-mar (escala francesa, 20 = marés mortas → 120 = marés vivas excecionais). Não aplicável fora de França.

Experimentar

Estado: —

Exemplo de resposta

{
  "port": { "name": "Aberdeen", "slug": "aberdeen", "lat": 57.14, "lon": -2.08, "timezone": "Europe/London" },
  "data_source": "ticon",
  "tide_source": { "type": "own_station", "confidence": "high" },
  "date": "2026-03-27",
  "days": 3,
  "count": 12,
  "extremes": [
    { "datetime": "2026-03-27T04:23:00+00:00", "height_m": 3.82, "type": "high" },
    { "datetime": "2026-03-27T10:41:00+00:00", "height_m": 0.94, "type": "low" },
    ...
  ]
}

The `tide_source` field

Every /api/v1/tides response tells you exactly which station's curve you are receiving, so you can decide how much to trust it:

{
  "tide_source": {
    "type": "reference_port",          // or "own_station"
    "reference_slug": "le-crouesty",
    "reference_name": "Le Crouesty",
    "distance_km": 10.9,
    "corrections_applied": true,
    "confidence": "medium",       // high | medium | low
    "method": "harmonic_transfer_ram"
  }
}

own_station / high — the port has its own tide model. Highest accuracy.
reference_port / medium — a secondary port; the reference curve is transferred with harmonic corrections rebuilt from the Shom Références Altimétriques Maritimes (open data). reference_slug and distance_km tell you the source.
reference_port / low — curve inherited from the reference port without a local correction yet. Use with care.
official_data / high — curve computed from the data of a national agency (South Korea: KHOA harmonic constants; Hong Kong: Hong Kong Observatory predictions; Taiwan: Central Weather Administration official forecasts, checked against its tide gauges). agency, station and attribution are given; credit them.
model_point — no tide gauge here: the FES2022 global model is read at the nearest modelled sea point, model_cell_distance_km away (medium within 4 km, otherwise low).

For a reference_port, place_type tells you why the curve comes from somewhere else: gauge — a real tide gauge a few km away; estuary — the place is on a tidal river or estuary, the tide arrives later than at the reference and its height differs; inland — there is no tide at this place (confidence: none), the curve is that of the nearest coast.

Attribution for corrected French ports: Shom, 2025. Références Altimétriques Maritimes, doi:10.17183/MAREE_COURANTS_RAM (Licence Ouverte 2.0).

Measured accuracy (`tide_source.measured_accuracy`)

For stations that sit next to a public tide gauge, we continuously compare our predictions against actual observations and publish the result. When a recent verification exists (≤ 60 days), the response includes:

{
  "measured_accuracy": {
    "gauge": "uhslc-245",
    "window": "2026-06-16 to 2026-07-31",
    "high_water": { "time_min": 8.6, "height_cm": 4.9 },
    "low_water":  { "time_min": 8.3, "height_cm": 4.5 }
  }
}

Median absolute errors versus gauge observations over the stated window. Informational only — not a warranty, and never a substitute for official navigation documents. Gauge data: University of Hawaii Sea Level Center (Caldwell et al. 2015, doi:10.7289/V5V40S7W) and NOAA CO-OPS.

What this API does not provide

Fine-scale currents in channels and passes — the /currents endpoint provides open-water surface currents at ~8 km resolution; it cannot resolve tidal races, narrow passes or harbour entrances — and says so in every response.
Storm surge / weather-driven water level — predictions are astronomical tide only; meteorological effects are not included.
Navigation-grade certification — always cross-check with official sources before any safety-critical decision.

França: coeficientes de maré (escala francesa)

Para estações em França, a resposta inclui o coeficiente de maré francês — um número adimensional de 20 (marés mortas) a 120 (marés vivas excecionais), comummente utilizado no contexto marítimo francês. O campo aparece em dois locais:

Um campo coefficient em cada preia-mar em extremes (ausente nas baixa-mares).
Um objeto de topo coefficients com valores diários manhã/tarde/máx para o intervalo de datas solicitado.

Cobertura: 2026-01-01 → 2035-12-29. Fonte: computed in-house from Brest harmonic constituents. Geografia: French stations only — the fields are omitted for stations outside France.

Legenda: < 45 = marés mortas, 45-70 = médias, 70-95 = acima da média, 95-110 = marés vivas, > 110 = marés vivas excecionais.

# Get tides + coefficients for Dunkerque, France
GET /api/v1/tides?port=dunkerque&days=3&date=2026-05-14

Exemplo de resposta (campos específicos da França):

{
  "port": { "name": "Dunkerque", "country": "France", ... },
  "data_source": "ticon",
  "extremes": [
    { "datetime": "2026-05-14T05:49:00+02:00", "height_m": 0.81, "type": "low" },
    { "datetime": "2026-05-14T11:49:00+02:00", "height_m": 5.56, "type": "high", "coefficient": 71 },
    { "datetime": "2026-05-14T18:25:00+02:00", "height_m": 0.89, "type": "low" },
    { "datetime": "2026-05-15T00:09:00+02:00", "height_m": 5.61, "type": "high", "coefficient": 77 },
    ...
  ],
  "coefficients": {
    "available": true,
    "source": "Computed from Brest harmonic constituents (French tidal coefficient scale)",
    "scale": "20 (neap) to 120 (extreme spring)",
    "coverage": "2026-01-01 to 2035-12-29",
    "daily": [
      { "date": "2026-05-14", "morning": 71, "afternoon": 77, "max": 77 },
      { "date": "2026-05-15", "morning": 83, "afternoon": 88, "max": 88 },
      ...
    ]
  }
}

GET /api/v1/tides/point Modelo FES2022 explícito em coordenadas exatas NEW

Sempre usa o modelo FES2022 (34 constituintes harmônicos) nas coordenadas exatas que você fornece — nunca recorre a uma estação. Use quando precisar especificamente da saída do modelo (pesquisa, comparações, navegação oceânica). Para a maioria das apps, /api/v1/tides?lat=&lon= é melhor pois escolhe a melhor fonte automaticamente.

Parâmetro	Tipo	Descrição
`lat`	float	Latitude, decimal degrees, -90 to 90. Required.
`lon`	float	Longitude, decimal degrees, -180 to 180. Required.
`date`	YYYY-MM-DD	Start date UTC (default: today).
`days`	int	1-14 days (default: 1).
`datum`	string	Vertical reference: `LAT` (default, like the /tides endpoint) or `MSL`.
`interval`	int	Minutes between samples, 5-60 (default: 10). Sets the spacing of the optional `heights` series and the resolution of extremes detection.
`heights`	bool	Set to `1` to also return an interval-sampled height series — ideal for plotting the tide curve (default: off). Each point is `{ datetime, height_m }`.

How it differs from /api/v1/tides: the /tides endpoint snaps your coordinates to the nearest of 18,000+ predefined stations. /tides/point computes the prediction directly at the exact coordinates you provide, using the FES2022 grid (~7 km resolution). Returns a 404 if the point is on land or outside the ocean mask.

Exemplo de resposta

{
  "query": { "lat": 48.383, "lon": -4.495, "date": "2026-05-13", "days": 1, "datum": "LAT" },
  "model": "FES2022 (34 constituents) via pyfes",
  "datum": "LAT",
  "datum_offset_msl": -3.5268,
  "count": 4,
  "extremes": [
    { "datetime": "2026-05-13T00:20:00+00:00", "height_m": 5.42, "type": "high" },
    { "datetime": "2026-05-13T07:00:00+00:00", "height_m": 1.31, "type": "low" },
    ...
  ],
  "attribution": { "source": "FES2022 by LEGOS/NOVELTIS/CLS, distributed by AVISO+ ..." }
}

# Tides anywhere at sea — example: middle of Atlantic
GET /api/v1/tides/point?lat=35&lon=-30&days=3

# Tide curve for plotting — sampled height every 30 min
GET /api/v1/tides/point?lat=48.38&lon=-4.49&days=1&interval=30&heights=1
# → adds:  "heights_count": 48,
#          "heights": [ { "datetime": "...", "height_m": 3.75 }, ... ]

GET /api/v1/ports Pesquisar estações

Pesquise e liste as estações de maré disponíveis no mundo.

Parâmetro	Tipo	Descrição
`search`	string	Search by name, e.g. `aberdeen`.
`country`	string	Filter by country slug, e.g. `united-kingdom`.
`limit`	int	Max results, 1-500 (default: 50).
`format`	string	Formato de resposta: json, csv ou geojson (padrão: json).

# Find all stations in Japan
GET /api/v1/ports?country=japan&limit=100

# Search by name
GET /api/v1/ports?search=tokyo

GET /api/v1/countries Listar todos os países

Retorna os 188 países com o seu número de estações.

{
  "count": 188,
  "countries": [
    { "name": "United Kingdom", "slug": "united-kingdom", "code_iso": "GB", "station_count": 238 },
    { "name": "United States", "slug": "united-states", "code_iso": "US", "station_count": 156 },
    ...
  ]
}

Pack Clima

GET /api/v1/weather Previsão do tempo

Retorna a previsão meteorológica horária e diária: temperatura, vento, precipitação, índice UV e condições.

Weather API: full page with examples

Data freshness: Forecasts come from our own weather engine (ECMWF AIFS multi-model blend). Each requested point is cached server-side for up to 3 hours, never across UTC days. If the engine is temporarily unavailable, the same day’s cached response is served automatically — check the cached and stale fields. A 502 response means no data is available at all for that location.

Parâmetro	Tipo	Descrição
`port`	string	Station slug, e.g. `brest-3-fra-refmar`
`lat` / `lon`	float	Coordinates (alternative to port).
`days`	int	1-7 days (default: 3).

Exemplo de resposta

{
  "lat": 48.39, "lon": -4.49,
  "timezone": "Europe/Paris",
  "source": "TidesAtlas weather engine — ECMWF-AIFS multi-model blend, bias-corrected & verified",
  "daily": [{
    "date": "2026-03-27",
    "temperature_max_c": 12.3, "temperature_min_c": 7.3,
    "precipitation_mm": 1.5, "wind_max_kmh": 19.2,
    "uv_index_max": 3.35, "condition": "light_drizzle",
    "sunrise": "06:06", "sunset": "18:40"
  }],
  "hourly": [
    { "datetime": "2026-03-27T00:00", "temperature_c": 7.3, "feels_like_c": 4.6, "humidity_pct": 78, "wind_speed_kmh": 4.5, "condition": "overcast", ... },
    ...
  ]
}

Valores possíveis de `condition`

O campo condition retorna sempre um destes valores (associe um ícone a cada um, incluindo unknown):

clearmostly_clearpartly_cloudyovercastfogfreezing_foglight_drizzledrizzleheavy_drizzlefreezing_drizzleheavy_freezing_drizzlelight_rainrainheavy_rainfreezing_rainheavy_freezing_rainlight_snowsnowheavy_snowsnow_grainslight_showersshowersheavy_showerssnow_showersheavy_snow_showersthunderstormthunderstorm_hailheavy_thunderstorm_hailunknown

GET /api/v1/marine Previsão oceânica, ondas e temperatura da água

Marine & sea temperature API: full page with examples

Retorna altura das ondas, ondulação, ondas de vento e estado do mar (modelos NOAA GFS-Wave / WaveWatch III).

Data freshness: Waves come from NOAA GFS-Wave / WaveWatch III, water temperature from MUR SST (NASA JPL). Each requested point is cached server-side for up to 3 hours, never across UTC days. If the engine is temporarily unavailable, the same day’s cached response is served automatically — check the cached and stale fields. A 502 means no data is available; an inland point returns 422.

Parâmetro	Tipo	Descrição
`port`	string	Station slug, e.g. `brest-3-fra-refmar`
`lat` / `lon`	float	Coordinates (alternative to port).
`days`	int	1-7 days (default: 3).

Exemplo de resposta

{
  "lat": 48.39, "lon": -4.49,
  "source": "TidesAtlas weather engine — NOAA GFS-Wave / WaveWatch III",
  "daily": [{
    "date": "2026-03-27",
    "wave_height_max_m": 1.04, "wave_period_max_s": 10.05,
    "wave_direction_dominant": 268,
    "swell_height_max_m": 0.98, "swell_period_max_s": 9.2,
    "sea_state": "smooth"
  }],
  "hourly": [
    { "datetime": "2026-03-27T00:00", "wave_height_m": 1.02, "wave_direction_deg": 275, "swell_height_m": 0.98, "sea_surface_temperature_c": 14.2, ... },
    ...
  ]
}

Each hourly entry also includes sea_surface_temperature_c — the sea-surface (water) temperature in °C, from satellite SST (MUR / GHRSST, ~1 km), accurate near coasts.

Valores possíveis de `sea_state`

O campo sea_state baseia-se na escala de Douglas (a partir da altura das ondas) e retorna sempre um destes valores:

calm_glassycalm_rippledsmoothslightmoderateroughvery_roughhighvery_highunknown

GET /api/v1/astronomy Dados sol e lua

Sun & moon API: full page with examples

Retorna nascer/pôr do sol, amanhecer, crepúsculo, fase lunar, iluminação, nascer/pôr da lua.

Parâmetro	Tipo	Descrição
`port`	string	Station slug, e.g. `brest-3-fra-refmar`
`lat` / `lon`	float	Coordinates (alternative to port).
`date`	YYYY-MM-DD	Start date (default: today).
`days`	int	1-7 days (default: 1).

Exemplo de resposta

{
  "lat": 48.39, "lon": -4.49,
  "data": [{
    "date": "2026-03-27",
    "sun": {
      "sunrise": "06:06", "sunset": "18:41",
      "dawn": "05:35", "dusk": "19:12",
      "day_length": "12:35"
    },
    "moon": {
      "phase": "first_quarter", "illumination_pct": 66.8,
      "age_days": 9,
      "moonrise": "13:45", "moonset": "03:12"
    }
  }]
}

GET /api/v1/conditions Todas as condições (unificado)

Retorna dados meteorológicos, marinhos e astronômicos numa única chamada. Use o parâmetro include para selecionar os dados.

Parâmetro	Tipo	Descrição
`port`	string	Station slug, e.g. `brest-3-fra-refmar`
`lat` / `lon`	float	Coordinates (alternative to port).
`days`	int	1-7 days (default: 3).
`include`	string	Comma-separated: `weather,marine,astronomy` (default: all).

Exemplo de resposta

# All data in one call
GET /api/v1/conditions?port=brest-3-fra-refmar&days=3

# Only weather + astronomy
GET /api/v1/conditions?lat=48.39&lon=-4.49&include=weather,astronomy

# Response contains: weather{}, marine{}, astronomy[]

GET /api/v1/radar Radar de chuva

Retorna URLs de tiles de radar de chuva para mapas animados de precipitação. Dados do RainViewer, atualizados a cada ~10 minutos.

Parâmetro	Tipo	Descrição
`port`	string	Station slug, e.g. `brest-3-fra-refmar`
`lat` / `lon`	float	Coordinates (alternative to port).

Exemplo de resposta

{
  "lat": 48.39, "lon": -4.49,
  "generated": 1774697424,
  "source": "RainViewer (rainviewer.com)",
  "tile_size": 256, "max_zoom": 7, "color_scheme": 1,
  "frames": {
    "past": [
      { "time": "2026-03-28T14:30:00Z", "timestamp": 1774690200,
        "tile_url": "https://tilecache.rainviewer.com/v2/radar/.../256/{z}/{x}/{y}/1/1_1.png" }
    ],
    "nowcast": [
      { "time": "2026-03-28T15:00:00Z", "timestamp": 1774692000,
        "tile_url": "https://tilecache.rainviewer.com/v2/radar/.../256/{z}/{x}/{y}/1/1_1.png" }
    ]
  }
}

Real-time data with ~10 minute delay. Tile URLs are standard slippy map format compatible with Leaflet, Mapbox GL, etc.

GET /api/v1/observations Observações do nível do mar LIVE

Retorna alturas de água observadas em tempo real dos marégrafos REFMAR/SHOM. Disponível para ~100 estações francesas.

Parâmetro	Tipo	Descrição
`port`	string	Station slug (French REFMAR stations only), e.g. `brest`
`date`	YYYY-MM-DD	Start date (default: today).
`days`	int	1-7 days (default: 1).

Exemplo de resposta

{
  "port": { "name": "Brest", "slug": "brest", "country": "France" },
  "station_id": 3,
  "source": "REFMAR/SHOM (Licence Etalab 2.0)",
  "interval_minutes": 10,
  "data": [
    { "date": "2026-03-28", "observations": [
        { "datetime": "2026-03-28T00:00", "height_m": 9.15, "timestamp": 1774684800 },
        ...
    ]}
  ]
}

Only available for French REFMAR stations that have their own tide gauge (~100 stations). A secondary port with no gauge of its own returns 404 — check tide_source.reference_slug in /api/v1/tides for the nearest gauged station. Observations are sub-sampled to 10-minute intervals and aligned with our prediction datum. The /api/v1/tides response exposes has_observations (true only for stations with their own gauge) and, when true, an observations field.

GET /api/v1/currents Surface currents (open water)

Ocean currents API: full page with examples

Hourly total surface currents (ocean circulation + tide + Stokes drift) up to 5 days ahead, anywhere at sea. Speed in knots, direction the current flows towards.

`lat` / `lon`	float	Position at sea (or `port=` a station slug, with optional `country=`).
`days`	int	1–5 (default 3).

{
  "scope": "open_water",   // or "near_shore" — honesty flag
  "hours": [ { "t": "2026-09-17 14:00", "speed_kn": 0.24, "dir_deg": 47 } ],
  "model_point": { "distance_km": 3.1 }
}

The model grid is ~8 km: reliable offshore, indicative only near shore — tidal races, narrow passes and harbour entrances are NOT resolved, and small islands or reefs may be invisible to the model. Every response carries a scope flag and this warning. Not for navigation.

Generated using E.U. Copernicus Marine Service Information — GLOBAL_ANALYSISFORECAST_PHY_001_024, doi:10.48670/moi-00016.

Apenas pack Complete

GET /api/v1/history Dados históricos

Retorna previsões de marés e dados meteorológicos históricos. Marés via motor TICON, meteorologia via reanálise ERA5 (ECMWF/Copernicus).

Parâmetro	Tipo	Descrição
`port`	string	Station slug (required).
`date`	YYYY-MM-DD	Start date in the past (required).
`days`	int	1-365 for tides, 1-90 for weather (default: 7).
`include`	string	Comma-separated: `tides,weather` (default: tides).
`format`	string	Formato de resposta: json, csv ou geojson (padrão: json).

Experimentar

Estado: —

Exemplo de resposta

# Get historical tides and weather for Brest
GET /api/v1/history?port=brest&date=2025-06-01&days=7&include=tides,weather

POST /api/v1/webhooks Webhooks

Crie, gerencie e teste webhooks para alertas em tempo real sobre marés vivas e alertas de tempestade.

Parâmetro	Tipo	Descrição
`action`	string	list, create, update, delete, test
`id`	int	Webhook ID (for update/delete/test).

Eventos suportados

spring_tide — Alerta de maré viva (altura > 4m)
storm_warning — Alerta de tempestade (vento > 60km/h ou ondas > 4m)

Todas as entregas são assinadas com HMAC-SHA256. Verifique o header X-TidesAtlas-Signature.

Os webhooks são desativados após 3 falhas consecutivas.

# Create a webhook
POST /api/v1/webhooks?action=create
{
  "url": "https://example.com/webhook",
  "events": ["spring_tide", "storm_warning"],
  "port_slug": "brest"
}

# Test delivery
POST /api/v1/webhooks?action=test&id=1

Fontes de dados e atribuições

O TidesAtlas constrói a camada de roteamento, cache e integração sobre estes conjuntos de dados científicos abertos. Cada fonte é listada com sua licença.

FES2022

Global finite-element ocean tide model. Used for the /api/v1/tides/point endpoint and for 8,100+ FES2022-derived stations.

Produced by LEGOS, NOVELTIS and CLS. Distributed by AVISO+ with support from CNES. Use requires citation per AVISO+ license. Product page →

TICON

Harmonic constants for 3,000+ tide gauges worldwide. Used for the /api/v1/tides endpoint.

Sourced from the GESLA/PANGAEA database. License: CC BY 4.0 — commercial use permitted. Dataset →

NOAA CO-OPS

Harmonic constants for 1,000+ US tide stations.

Public domain (US government work). NOAA CO-OPS →

REFMAR / SHOM

Live observations from ~100 French tide gauges. Used to enrich /tides responses for French ports. French secondary ports are corrected with the Shom Références Altimétriques Maritimes (RAM).

License: Etalab 2.0 (RAM: Shom, 2025, doi:10.17183/MAREE_COURANTS_RAM). REFMAR →

National agencies

Official tide data from national agencies: South Korea (KHOA harmonic constants and tidal bench marks), Hong Kong (Hong Kong Observatory predictions), Taiwan (Central Weather Administration forecasts, checked against its tide gauges), Canada (Canadian Hydrographic Service predictions) and England (Environment Agency estuary tide gauges). Used for the /api/v1/tides endpoint.

KHOA: Korea Open Government License Type 1 · HKO via DATA.GOV.HK · CWA (Ministry of Transportation and Communications): Open Government Data License v1.0 · CHS (Fisheries and Oceans Canada): Open Government Licence – Canada · Environment Agency: Open Government Licence v3.0.

Copernicus Marine

Tide-gauge records from the Copernicus Marine in-situ network (Global Ocean delayed-mode sea level product), on which TidesAtlas fits its own harmonic constants. Used for the /api/v1/tides endpoint.

Generated using E.U. Copernicus Marine Service Information (doi:10.17882/93670). Product page →

Weather & marine

Powered by our own weather engine: an ECMWF-AIFS multi-model blend (ECMWF AIFS · DWD ICON-EU · NOAA HRRR/GFS), bias-corrected against live observations and continuously verified. Waves & sea state from NOAA WaveWatch III.

Upstream data: ECMWF (CC-BY-4.0), DWD & NOAA (open data / public domain).

Rain radar

Live rain radar tiles via RainViewer.

Attribution required, commercial use permitted. RainViewer →

Cita o TidesAtlas no seu trabalho? Inclua um link para tidesatlas.com e credite a fonte upstream (ex.: «FES2022 via TidesAtlas») quando o modelo de maré for o dado principal.

Início rápido na sua linguagem favorita

Copie, cole e comece a construir em menos de 60 segundos.

cURL

JavaScript

Python

PHP

# Get 3-day tides for San Francisco
curl -H "X-API-Key: YOUR_KEY" \
  "https://tidesatlas.com/api/v1/tides?port=san-francisco&days=3"

const response = await fetch(
  'https://tidesatlas.com/api/v1/tides?port=san-francisco&days=3',
  { headers: { 'X-API-Key': 'YOUR_KEY' } }
);
const { extremes } = await response.json();

extremes.forEach(e =>
  console.log(`${e.type}: ${e.datetime} — ${e.height_m}m`)
);

import requests

response = requests.get(
    'https://tidesatlas.com/api/v1/tides',
    params={'port': 'san-francisco', 'days': 3},
    headers={'X-API-Key': 'YOUR_KEY'}
)

for e in response.json()['extremes']:
    print(f"{e['type']}: {e['datetime']} — {e['height_m']}m")

$ch = curl_init('https://tidesatlas.com/api/v1/tides?port=san-francisco&days=3');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-API-Key: YOUR_KEY']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

foreach ($data['extremes'] as $e) {
    echo "{$e['type']}: {$e['datetime']} — {$e['height_m']}m\n";
}

SDKs oficiais

Comece mais rápido com as nossas bibliotecas cliente oficiais.

JavaScript / Node.js

npm install tidesatlas

const TidesAtlas = require('tidesatlas');
const api = new TidesAtlas('YOUR_KEY');

const data = await api.tides({ port: 'san-francisco', days: 3 });
console.log(data.extremes);

Python

pip install tidesatlas

from tidesatlas import TidesAtlas

api = TidesAtlas("YOUR_KEY")

data = api.tides(port="san-francisco", days=3)
print(data["extremes"])

Servidor MCP para agentes IA

Conecte o TidesAtlas diretamente ao Claude, Cursor ou qualquer assistente IA compatível com MCP.

Endpoint MCP

https://tidesatlas.com/mcp

8 ferramentas disponíveis: tides, ports, countries, weather, marine, astronomy, conditions, history.

Configuração Claude Desktop

{
  "mcpServers": {
    "tidesatlas": {
      "url": "https://tidesatlas.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_KEY"
      }
    }
  }
}

Preços simples e transparentes

Comece grátis. Escale quando precisar. Sem custos ocultos.

Todos os 13 endpoints

Teste

50 créditos únicos

Começar grátis

Free Web

25 pedidos / dia
Uso não comercial, citação da fonte obrigatória

Obter grátis

Hobby

$7.99/mo

500 pedidos / dia

Começar

Mais popular

Starter

$14.99/mo

1,000 pedidos / dia

Começar

Pro

$39/mo

10,000 pedidos / dia

Começar

Business

$99/mo

50,000 pedidos / dia

Contacte-nos

Pagamento seguro via Stripe

Cancele a qualquer momento

Encriptação HTTPS

Conforme com o RGPD

Autenticação e limites de pedidos

Autenticação

Passe a sua chave API via header (recomendado) ou parâmetro de query:

# Header (recommended)
curl -H "X-API-Key: YOUR_KEY" https://tidesatlas.com/api/v1/tides?port=aberdeen

# Query parameter
curl https://tidesatlas.com/api/v1/tides?port=aberdeen&api_key=YOUR_KEY

Headers de limite de pedidos

Cada resposta inclui as suas informações de utilização:

`X-RateLimit-Limit`	O seu limite diário
`X-RateLimit-Remaining`	Pedidos restantes hoje
`X-RateLimit-Reset`	Hora de reset (Unix)

Aplicam-se dois limites — exceder qualquer um retorna 429 Too Many Requests:

Quota do plano	Free 50 no total · Hobby 500/dia · Starter 1.000/dia · Pro 10.000/dia · Business 50.000/dia
Taxa por IP	10 requisições/segundo por IP (picos curtos até 30), máx. 20 conexões simultâneas

Em um 429, aguarde antes de tentar novamente (veja Retry-After / X-RateLimit-Reset). Recomenda-se backoff exponencial.

Changelog

2026-10-18 — /weather, /marine, /conditions: cached responses are now computed for your exact coordinates and never reused across days. Previously a cached response could belong to a nearby point (same 1° cell) or start on the previous day. Responses are also faster. No change to fields or formats.
2026-10-18 — /astronomy: day_length is no longer null when sunset falls after midnight UTC (western longitudes).

Perguntas frequentes

Que tecnologia alimenta as previsões do TidesAtlas?

Desenvolvemos um motor de previsão harmónica proprietário que funde três conjuntos de dados complementares: TICON-4 (3.000+ estações de referência, até 60 constituintes de maré), NOAA (1.075 estações americanas, 37 constituintes) e o modelo oceânico global FES2022 do LEGOS/CNES (8.400+ pontos costeiros, 8 constituintes principais). Cada fonte foi individualmente calibrada, validada cruzadamente e integrada numa pipeline unificada — um trabalho de engenharia considerável que exigiu meses de desenvolvimento. Resultado: 13.400+ estações em 180 países, todas servidas através de uma API única e coerente. Para ~100 estações francesas, fornecemos também observações em tempo real da rede de marégrafos REFMAR/SHOM.

Qual é a precisão das previsões?

O nosso algoritmo realiza análise harmónica utilizando até 60 constituintes de maré por estação, com alinhamento automático de datums e correções nodais. Para estações primárias (TICON-4, NOAA), a precisão é tipicamente de 5-10 minutos e 10-15 cm. Para estações derivadas do modelo (FES2022), é de 10-20 minutos e 15-25 cm. Validamos continuamente os nossos resultados contra observações em tempo real quando disponíveis. As condições meteorológicas (vento, pressão) podem causar desvios adicionais — por isso também fornecemos dados meteorológicos marinhos para dar uma visão completa.

Preciso de um cartão de crédito para começar?

Não. O plano Teste oferece 50 créditos únicos sem cartão de crédito. Só precisa de dados de pagamento ao mudar para um plano pago.

Posso usá-lo para projetos comerciais?

Sim! Todos os planos (incluindo o gratuito) permitem uso comercial. Embora aproveitemos conjuntos de dados abertos, o nosso motor de previsão, infraestrutura API e pipeline de dados são inteiramente desenvolvidos internamente. Basta incluir uma atribuição ao TidesAtlas algures na sua aplicação.

O que acontece se exceder o meu limite diário?

Receberá um código de estado 429. O seu limite reseta à meia-noite UTC. Pode atualizar o seu plano a qualquer momento a partir do painel para obter mais pedidos.

Posso obter previsões de maré em coordenadas exatas (não apenas portos predefinidos)?

Sim. Passe ?lat=&lon= a /api/v1/tides e o TidesAtlas escolhe automaticamente a melhor fonte: se uma estação calibrada estiver a até 50 km, retorna a sua previsão; caso contrário, usa o modelo oceânico global FES2022 nas suas coordenadas exatas. Para uma resposta exclusivamente do modelo (sem fallback para uma estação), use /api/v1/tides/point. Ambos funcionam em qualquer ponto dos oceanos do mundo, sem estação necessária.

Existem SDKs ou bibliotecas para Python, Node.js ou outras linguagens?

Sim. Instale pip install tidesatlas (Python) ou npm install tidesatlas (Node.js). Também publicamos um servidor MCP em tidesatlas.com/mcp para agentes de IA, e a API é REST padrão — utilizável a partir de qualquer linguagem com HTTP. Código-fonte disponível no GitHub sob @TidesAtlas.

A API fornece a temperatura do mar (água)?

Sim. O endpoint /api/v1/marine devolve a temperatura da superfície do mar (água) em °C, hora a hora (sea_surface_temperature_c), juntamente com a altura das ondas, ondulação, ondas de vento e estado do mar. Dados do modelo NOAA WaveWatch III.

Posso obter as alturas de maré para traçar uma curva, não apenas os horários de preia-mar/baixa-mar?

Sim. Chame /api/v1/tides/point com ?heights=1&interval=30 para obter uma série de alturas amostrada ({ datetime, height_m } a cada 5–60 minutos), tudo o que precisa para desenhar uma curva de maré suave. Sem esse parâmetro, obtém apenas os extremos (preia-mar/baixa-mar).

Fornecem previsões de ondas e ondulação?

Sim. O endpoint /api/v1/marine devolve, hora a hora e por dia, a altura das ondas, período e direção, ondulação, ondas de vento, estado do mar (escala de Douglas) e temperatura da superfície do mar — dos modelos oceânicos NOAA GFS-Wave / WaveWatch III (temperatura da água: MUR SST, NASA JPL).

Comece a construir com dados de marés, clima & oceano hoje

Chave API gratuita em 30 segundos. Sem cartão de crédito necessário.

Obter a sua chave API gratuita

API Marés, Clima & Oceano global

Roteamento inteligente

Marés em qualquer ponto do mar

Observações em tempo real

Pronto para produção

Concebido para todos os usos de marés

Navegação marítima

Apps de pesca

Surf e desportos aquáticos

Imobiliário costeiro

Investigação e ciência

Meteorologia e viagens

13 endpoints, possibilidades infinitas

Experimentar

Exemplo de resposta

The tide_source field

Measured accuracy (tide_source.measured_accuracy)

What this API does not provide

França: coeficientes de maré (escala francesa)

Exemplo de resposta (campos específicos da França):

Exemplo de resposta

Exemplo de resposta

Valores possíveis de condition

Exemplo de resposta

Valores possíveis de sea_state

Exemplo de resposta

Exemplo de resposta

Exemplo de resposta

Exemplo de resposta

Experimentar

Exemplo de resposta

Fontes de dados e atribuições

FES2022

TICON

NOAA CO-OPS

REFMAR / SHOM

National agencies

Copernicus Marine

Weather & marine

Rain radar

Início rápido na sua linguagem favorita

SDKs oficiais

Servidor MCP para agentes IA

Endpoint MCP

Configuração Claude Desktop

Preços simples e transparentes

Autenticação e limites de pedidos

Autenticação

Headers de limite de pedidos

Changelog

Perguntas frequentes

Comece a construir com dados de marés, clima & oceano hoje

Crie a sua conta API

The `tide_source` field

Measured accuracy (`tide_source.measured_accuracy`)

Valores possíveis de `condition`

Valores possíveis de `sea_state`