Sign in

v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Environment

Water-level observations

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

Path parameters

idstring required

7-digit CO-OPS station identifier.

7-digit CO-OPS station identifier.

Query parameters

begin_datestring nullable

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

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

end_datestring nullable

End date in YYYYMMDD format. Paired with begin_date.

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.

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).

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

unitsstring

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

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.

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",
    "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"
    ]
  }
}