{"uid":"cap_sI4XZmjP2w6q45Q8YWPOt","slug":"karte-halowerk-tide-predictions-cfe5718b","name":"Karte Halowerk Tide Predictions","description":"Returns tide predictions for a NOAA CO-OPS station: every high and low water in the window with its time and height above datum, the range between them, and which extreme comes next with the time remaining. Where the station also measures, the observed water level is fetched and compared with the prediction — wind and air pressure routinely push the real level away from the astronomical forecast, and that residual is the figure that matters for anyone near a limit, so it is returned rather than…","url":"https://karte.halowerk.com/v1/tides","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"days":{"type":"integer","default":2,"maximum":7,"minimum":1,"description":"How many days of predictions."},"datum":{"enum":["MLLW","MSL","MHW","NAVD"],"type":"string","default":"MLLW","description":"Vertical datum heights are given against."},"units":{"enum":["metric","english"],"type":"string","default":"metric","description":"metric = metres, english = feet."},"station":{"type":"string","maxLength":20,"description":"NOAA station id, e.g. 8454000. Either this or a coordinate."},"latitude":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude; the nearest station is used."},"longitude":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude."},"include_observed":{"type":"boolean","default":true,"description":"Also fetch the measured level and compare it with the prediction."},"max_station_distance_km":{"type":"number","default":100,"maximum":500,"minimum":1,"description":"Refuse a coordinate whose nearest station is further away than this."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n6chw-Aup_zRYu0eEAAdS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns NOAA CO-OPS tide predictions (high/low water times and heights) for a station over a time window, plus observed water level and residual deviation from astronomical forecast where available.","exampleAgentPrompt":"What are the high and low tides at NOAA station 8443970 (Boston) from now through this Saturday, and how far is the current observed water level from the astronomical prediction?","exampleUseCases":[{"title":"Sailboat departure planning","prompt":"I'm sailing out of Newport, Rhode Island — can you pull the high and low tides for NOAA station 8452660 from Friday morning through Sunday evening, and tell me when the next high tide is and how much time I have until it?"},{"title":"Coastal flooding risk check","prompt":"There's a storm moving in near Chesapeake Bay — get me the tide predictions for NOAA station 8638610 for the next 24 hours and compare them with the observed water level so I can see how much the wind and pressure are pushing the water above the forecast."},{"title":"Shellfish harvesting window","prompt":"I need to know all the low tides at NOAA station 9414290 in San Francisco Bay this coming week — give me the times and heights so I can find the lowest windows for harvest access."}],"resultDescription":"A list of all high and low water events in the requested window, each with timestamp, height above datum, and tidal range. Includes which extreme event comes next and the time remaining until it. Where the station has live sensors, returns the current observed water level alongside the astronomical prediction and the residual difference (actual minus predicted), which captures meteorological forcing such as wind setup and barometric pressure effects.","failureModes":["Invalid or unknown NOAA station ID — station not found error","Time window too large or outside available data range","NOAA CO-OPS upstream service unavailable — upstream fetch error","Station lacks real-time sensors — observed level and residual not returned","Malformed request body — missing required fields like station ID or time window"],"whenToPreferThis":"Choose this endpoint when you need precise tidal extremes (times and heights of highs and lows) from an official NOAA CO-OPS gauge, especially when the residual between observed and predicted water level matters — for example near navigational depth limits, flood thresholds, or any situation where wind and pressure effects on water level are operationally significant. Prefer this over generic tide APIs when NOAA station-level accuracy and real-time observed level comparison are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:53:56.826Z","isFirstParty":false}