Environment

Water-level observations

Changed on

Return tide-gauge water-level observations at a CO-OPS station. Default datum is MLLW (Mean Lower-Low Water, the US navigational default) and units metric (meters). Requests without begin_date/end_date default to today's 6-minute observations. Requests with an explicit range are capped at 31 days for 6-minute data and 365 days for hourly (interval=h). q quality flag: p preliminary (last 30-45 days), v verified (older, passed CO-OPS QC). Attribution: NOAA CO-OPS Tides and Currents (api.tidesandcurrents.noaa.gov).

get/api/v1/environment/noaa-tides/station/{id}/water-level

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/environment/noaa-tides/station/{id}/water-level
  • Auth: API key in header x-api-key

Path parameters

idstring required

7-digit CO-OPS station identifier.

Query parameters

begin_datestring nullable

Start date in YYYYMMDD format (e.g. 20260419). Paired with end_date.

end_datestring nullable

End date in YYYYMMDD format. Paired with begin_date.

datestring nullable

Alternative date token. One of latest, today, recent (last 72h). Ignored when both begin_date and end_date are set.

datumstring

Tidal datum: MLLW, MSL, MHW, MHHW, MLW, STND, NAVD88, IGLD (Great Lakes).

unitsstring

Units: metric (meters, Celsius, km/h, mbar) or english.

intervalstring nullable

Sampling interval. Omit (default 6-minute) or pass h for hourly. hilo and 1 are not valid for observations.

Response

Observation time series with timestamps in ISO 8601 UTC.

Example response

{
  "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