Sign in

v5

OpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Transportation

Tide predictions - high/low and water levels (NOAA CO-OPS)

Astronomical tide predictions (high/low extremes, or hourly / 6-minute water levels) for a US NOAA CO-OPS station - by station id, or by the nearest station to a coordinate. Harmonic PREDICTIONS, not measured levels and not real-time; NOT of navigational class. US stations only.

get/api/v2/transport/tides

Query parameters

stationstring nullable

NOAA CO-OPS station id (7 digits), e.g. 8443970 (Boston).

Example:8443970

NOAA CO-OPS station id (7 digits), e.g. 8443970 (Boston).

latnumber nullable

Latitude - resolve the nearest tide-prediction station (with lon).

Latitude - resolve the nearest tide-prediction station (with lon).

lonnumber nullable

Longitude - resolve the nearest tide-prediction station (with lat).

Longitude - resolve the nearest tide-prediction station (with lat).

datestring nullable

Window start, YYYY-MM-DD (GMT); default today.

Example:2026-07-12

Window start, YYYY-MM-DD (GMT); default today.

daysinteger

Window length in days from the start date.

Window length in days from the start date.

interval'hilo' | 'hourly' | '6min'

hilo (high/low extremes) | hourly | 6min (native step).

hilo (high/low extremes) | hourly | 6min (native step).

datumstring

Tidal datum: MLLW | MSL | MHW | MLW | MHHW | MTL | NAVD | STND.

Tidal datum: MLLW | MSL | MHW | MLW | MHHW | MTL | NAVD | STND.

units'metric' | 'english'

metric (metres) | english (feet).

metric (metres) | english (feet).

Response

Successful Response

Example response

{
  "data": {
    "query": {
      "station": "8443970",
      "date": "2026-07-12",
      "days": 2,
      "interval": "hilo",
      "datum": "MLLW",
      "units": "metric"
    },
    "station": {
      "id": "8443970",
      "name": "Boston",
      "state": "MA",
      "lat": 42.3548,
      "lon": -71.0534,
      "distance_km": 3.1
    },
    "interval": "hilo",
    "datum": "MLLW",
    "units": "metric",
    "predictions": [
      {
        "time": "2026-07-12 01:01",
        "value": 3.381,
        "type": "H"
      }
    ]
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}