Provenance
PublisherNOAA Tides & Currents
Freshness & coverage
FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationNo credentials required
Methods (6)
searchStations
readFind stations by catalog (type), state, bbox, near-point, or name substring.
Input schema
{ "type": "object", "properties": { "type": { "type": "string", "examples": [ "tidepredictions" ], "oneOf": [ { "type": "string", "enum": [ "met" ] }, { "type": "string", "enum": [ "tidepredictions" ] }, { "type": "string", "enum": [ "currentpredictions" ] }, { "type": "string", "enum": [ "historicwl" ] }, { "type": "string", "enum": [ "watertemp" ] }, { "type": "string", "enum": [ "harcon" ] } ] }, "state": { "type": "string", "examples": [ "TX" ] }, "bbox": { "type": "array", "items": { "type": "number" } }, "near": { "type": "object", "properties": { "lat": { "type": "number" }, "lon": { "type": "number" }, "radiusMiles": { "type": "number" } }, "required": [ "lat", "lon", "radiusMiles" ], "additionalProperties": false }, "nameContains": { "type": "string" }, "limit": { "type": "number" } }, "additionalProperties": false }type: tidepredictions/currentpredictions/historicwl/watertemp/met/harcon.
getStation
readSingle station detail. expand: datums | sensors | harcon | products.
Input schema
{ "type": "object", "properties": { "stationId": { "type": "string", "examples": [ "8454000" ] }, "expand": { "type": "array", "items": { "oneOf": [ { "type": "string", "enum": [ "harcon" ] }, { "type": "string", "enum": [ "datums" ] }, { "type": "string", "enum": [ "sensors" ] }, { "type": "string", "enum": [ "products" ] } ] } } }, "additionalProperties": false, "required": [ "stationId" ] }Use expand:["datums"] before requesting an unusual datum to confirm support.
getWaterLevels
readObserved water levels (preliminary real-time or verified historic). 31-day cap.
Input schema
{ "type": "object", "properties": { "productMode": { "oneOf": [ { "type": "string", "enum": [ "preliminary" ] }, { "type": "string", "enum": [ "verified" ] } ] }, "stationId": { "type": "string", "examples": [ "8454000" ] }, "beginDate": { "type": "string", "examples": [ "20260301" ] }, "endDate": { "type": "string", "examples": [ "20260308" ] }, "datum": { "oneOf": [ { "type": "string", "enum": [ "MHHW" ] }, { "type": "string", "enum": [ "MHW" ] }, { "type": "string", "enum": [ "MTL" ] }, { "type": "string", "enum": [ "MSL" ] }, { "type": "string", "enum": [ "MLW" ] }, { "type": "string", "enum": [ "MLLW" ] }, { "type": "string", "enum": [ "NAVD" ] }, { "type": "string", "enum": [ "STND" ] }, { "type": "string", "enum": [ "IGLD" ] } ] }, "units": { "oneOf": [ { "type": "string", "enum": [ "english" ] }, { "type": "string", "enum": [ "metric" ] } ] }, "timeZone": { "oneOf": [ { "type": "string", "enum": [ "gmt" ] }, { "type": "string", "enum": [ "lst" ] }, { "type": "string", "enum": [ "lst_ldt" ] } ] }, "format": { "oneOf": [ { "type": "string", "enum": [ "json" ] }, { "type": "string", "enum": [ "records" ] } ] } }, "additionalProperties": false, "required": [ "stationId", "beginDate", "endDate" ] }datum default MLLW. Pass productMode: verified for QC-passed historic data.
getTidePredictions
readAstronomical tide predictions — hi/lo (default) or 6-min/hourly series.
Input schema
{ "type": "object", "properties": { "interval": { "type": "string", "examples": [ "hilo" ], "oneOf": [ { "type": "string", "enum": [ "1" ] }, { "type": "string", "enum": [ "hilo" ] }, { "type": "string", "enum": [ "h" ] }, { "type": "string", "enum": [ "6" ] }, { "type": "string", "enum": [ "5" ] }, { "type": "string", "enum": [ "10" ] }, { "type": "string", "enum": [ "15" ] }, { "type": "string", "enum": [ "30" ] }, { "type": "string", "enum": [ "60" ] } ] }, "stationId": { "type": "string", "examples": [ "8518750" ] }, "beginDate": { "type": "string", "examples": [ "20260301" ] }, "endDate": { "type": "string", "examples": [ "20260331" ] }, "datum": { "oneOf": [ { "type": "string", "enum": [ "MHHW" ] }, { "type": "string", "enum": [ "MHW" ] }, { "type": "string", "enum": [ "MTL" ] }, { "type": "string", "enum": [ "MSL" ] }, { "type": "string", "enum": [ "MLW" ] }, { "type": "string", "enum": [ "MLLW" ] }, { "type": "string", "enum": [ "NAVD" ] }, { "type": "string", "enum": [ "STND" ] }, { "type": "string", "enum": [ "IGLD" ] } ] }, "units": { "oneOf": [ { "type": "string", "enum": [ "english" ] }, { "type": "string", "enum": [ "metric" ] } ] }, "timeZone": { "oneOf": [ { "type": "string", "enum": [ "gmt" ] }, { "type": "string", "enum": [ "lst" ] }, { "type": "string", "enum": [ "lst_ldt" ] } ] }, "format": { "oneOf": [ { "type": "string", "enum": [ "json" ] }, { "type": "string", "enum": [ "records" ] } ] } }, "additionalProperties": false, "required": [ "stationId", "beginDate", "endDate" ] }interval=hilo or h: 365-day cap. interval=1|5|6|10|15|30|60: 31-day cap.
getMeteorological
readCoastal meteorology — wind, air_temperature, water_temperature, air_pressure.
Input schema
{ "type": "object", "properties": { "stationId": { "type": "string", "examples": [ "8454000" ] }, "product": { "type": "string", "examples": [ "wind" ], "oneOf": [ { "type": "string", "enum": [ "wind" ] }, { "type": "string", "enum": [ "air_pressure" ] }, { "type": "string", "enum": [ "air_temperature" ] }, { "type": "string", "enum": [ "water_temperature" ] } ] }, "beginDate": { "type": "string", "examples": [ "20260408" ] }, "endDate": { "type": "string", "examples": [ "20260508" ] }, "units": { "oneOf": [ { "type": "string", "enum": [ "english" ] }, { "type": "string", "enum": [ "metric" ] } ] }, "timeZone": { "oneOf": [ { "type": "string", "enum": [ "gmt" ] }, { "type": "string", "enum": [ "lst" ] }, { "type": "string", "enum": [ "lst_ldt" ] } ] } }, "additionalProperties": false, "required": [ "stationId", "product", "beginDate", "endDate" ] }31-day request cap on all 4 products. Wind returns value + direction + gust.
getServiceInfo
readLive station counts by catalog, supported products, datum/unit/timezone enums, caps.
Input schema
{ "type": "object", "properties": {}, "additionalProperties": false }