{"uid":"cap_IIucr3pR4uJjAGbeS6cXA","slug":"tbs-weather-climate-api-tide-predictions-sea-level-forecast-be036f2e","name":"TBS Weather & Climate API – Tide Predictions & Sea-Level Forecast","description":"Tide predictions and sea-level forecast for any coastal location: hourly sea-level height (meters) plus derived high and low tide times, next 24 hours by default. From Open-Meteo Marine. For shipping, fishing, surfing, and coastal or port operations that need tide tables.","url":"https://x402.tbs-digital.com/weather/tides?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"lat":{"type":"number","description":"Latitude -90..90 (requires lon)"},"lon":{"type":"number","description":"Longitude -180..180 (requires lat)"},"city":{"type":"string","description":"City name (alternative to lat/lon)"},"hours":{"type":"integer","default":24,"maximum":168,"minimum":1,"description":"Optional forecast horizon in hours, integer 1..168 (default 24)"},"timezone":{"type":"string","description":"Optional IANA timezone"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"payer":{"type":"object","properties":{"address":{"type":"string","nullable":true},"network":{"type":"string"}}},"tides":{"type":"object"},"source":{"type":"string"},"location":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"name":{"type":"string"},"country":{"type":"string"}}},"request_id":{"type":"string"},"generated_at":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"payer":{"address":"0x0000000000000000000000000000000000000000","network":"base"},"tides":{"unit":"m","series":[{"time":"2026-09-30T10:00","sea_level_m":4.97},{"time":"2026-09-30T11:00","sea_level_m":3.73}],"extremes":[{"time":"2026-09-30T16:00","type":"low","sea_level_m":-5.39},{"time":"2026-09-30T22:00","type":"high","sea_level_m":4.75}],"timezone":"Europe/Paris","utc_offset_seconds":7200},"source":"open-meteo","location":{"lat":48.65,"lon":-2.01,"name":"Saint-Malo","country":"FR"},"request_id":"0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55","generated_at":"2026-08-09T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bAAtOLWrW74c3wHF1IX49","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns hourly sea-level height (meters) plus derived high and low tide times for any coastal location, for up to 168 hours ahead.","exampleAgentPrompt":"What are the high and low tide times for the next 48 hours at Miami Beach, Florida? I need hourly sea-level heights too.","exampleUseCases":[{"title":"Fishing trip tide planning","prompt":"I'm going fishing off the coast of Monterey, California tomorrow — can you get me the tide table for the next 24 hours so I know the best windows?"},{"title":"Port operations scheduling","prompt":"We have cargo ships arriving at the Port of Rotterdam over the next 72 hours. Can you pull the hourly sea-level heights and high/low tide times so we can schedule safe docking windows?"},{"title":"Surf session timing","prompt":"I want to surf at Hossegor, France this weekend. Can you give me the tide forecast for the next 48 hours so I can plan around the best low-tide breaks?"}],"resultDescription":"Returns a JSON object with: location metadata (lat, lon, name, country), an array of hourly sea-level height readings in meters, derived high and low tide events with timestamps, the data source (Open-Meteo Marine), a request ID, and a generated_at timestamp. Covers up to 168 hours of tide data.","failureModes":["Missing both lat/lon and city → 400 bad request","Invalid or inland city name with no coastal tide data → empty or error response","Hours parameter out of range (< 1 or > 168) → validation error","Location too far inland (no marine data available) → no tide data returned","Payment failure (insufficient USDC) → 402 payment required"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable tide tables (hourly sea-level heights plus explicit high/low events) for any coastal location worldwide, especially for operational contexts like shipping, fishing, port scheduling, or surfing. Prefer it over generic weather APIs that omit marine/tidal data, and over free tide services that lack programmatic access or per-call pricing at this granularity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:44:57.330Z","isFirstParty":false,"canonicalSlug":"tbs-weather-climate-api-tide-predictions-sea-level-forecast-be036f2e"}