Transportation

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

Changed on

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

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v2/transport/tides
  • Auth: API key in header x-api-key

Query parameters

stationstring nullable

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

Example:8443970
latnumber nullable

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

lonnumber nullable

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

datestring nullable

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

Example:2026-07-12
daysinteger

Window length in days from the start date.

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

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

datumstring

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

units'metric' | 'english'

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",
    "data_age_days": 8.532,
    "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"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes